异步视频接口：任务状态与可靠性设计

说明视频异步任务的状态、轮询、去重、回调安全和费用核验原则，为后续 API 适配建立清晰验收标准。

作者：德他数据技术团队 · 更新于 2026-09-24

核心解答

异步视频需要独立管理创建、查询、结果保存与结算，HTTP 受理成功不等于生成完成。德他当前未开放视频任务 API；文中的状态与字段仅为应用设计示意，不能作为已实现端点调用。

本篇为完整的协议说明或接入准备指南，不代表所述原生、视频或扩展能力已在德他开放。真实调用以接口开放范围和具体模型的核准状态为准。

生成任务可能超过一次 HTTP 等待时间。可靠的应用应保留任务上下文，允许用户离开页面后继续查看结果，而不是靠反复点击生成保持请求。

| 应用状态 | 含义 | 下一步 |

| --- | --- | --- |

| 未提交 | 本地需求已保存 | 用户确认规格和费用 |

| 已受理 | 服务已接收任务 | 保存服务返回的标识 |

| 处理中 | 尚无最终结果 | 有节奏地查询同一任务 |

| 已完成 | 可取得输出 | 校验并保存资源 |

| 已失败 | 有明确失败结论 | 按结算规则处理 |

| 结果不明 | 网络或响应不足以判定 | 核验原任务，不自动重建 |

以上是应用层状态建议，不是德他已公布的状态枚举。

为同一次用户动作分配业务编号，在界面禁用重复提交并保存创建结果。查询频率应遵从实际服务限制，停止查询与取消远程任务不是一回事；没有服务端幂等承诺时，复用业务编号本身并不能保证不重复计费。

未来若使用回调，应校验服务身份、防重放并保证重复通知处理幂等。下载结果时限制协议、地址范围、文件大小和类型，避免下载器成为访问内网的通道。临时结果应及时转存，不把外部 URL 当作永久存储。

当前无视频创建、查询、取消或回调入口。本篇只提供设计原则，真实接口路径、状态码、回调验签与费用规则必须由后续正式接口说明确定。不得把参考站视频端点改成德他域名后当作可用 API。

不一定，取决于接口语义，异步创建通常只表示受理。

不能仅靠客户端超时判断，应依据核验后的任务结果。

关联文档：德他数据教程。本文按德他实际功能独立编写。