curl
请先获取 API Key 并设置为环境变量。
轮询策略
- 通过创建任务接口提交请求,获取
task_id。 - 每 10 秒轮询一次,直到
task_status为SUCCEEDED或FAILED。 - 任务成功后,
results中包含图片下载 URL。
注意事项
- URL 有效期:图片 URL 在 24 小时后过期,请及时下载。
- 任务状态流转:
PENDING→RUNNING→SUCCEEDED或FAILED。 - 其他状态:
SUSPENDED(任务已暂停)、CANCELED(任务已取消)、UNKNOWN(task_id无效或已过期)。 task_id有效期:task_id有效期为 24 小时,过期后无法查询任务状态和结果。- 避免重复提交:请通过轮询获取结果,不要重复提交请求。
- 部分失败:当
n > 1时,只要有一张图片生成成功,任务状态即为SUCCEEDED。失败的图片会在results中包含错误详情,仅成功的图片计入用量。

