Images

API 參考

瀏覽、搜尋和標記相片。支援關鍵字搜尋，以及使用裝置端模型進行 AI 語意搜尋。

型別定義

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
}

操作

query

images

搜尋圖片。查詢留空可列出全部。使用 text:<keyword> 進行 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

計算符合查詢的圖片數量。

bash

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

query

imageSearchStatus

取得目前 AI 語意搜尋的索引狀態。

bash

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

mutation

enableImageSearch

啟用 AI 語意圖片搜尋。如果裝置端模型尚不存在，則會下載。

bash

mutation EnableImageSearch {
  enableImageSearch
}

mutation

disableImageSearch

停用 AI 語意圖片搜尋並釋放資源。

bash

mutation DisableImageSearch {
  disableImageSearch
}

mutation

cancelImageModelDownload

取消進行中的 AI 模型下載。

bash

mutation CancelImageModelDownload {
  cancelImageModelDownload
}

mutation

startImageIndex

開始為 AI 搜尋索引圖片。傳入 force=true 可重新索引全部。

bash

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

mutation

cancelImageIndex

取消正在執行的索引程序。

bash

mutation CancelImageIndex {
  cancelImageIndex
}