模型广场
Vidu 视频

Vidu Q4 Preview API

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

  • 图生视频
  • 参考图
  • 首帧

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 / 2K / 4K。
ratio可选string支持 1:1 / 9:16 / 16:9 / 3:4 / 4:3。首帧模式随图片比例,省略此项。
duration可选integer输出时长 3–16 秒。
generate_audio可选boolean是否生成音频,默认开启。
查询视频任务
参数类型说明
task_id必填string路径参数,使用创建任务后返回的 task_id。
下载视频
参数类型说明
task_id必填string路径参数,使用创建任务后返回的 task_id。
删除视频任务
参数类型说明
task_id必填string路径参数,使用创建任务后返回的 task_id。

核心功能

图生视频

从图片出发制作运动画面,在提示词里说明主体或镜头如何移动。

单张首帧,或 1–15 张普通参考图

支持
首帧

提供起始画面,从确定的主体位置、视角和光线开始生成。

单张首帧不与普通参考图混用

支持
普通参考图

用图片约束角色、服装或场景外观,让新片段围绕参考内容生成。

最多 15 张,参考模式需要提示词

支持
生成音轨

把同步音轨随视频一起交付,可用于试听对白、声音和画面的配合效果。

默认生成音轨,可关闭

支持
片段时长

在支持的时长档位内确定镜头长度,为开场、动作和收尾分配时间。

画面比例

按横屏、竖屏或方形投放位置选择该型号支持的比例。

文生视频

提交时需附上图片素材。

不支持
尾帧

无法用图片指定视频的结束画面。

不支持
视频输入

这里指把 MP4 文件或视频链接作为视频内容直接发送给模型。

不支持

模型亮点

最多 15 张参考图,输出最高 4K

可用多张参考图提供人物、物件和场景素材,也可从一张首帧直接开始生成。输出支持 2K 和 4K,音轨可关闭。

规格与限制

输出规格
540p / 720p / 1080p / 2K / 4K
画面比例
1:1 / 9:16 / 16:9 / 3:4 / 4:3
图片数量上限
最多 15 张
时长
3–16 秒
输入要求
Site images ≤10 MB. No audio reference upload. No supplier task IDs.
核对来源 · 2026-11-15

使用场景

  • 有声分镜预演

    让短片带上音轨,先试听画面和声音的配合,再决定后期录制或剪辑方案。

  • 商品图动起来

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

  • 角色宣传短片

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

  • 插画氛围动效

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

  • 空间巡览草稿

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

  • 组接系列镜头

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

相关文章

常见问题

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

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

打开本页 Playground
图片应该作为首帧还是参考素材?

首帧是视频的起始画面。先裁好图片、确认主体的位置,再描述后续动作。普通参考图用于提供角色或场景外观。提示词还要说明主体如何移动、镜头如何拍摄。最多 15 张,参考模式需要提示词。

查看调用参数
生成的视频会带声音吗?

默认生成音轨,可关闭。准备后期配旁白时,先试听生成音轨,再在剪辑软件里调整或替换。

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

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

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

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

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

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

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

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

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

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

查看调用参数