Vidu

先区分 Vidu 原生接口与本站入口

Vidu 提供文生视频、图生视频、参考主体、首尾帧、音效、口型和视频扩展等异步能力。直连 Vidu 使用 Authorization: Token <API_KEY>；本站 /v1/videos 是适配后的统一任务入口并使用本站令牌。原生 /ent/v2/* 路径、参数与本站协议不能混写。

task_id 与状态机

创建成功返回 task_id 和初始 state。用该 ID 查询 creations：created 表示已创建，queueing 表示排队，processing 表示生成中，success 与 failed 是终态。仅在 success 后读取 creations[]；失败时保存 err_code、模型、credits 与脱敏请求。轮询应采用有限退避、总超时和取消。

回调必须验证 HMAC

配置 callback_url 后，服务端不能因为 HTTP 请求能到达就信任内容。官方签名为 Base64(HMAC-SHA256(TokenSecret, signingString))，并通过 X-HMAC-SIGNATURE 等头传递。按文档的原始方法、URI、query、Date 和已签名头顺序构造字符串，常量时间比较签名，并校验 Date 与 x-request-nonce 防重放。回调可能重试，状态写入必须幂等。

结果 URL 只保留 24 小时

任务查询返回的生成 url 与 cover_url 有效期为 24 小时，不是永久素材地址。进入 success 后由服务端立即以流式方式转存到对象存储，校验内容类型和大小，再将自己的 URL 写入业务记录；下载失败要在有效期内有限重试。

成本、队列与安全

不同模型、时长、分辨率、音频与 off-peak 模式消耗不同 credits；过量任务会进入 queueing，不代表失败。提交前校验素材格式、大小、画幅与权限，并使用业务幂等键避免重复计费。对真人、声音、人脸、品牌和版权素材取得授权，保留内容审核与商业使用记录。