API 참조

이미지 작업 조회

GET/v1/image-tasks/{task_id}

동일 키와 현재 모델 권한으로 조회하세요.

인증과 권한

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

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

경로 매개변수

task_idstring필수
동일 키로 생성한 작업의 공개 ID입니다.

응답과 오류

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