异步任务机制
视频任务的提交、轮询、回调与取结果全流程
异步任务机制
视频生成等耗时任务采用异步模式，整体链路：
提交任务 → 返回任务 ID（queued）
→ 平台排队执行（running）
→ 完成（succeeded）或失败（failed）
→ 轮询查询 / 回调通知 获取结果轮询方式
按任务 ID 定时查询（建议间隔不少于 60 秒，过于频繁会被限流）：
curl https://www.iciroute.com/v1/video/generations/task_xxxxxxxx \
-H "Authorization: Bearer sk-你的令牌"succeeded：取结果中的视频地址并及时下载（链接有时效）failed：查看失败原因，预扣额度已自动全额退回
回调方式（推荐）
创建任务时在 metadata 中携带 callback_url，任务完成或失败时平台会向该地址 POST 结果，省去轮询：
{
"model": "dreamina-seedance-2.0-fast",
"content": [{"type": "text", "text": "一只金毛犬在麦田里奔跑"}],
"metadata": {"callback_url": "https://your-server.com/webhook"}
}回调地址必须是公网可访问的 HTTPS 地址，并保证能正常接收 POST JSON。
控制台查看
所有任务也可在控制台「任务」页面查看状态、结果与失败原因。
计费说明
- 提交时预扣额度，预扣不足返回额度不足错误
- 成功：按实际产出结算，差额自动退回
- 失败：预扣全额自动退回
这篇文档对您有帮助吗？