Skip to main content
视频、部分图像和音乐模型采用异步任务模式。创建接口会先返回任务 ID,生成结果随后才可用。
1

创建任务

调用目标模型的生成接口,并保存响应中的任务 ID。不同接口可能使用 idtask_idtaskId 字段。
2

查询任务

使用对应的任务查询接口轮询状态。建议从 2 至 5 秒的间隔开始,并使用指数退避。
3

读取结果

当状态变为成功时,读取响应中的资源 URL。资源链接可能有有效期,请及时下载或转存。

推荐的轮询策略

各模型的状态字段和值并不完全一致。请以创建接口和查询接口的响应定义为准,不要跨模型复用未经适配的判断逻辑。

生产环境建议

  • 为轮询设置最大等待时间,避免任务永久占用工作线程。
  • 4295xx 响应执行带随机抖动的指数退避。
  • 仅重试查询请求。重试创建请求前,先确认接口是否支持幂等。
  • 保存任务 ID、模型名称和创建时间,便于恢复中断的任务。
  • 不要把临时资源 URL 当作永久存储地址。

排查任务问题