异步任务
图像、视频与音乐是异步的。创建端点不会等待成品:它校验请求、预留积分、写入一个持久任务,然后立刻返回 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 端点获取新链接即可。