Images

Tham chiếu API

Duyệt, tìm kiếm và gắn thẻ ảnh. Hỗ trợ cả tìm kiếm từ khóa và tìm kiếm ngữ nghĩa AI với mô hình trên thiết bị.

Định nghĩa kiểu

bash

type Image {
  id: ID!
  title: String!         # filename
  path: String!
  size: Int!             # bytes
  bucketId: String!      # media store bucket
  createdAt: String!
  updatedAt: String!
  takenAt: String        # EXIF capture time (nullable)
  tags: [Tag!]!
}

type ImageSearchStatus {
  enabled: Boolean!
  indexed: Int!
  total: Int!
  isIndexing: Boolean!
  isDownloading: Boolean!
  downloadProgress: Float!  # 0.0–1.0
}

enum FileSortBy {
  SIZE_ASC SIZE_DESC
  NAME_ASC NAME_DESC
  DATE_ADDED_ASC DATE_ADDED_DESC
  DATE_MODIFIED_ASC DATE_MODIFIED_DESC
}

Thao tác

query

images

Tìm kiếm ảnh. Để query trống để liệt kê tất cả. Sử dụng text:<keyword> cho tìm kiếm ngữ nghĩa AI.

bash

query GetImages($offset: Int!, $limit: Int!, $query: String!, $sortBy: FileSortBy!) {
  images(offset: $offset, limit: $limit, query: $query, sortBy: $sortBy) {
    id title path size bucketId createdAt updatedAt takenAt
    tags { id name }
  }
}

query

imageCount

Đếm ảnh khớp với một query.

bash

query GetImageCount($query: String!) {
  imageCount(query: $query)
}

query

imageSearchStatus

Lấy trạng thái lập chỉ mục tìm kiếm ngữ nghĩa AI hiện tại.

bash

query GetImageSearchStatus {
  imageSearchStatus {
    enabled indexed total isIndexing isDownloading downloadProgress
  }
}

mutation

enableImageSearch

Bật tìm kiếm ảnh ngữ nghĩa AI. Tải xuống mô hình trên thiết bị nếu chưa có.

bash

mutation EnableImageSearch {
  enableImageSearch
}

mutation

disableImageSearch

Tắt tìm kiếm ảnh ngữ nghĩa AI và giải phóng tài nguyên.

bash

mutation DisableImageSearch {
  disableImageSearch
}

mutation

cancelImageModelDownload

Hủy tải xuống mô hình AI đang tiến hành.

bash

mutation CancelImageModelDownload {
  cancelImageModelDownload
}

mutation

startImageIndex

Bắt đầu lập chỉ mục ảnh cho tìm kiếm AI. Truyền force=true để lập chỉ mục lại tất cả.

bash

mutation StartImageIndex($force: Boolean) {
  startImageIndex(force: $force)
}

mutation

cancelImageIndex

Hủy quy trình lập chỉ mục đang chạy.

bash

mutation CancelImageIndex {
  cancelImageIndex
}