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":
任何任務回應都不會包含送出的提示詞、來源影像參照、內部識別碼、執行細節或非公開的 診斷資訊。