API 참조
영구 보관 이미지 견적 받기
/v1/image-quotes입력과 권한만 검증하며 이미지를 잠그지 않습니다. 견적은 60초 동안 유효하며 생성 시 경로/가격/요청을 다시 검증합니다. 서비스 스위치가 비활성화되면 503을 반환합니다.
인증과 권한
현재 GloopAPI 키를 사용하세요. 사용 가능한 모델, 기능과 권한은 해당 카탈로그와 엔드포인트 문서에 따라 달라집니다.
Authorization: Bearer $GLOOP_API_KEY인증 방식: BearerAuth
요청
요청 본문 · application/json
- 유형
- object
- 필수 필드
modelpromptsize- 추가 속성
- false
요청 본문 필수
modelstring필수현재 키의 카탈로그에 있는 공개 모델 ID입니다.
- 최대 길이
191
promptstring필수비어 있지 않아야 하며 최대 32000 UTF-8바이트입니다. OpenAPI maxLength는 문자 수를 세므로 인위적인 문자 제한은 지정하지 않습니다.
sizestring필수선택한 image-models 항목이 반환한 크기 값이며 기능과 크기는 모델별로 검증합니다.
ninteger선택 사항생략하거나 0이면 1로 정규화합니다. 실제 최댓값은 image-models의 max_n입니다. 전역 최댓값을 모델 기능으로 간주하지 마세요.
- 기본값
1- 최솟값
1- 최댓값
6
referencesarray선택 사항항목당 file_id, asset_id, url 중 하나만 선택하세요. 실제 수량은 max_references를 따릅니다.
- 최대 항목 수
14
source_task_idstring선택 사항동일 키 소유의 선택적 원본 작업이며 출처 표시 전용으로 참조를 대체하지 않습니다.
- 최대 길이
64
quote_idstring선택 사항작업 생성 시 유효하고 요청과 일치해야 하며 견적 요청에서는 무시합니다.
응답과 오류
HTTP 200
영구 보관 이미지 견적 조회 성공
application/json
- 유형
- object
- 필수 필드
pricing_noteidexpires_atreserved_quotaestimated_costcurrency
pricing_notestring필수모델 가격 설명이며 최종 정산은 확인된 사용량 측정을 기준으로 합니다.
idstring필수해당 상세 경로에 사용하는 이 객체의 공개 식별자입니다.
expires_atinteger필수Unix 초 단위 만료 시각이며 0은 고정 만료 시각이 없음을 뜻합니다.
reserved_quotainteger필수플랫폼 할당량 단위의 예약량이며 USD 금액이 아닙니다.
estimated_costnumber필수견적 통화 단위의 예상 판매 과금액입니다.
currencystring필수견적/요금 통화입니다.
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선택 사항