API ドキュメントAPI ドキュメント
ジョブと待機
非同期処理をポーリングし、サニタイズ済みの結果を読む
画像処理は永続的なジョブとして扱われます。最初のレスポンスには、公開ジョブ
オブジェクト一式と 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":
ジョブのレスポンスには、送信されたプロンプト、元画像の参照、内部識別子、実行の 詳細、非公開の診断情報はいっさい含まれません。