模型广场
Vidu 视频

Vidu Q3 API

提供 540p / 720p / 1080p 分辨率,具体接入条件见文档。

  • 图生视频
  • 参考图

Playground

正在加载工作台…

人民币计费

正在读取人民币价格…

接入方式

基础域名 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 示例

GET/v1/videos/tasks/{task_id}
# 将 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.
核对来源 · 2026-11-15

使用场景

  • 商品图动起来

    提供产品图片,描述镜头绕拍或缓慢推进,做出一段外观展示。

  • 角色宣传短片

    以角色立绘为输入,描述转头、眨眼或抬手等单一动作,保留原设定供后期核对。

  • 插画氛围动效

    把静态插画作为素材,让云层、衣角或树影出现细微运动,制作片头或循环背景的候选素材。

  • 空间巡览草稿

    从建筑或室内效果图起步,设计移动方向和视线停留点,先看空间叙事是否顺畅。

  • 组接系列镜头

    为同一主题准备若干图片素材,逐段生成片段,再剪成一组画面节奏一致的镜头。

  • 旧照片动态短片

    以一张照片为画面基础,尝试轻微推进和背景变化,保留原有主体便于并排比较。

相关文章

常见问题

第一次生成,用什么输入最容易跑通?

先准备一张主体清晰的参考图,写清想出现的动作和镜头变化。按本模型的参考图要求提交后,再尝试组合多张素材。

打开本页 Playground
参考图怎么传,视频才能保留角色外观?

普通参考图用于提供角色或场景外观。提示词还要说明主体如何移动、镜头如何拍摄。1–7 张普通参考图,用于保持主体一致性。

查看调用参数
第一次试片,分辨率和时长怎么选?

可先从 540p、3 秒试起,重点看动作和构图。最终导出时再按所选模式确认可用的分辨率、时长和素材组合。

查看调用参数
创建成功了,为什么还没有视频?

创建成功表示任务已接受。用本次返回的 status_url 查询状态,排队或生成时继续等。成功后使用 content_url 下载片段。

查看接入方式
查询任务返回 404,要重新生成吗?

先保留原任务 ID,核对 status_url 和本次生成使用的账号,再看用量明细。查询失败本身不能判断任务结果,重复提交会创建新的任务。

生成中余额已经变少,最终费用怎么看?

视频任务创建时会预占费用。完成后查看任务返回的 cost_rmb 或用量明细。明确失败的任务会退回预占金额。

查看本站计费
为什么换了分辨率、时长或声音设置就报 400?

同一型号的候选规格有时随输入模式改变。先确认横屏或竖屏、是否传了素材,再按调用参数选合法组合。已有报错时优先按错误字段修正。

查看调用参数