异步处理
1
提交任务
调用
POST /v1/images 或 POST /v1/videos,从 data.task_id 取得任务 ID。2
轮询状态
用对应的
GET .../{task_id} 查询,直到 status 为终态。3
获取结果
成功时读取
data.result.image_url 或 data.result.video_url;失败时查看 data.error_message。响应约定
成功时code 为 20000,业务数据在 data 中。创建与查询接口返回同一套 data 结构。
常见 Code
最佳实践
- 及时转存:结果 URL 保存约 3 天,请尽快下载到自有存储。
- 先查目录:调用前用 模型目录 确认可用
model与单价。 - 按
cost对账:创建/查询响应中的data.cost为实际扣费(积分)。 - 妥善保管密钥:勿写入前端公开仓库。