任务与有限等待

图片操作都以持久化任务运行。首次响应包含完整公开任务对象和 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":

任务响应不会包含提交的提示词、源图片引用、内部标识、执行细节或私有诊断信息。

查询任务

状态生命周期

有限等待

成功结果

目录