模式流程
步骤 1:提交任务
发送POST 请求创建生成任务:
taskId,实际生成在后台进行。
步骤 2:获取结果
你有两种方式接收结果:方式 A:轮询(适合入门)
定期检查任务状态:方式 B:Webhooks(适合生产环境)
提交时提供callback_url:
POST 请求推送结果。
详见 Webhooks 实现说明。
任务状态
| State | Description |
|---|---|
pending | 任务排队中,等待开始 |
processing | 任务正在处理 |
success | 任务成功完成 |
failed | 任务失败(查看 failMsg) |
轮询最佳实践
- 多数任务建议 3–5 秒 轮询一次
- 长任务(如视频) 使用指数退避
- 设置最大超时时间(例如 5 分钟)
- 妥善处理失败,并加入重试逻辑
如何选择
| Approach | Best For |
|---|---|
| Polling | 简单集成、客户端应用、测试 |
| Webhooks | 生产服务器、实时应用、高并发场景 |