API 참조

영구 보관 이미지 기능 조회

GET/v1/image-models

카탈로그는 현재 Ark Seedream Pro/Lite와 Qwen을 지원합니다. 병합되지 않은 Venice 영구 보관 작업 공간 수정은 이 기준에 포함되지 않습니다. 동일한 키로 실행 가능한 기능과 기능 스위치를 반환하며 카탈로그는 운영 가용성을 보장하지 않습니다.

인증과 권한

현재 GloopAPI 키를 사용하세요. 사용 가능한 모델, 기능과 권한은 해당 카탈로그와 엔드포인트 문서에 따라 달라집니다.

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

응답과 오류

HTTP 200

영구 보관 이미지 기능 조회 성공

application/json

유형: object
필수 필드: workspace_enabledfile_storage_enableddataupload_enabled

workspace_enabledboolean필수
현재 작업 공간의 새 작업 활성화 여부이며 과거 객체가 삭제되었다는 뜻은 아닙니다.
file_storage_enabledboolean필수
서비스의 관리형 파일 저장 활성화 여부입니다.
dataarray필수
현재 페이지/카탈로그의 데이터 배열입니다.
data 하위 필드(1)
- []object선택 사항
  [] 하위 필드(8)
  - idstring필수
    해당 상세 경로에 사용하는 이 객체의 공개 식별자입니다.
  - namestring필수
    사람이 읽을 수 있는 이름입니다.
  - providerstring필수
    기능 카탈로그에 표시되는 모델 제공자 이름입니다.
  - max_referencesinteger필수
    선택한 모델이 허용하는 최대 참조 이미지 수입니다.
  - max_ninteger필수
    선택한 모델이 허용하는 최대 출력 이미지 수입니다.
  - sizesarray필수
    이 모델이 허용하는 크기 목록입니다.
    
    sizes 하위 필드(1)
    []object선택 사항
    [] 하위 필드(2)
    valuestring필수
    실제로 제출하는 크기 값입니다.
    
    labelstring필수
    크기의 표시 이름입니다.
  - versionstring필수
    계약/기능 또는 도구 버전입니다. 실행에는 카탈로그가 반환한 도구 버전을 사용합니다.
  - outputstring필수
    해당 스키마/기능이 정의하는 도구 출력 JSON 또는 모델 출력 형식입니다.
upload_enabledboolean필수
서비스의 참조 이미지 업로드 활성화 여부입니다.

HTTP 400

요청 필드 또는 매개변수가 유효하지 않습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 401

키가 없거나 유효하지 않거나 만료 또는 폐기되었습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 403

IP, 계정, 모델 또는 도구 권한이 부족합니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 404

객체/기능을 사용할 수 없거나 기능 스위치가 비활성화되었습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 409

멱등성/견적 충돌, 준비되지 않은 객체 또는 여전히 참조 중인 상태입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 429

요청/대기열 속도 제한입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 500

내부 인증 또는 데이터 저장 오류입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 503

서비스, 가격 또는 스토리지를 사용할 수 없습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항