작업과 제한 대기

이미지 처리는 유실되지 않는 작업으로 다뤄집니다. 첫 응답에는 완전한 공개 작업 객체와 Location: /api/v1/jobs/{job_id}가 포함됩니다.

작업 조회

curl https://sci-draw.com/api/v1/jobs/job_012345 \
  -H 'Authorization: Bearer sd_YOUR_KEY'

필요한 범위: jobs:read. 작업은 ID와 계정 소유권을 함께 확인해 조회합니다. 존재하지 않는 작업과 다른 계정의 작업은 모두 404 JOB_NOT_FOUND를 반환합니다.

상태 흐름

상태	의미
`queued`	접수되어 실행 대기 중
`processing`	처리 중
`succeeded`	`result.files`를 받을 수 있음
`failed`	`error`에 안정적인 공개 코드와 메시지가 들어 있음
`canceled`	이 작업은 실행되지 않음

종료 상태에서 다시 전이하는 일은 없습니다. 종료되지 않은 작업은 생성 요청이 돌려준 Retry-After 값에 따라 폴링하세요. 현재 권장값은 2초입니다.

제한 대기

생성 계열 엔드포인트는 Prefer: wait=N을 받습니다. N은 1에서 30 사이의 정수입니다. 그 시간 안에 작업이 종료 상태가 되면 200을 반환하고, 기한에 아직 실행 중이면 현재 작업을 202로 반환합니다. 대화형 클라이언트에는 알맞지만, 서버 간 연동에서는 항상 작업 ID를 저장하고 폴링할 수 있게 준비해 두세요.

성공 결과

{
  "success": true,
  "data": {
    "id": "job_012345",
    "object": "image_job",
    "type": "image_generation",
    "status": "succeeded",
    "created_at": "2026-08-07T12:00:00.000Z",
    "completed_at": "2026-08-07T12:00:41.000Z",
    "credits_reserved": 5,
    "credits_consumed": 5,
    "result": {
      "files": [{
        "id": "file_012345",
        "url": "https://sci-draw.com/generated/example.png",
        "format": "png",
        "mime_type": "image/png",
        "width": 2048,
        "height": 1152
      }]
    },
    "error": null
  }
}

어떤 작업 응답에도 제출한 프롬프트, 원본 이미지 참조, 내부 식별자, 실행 상세, 비공개 진단 정보는 들어가지 않습니다.

작업 조회

상태 흐름

제한 대기

성공 결과

목차