ジョブと待機

画像処理は永続的なジョブとして扱われます。最初のレスポンスには、公開ジョブオブジェクト一式と 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
  }
}

ジョブのレスポンスには、送信されたプロンプト、元画像の参照、内部識別子、実行の詳細、非公開の診断情報はいっさい含まれません。

ジョブを取得する

ステータスの遷移

待機付きリクエスト

成功時の結果

目次