API 참조

요청 키로 이미지 작업 복구

GET/v1/image-task-requests/{idempotency_key}

원래 요청 키와 동일한 API 키로 복구하세요. 결과가 불명확하면 먼저 조회하고 다른 요청 키로 다시 제출하지 마세요.

인증과 권한

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

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

경로 매개변수

idempotency_keystring필수
하나의 경로 세그먼트로 인코딩한 원래 이미지 요청 키입니다. 새 키로 바꾸지 마세요.

응답과 오류

HTTP 200

요청 키로 이미지 작업 복구 성공

application/json

유형: object
필수 필드: modelpromptsizenreferencesidstatuscreated_atupdated_atreserved_quotafinal_quotabilling_statusresults

modelstring필수
현재 키의 카탈로그에 있는 공개 모델 ID입니다.
promptstring필수
생성 프롬프트입니다.
sizestring필수
선택한 image-models 항목이 반환한 크기 값이며 기능과 크기는 모델별로 검증합니다.
ninteger필수
요청한 출력 이미지 수이며 선택한 모델의 최댓값을 계속 적용합니다.
referencesarray필수
생성에 사용할 참조 이미지 목록입니다.
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선택 사항
공개 원본 작업 ID이며 출처 표시 전용입니다.
quote_idstring선택 사항
공개 견적 ID이며 생성 시 가격 및 요청 연결 조건을 충족해야 합니다.
idstring필수
해당 상세 경로에 사용하는 이 객체의 공개 식별자입니다.
statusstring필수
unknown은 자동으로 재제출하지 않으며 reserved 요금은 여전히 대기 중일 수 있습니다.

열거형
["queued","dispatching","running","succeeded","partial_succeeded","failed","unknown","deleted"]
created_atinteger필수
Unix 초 단위 생성 시각입니다.
updated_atinteger필수
Unix 초 단위 마지막 갱신 시각입니다.
reserved_quotainteger필수
플랫폼 할당량 단위의 예약량이며 USD 금액이 아닙니다.
final_quotainteger필수
플랫폼 할당량 단위의 최종 과금액이며 null은 아직 확정되지 않았음을 뜻합니다.
billing_statusstring필수
예약/정산/환불 상태입니다. 작업 및 보관 상태와 별도로 확인하세요.
error_codestring선택 사항
분기 로직에 사용할 수 있는 공개 오류 코드입니다.
error_messagestring선택 사항
공개 오류 분류를 거친 사용자용 설명입니다.
resultsarray필수
생성된 출력 항목이며 각 항목의 보관 상태는 독립적입니다.
results 하위 필드(1)
- []object선택 사항
  [] 하위 필드(7)
  - file_idstring선택 사항
    동일 계정/키의 관리형 파일 공개 ID입니다.
  - storage_statusstring선택 사항
    파일 보관 상태이며 관리형 다운로드는 ready 이후에만 보장됩니다.
  - storage_errorstring선택 사항
    파일 보관 실패의 공개 분류입니다.
  - expires_atinteger선택 사항
    Unix 초 단위 만료 시각이며 0은 고정 만료 시각이 없음을 뜻합니다.
  - urlstring선택 사항
    결과 또는 참조의 접근 URL입니다. 서명 URL은 짧은 시간 동안만 유효합니다.
  - b64_jsonstring선택 사항
    이미지 Base64 문자열입니다. URL로 요청하지 마세요.
  - revised_promptstring선택 사항
    서비스이 반환한 수정된 프롬프트가 있는 경우 해당 값입니다.

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선택 사항