异步任务

图像、视频与音乐是异步的。创建端点不会等待成品:它校验请求、预留积分、写入一个持久任务,然后立刻返回 202 Accepted。之后你轮询任务状态,成功后索取签名下载链接。

生命周期

POST /v1/images/generations ─┐
POST /v1/images/edits        │
POST /v1/videos              ├─► 202 { "id": "job_…", "status": "queued" }
POST /v1/audio/music         ─┘
                             │
        GET /v1/jobs/{job_id} ← 轮询直到终态
                             │
  GET /v1/jobs/{job_id}/assets ← 签名链接,15 分钟有效

聊天补全、语音合成与转写不是任务——它们在响应体里直接返回结果。只有上面三类生成式媒体走异步。

参数缺失的补救

如果请求缺少必需参数,端点会在创建阶段以 400 失败并指出字段,而不是写入一个注定失败的任务。幂等键相同的重复请求仍在准备时返回 425。

FAQ

轮询间隔建议?

从 2 秒起并逐步放宽,避免把额度花在轮询上。

任务失败会扣积分吗?

因我方原因失败会退回;因请求本身不可用则不会。

资产链接过期了?

重新请求 assets 端点获取新链接即可。

继续阅读