视频生成总览

​

简介

1. 提交任务：发送生成请求，拿到任务 ID（形如 task_xxxx 或 video_xxxx）；
2. 轮询状态：用任务 ID 查询任务状态，直到 succeeded（或 failed）；
3. 获取内容：从查询响应中取视频 URL，或通过内容代理接口拉取视频数据。

​

支持的能力

模型是否可用取决于渠道配置与上游账号开通情况，模型列表请以实际 /v1/models 返回为准。

​

选择入口

​

异步任务流程

1. 提交任务 -> 返回 task_id
2. 轮询状态 -> queued -> (processing / in_progress) -> succeeded / failed
3. 成功 -> 通过查询结果中的 video_url 或 /v1/videos/{task_id}/content 获取视频

• 提交接口返回 HTTP 200 只代表任务已被接受，不代表视频已经生成好；
• 必须轮询查询接口，以 status 为准判断任务结果；
• 成功前响应里通常没有视频地址，轮询到 succeeded 后再取内容。

​

状态枚举对照

​

耗时与轮询建议

• 提交后建议 510 秒轮询一次，视频输入、首尾帧、长时长等复杂任务可放宽到 1020 秒；
• 客户端设置总等待超时（约 15 分钟）；超时不代表任务失败，之后仍可用同一个 task_id 继续查询；
• 生成通常需要几十秒到几分钟，由模型、分辨率、时长决定。

​

获取视频内容

1. 查询接口返回 URL：多数渠道（Veo、阿里万相、Seedance 官方等）在查询响应里直接给 url（或 content.video_url），是带签名的临时地址，需尽快下载保存；
2. 内容代理接口：GET /v1/videos/{task_id}/content 统一返回视频文件本体（不依赖上游地址是否过期），适合需要服务端转发或临时签名的场景，详见 视频内容获取。

​

认证

​

常见问题

• 模型提示不支持：确认模型名是否属于当前入口的支持列表，部分上游账号未开通的模型会返回 ModelNotOpen。
• 查询一直排队/处理中：保留 task_id，降低轮询频率稍后再查，长时间不更新可联系服务方并提供任务 ID 与模型。

​

相关页面