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

이미지를 검색합니다. 모두 나열하려면 쿼리를 비워 두십시오. AI 시맨틱 검색에는 text:<keyword>를 사용하십시오.

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
}