
Vidu Q3 API
提供 540p / 720p / 1080p 分辨率,具体接入条件见文档。
- 图生视频
- 参考图
viduq3Playground
正在加载工作台…
人民币计费
正在读取人民币价格…
接入方式
API 接入
查看接入文档基础域名 https://api.icodeeasy.cc
- 创建视频任务
POST/v1/videos/generations - 查询视频任务
GET/v1/videos/tasks/{task_id} - 下载视频
GET/v1/videos/tasks/{task_id}/content - 删除视频任务
DELETE/v1/videos/tasks/{task_id}
API 示例
# 将 TASK_ID 设置为提交响应中的 task_id。
curl "https://api.icodeeasy.cc/v1/videos/tasks/$TASK_ID" \
-H "Authorization: Bearer $ICODEEASY_API_KEY"先在本地设置 ICODEEASY_API_KEY。示例中的参考素材链接或任务 ID 请替换为你自己的值。
调用参数
创建参考图视频任务
| 参数 | 类型 | 说明 |
|---|---|---|
model必填 | string | 模型 ID,使用页首可复制的值。 |
prompt必填 | string | 描述镜头、动作和期望生成的画面。 |
content必填 | array | 至少提供一张参考图。先上传素材,再在 content 项中填入返回的 asset_id。 |
resolution可选 | string | 支持 540p / 720p / 1080p。 |
ratio可选 | string | 支持 1:1 / 9:16 / 16:9 / 3:4 / 4:3。 |
duration可选 | integer | 输出时长 3–16 秒。 |
查询视频任务
| 参数 | 类型 | 说明 |
|---|---|---|
task_id必填 | string | 路径参数,使用创建任务后返回的 task_id。 |
下载视频
| 参数 | 类型 | 说明 |
|---|---|---|
task_id必填 | string | 路径参数,使用创建任务后返回的 task_id。 |
删除视频任务
| 参数 | 类型 | 说明 |
|---|---|---|
task_id必填 | string | 路径参数,使用创建任务后返回的 task_id。 |
核心功能
- 图生视频
从图片出发制作运动画面,在提示词里说明主体或镜头如何移动。
需要 1–7 张参考图片和提示词
- 支持
- 普通参考图
用图片约束角色、服装或场景外观,让新片段围绕参考内容生成。
1–7 张普通参考图,用于保持主体一致性
- 支持
- 片段时长
在支持的时长档位内确定镜头长度,为开场、动作和收尾分配时间。
- 画面比例
按横屏、竖屏或方形投放位置选择该型号支持的比例。
- 输出规格
根据预览和交付需要,选用该型号提供的分辨率或画质档位。
- 异步任务查询
保存提交返回的任务 ID,查询排队、生成及完成状态。
- 文生视频
提交时需附上图片素材。
- 不支持
- 首帧
无法用图片指定视频的起始画面。
- 不支持
- 尾帧
无法用图片指定视频的结束画面。
- 不支持
- 视频输入
这里指把 MP4 文件或视频链接作为视频内容直接发送给模型。
- 不支持
模型亮点
多张参考图,540p 到 1080p
从 1–7 张图片与文字说明生成 3–16 秒视频。可先用 540p 检查主体和背景的搭配,再选 720p 或 1080p 输出。
规格与限制
- 输出规格
- 540p / 720p / 1080p
- 画面比例
- 1:1 / 9:16 / 16:9 / 3:4 / 4:3
- 图片数量上限
- 最多 7 张
- 时长
- 3–16 秒
- 输入要求
- Site images ≤10 MB. No audio reference upload. No supplier task IDs.
使用场景
商品图动起来
提供产品图片,描述镜头绕拍或缓慢推进,做出一段外观展示。
角色宣传短片
以角色立绘为输入,描述转头、眨眼或抬手等单一动作,保留原设定供后期核对。
插画氛围动效
把静态插画作为素材,让云层、衣角或树影出现细微运动,制作片头或循环背景的候选素材。
空间巡览草稿
从建筑或室内效果图起步,设计移动方向和视线停留点,先看空间叙事是否顺畅。
组接系列镜头
为同一主题准备若干图片素材,逐段生成片段,再剪成一组画面节奏一致的镜头。
旧照片动态短片
以一张照片为画面基础,尝试轻微推进和背景变化,保留原有主体便于并排比较。
相关文章
常见问题
第一次生成,用什么输入最容易跑通?
先准备一张主体清晰的参考图,写清想出现的动作和镜头变化。按本模型的参考图要求提交后,再尝试组合多张素材。
打开本页 Playground参考图怎么传,视频才能保留角色外观?
普通参考图用于提供角色或场景外观。提示词还要说明主体如何移动、镜头如何拍摄。1–7 张普通参考图,用于保持主体一致性。
查看调用参数第一次试片,分辨率和时长怎么选?
可先从 540p、3 秒试起,重点看动作和构图。最终导出时再按所选模式确认可用的分辨率、时长和素材组合。
查看调用参数创建成功了,为什么还没有视频?
创建成功表示任务已接受。用本次返回的 status_url 查询状态,排队或生成时继续等。成功后使用 content_url 下载片段。
查看接入方式查询任务返回 404,要重新生成吗?
先保留原任务 ID,核对 status_url 和本次生成使用的账号,再看用量明细。查询失败本身不能判断任务结果,重复提交会创建新的任务。
生成中余额已经变少,最终费用怎么看?
视频任务创建时会预占费用。完成后查看任务返回的 cost_rmb 或用量明细。明确失败的任务会退回预占金额。
查看本站计费为什么换了分辨率、时长或声音设置就报 400?
同一型号的候选规格有时随输入模式改变。先确认横屏或竖屏、是否传了素材,再按调用参数选合法组合。已有报错时优先按错误字段修正。
查看调用参数


