API 참조

영구 보관 이미지 견적 받기

POST/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
    references 하위 필드(1)
    • []object선택 사항
      [] 하위 필드(3)
      • file_idstring선택 사항

        동일 계정/키의 관리형 파일 공개 ID입니다.

      • asset_idstring선택 사항

        동일 계정/키의 업로드 자산 ID입니다.

      • urlstring선택 사항

        공개 HTTPS URL입니다. userinfo와 fragment는 금지되며 SSRF 검사가 적용됩니다.

        형식
        "uri"
      oneOf 분기 1

      이 분기의 필수 항목: file_id

      oneOf 분기 2

      이 분기의 필수 항목: asset_id

      oneOf 분기 3

      이 분기의 필수 항목: url

  • 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

HTTP 401

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

application/json

유형
object
필수 필드
error

HTTP 403

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

application/json

유형
object
필수 필드
error

HTTP 404

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

application/json

유형
object
필수 필드
error

HTTP 409

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

application/json

유형
object
필수 필드
error

HTTP 429

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

application/json

유형
object
필수 필드
error

HTTP 500

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

application/json

유형
object
필수 필드
error

HTTP 503

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

application/json

유형
object
필수 필드
error
개발할 준비가 되셨나요? 열기: 콘솔 API 키를 생성하거나 살펴보기: 기능.