Vidu 文生视频

根据文字提示词创建视频生成任务。接口返回 task_id 后，需要调用查询接口获取最终视频。

接口信息

方法	POST
路径	/ent/v2/text2video
完整地址	https://api000.com/ent/v2/text2video

---

请求头

参数	必填	示例
Content-Type	是	application/json
Authorization	是	Bearer sk-xxxxxxxxxxxxxxxx

---

请求示例

{
  "model": "viduq3-pro",
  "prompt": "电影级商业产品广告，黑色头戴式耳机悬浮在深色摄影棚中央，镜头缓慢推进，红色轮廓光扫过耳罩边缘，展示磨砂机身和柔软耳垫，最后拉回完整产品中景并稳定定格。画面中不要出现字幕、文字和水印。",
  "duration": 10,
  "resolution": "1080p",
  "aspect_ratio": "9:16",
  "audio": true,
  "off_peak": false
}

cURL 示例

curl https://api000.com/ent/v2/text2video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "viduq3-pro",
    "prompt": "电影级商业产品广告，镜头缓慢推进展示产品细节，灯光高级，运动平滑。",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16",
    "audio": true,
    "off_peak": false
  }'

---

Body 参数

参数	类型	必填	说明
model	string	是	模型名称，例如 viduq3-pro、viduq3-turbo、viduq2
prompt	string	是	视频提示词，最长不超过 5000 个字符
duration	integer	否	视频时长；Q3 模型通常支持 1–16 秒
resolution	string	否	清晰度：540p、720p、1080p
aspect_ratio	string	否	比例，例如 16:9、9:16、1:1
seed	integer	否	随机种子，用于获得相近生成结果
audio	boolean	否	是否使用原生音视频生成；Q3 模型支持
bgm	boolean	否	是否添加背景音乐；Q3 模型不支持该参数
off_peak	boolean	否	是否使用错峰生成模式
payload	string	否	自定义业务追踪字段
callback_url	string	否	任务状态变化时接收回调的公网地址

使用 Q3 模型并希望生成声音时，请设置 audio: true，同时在提示词中描述对白、环境音或音效。

---

成功响应

{
  "task_id": "911084878697623552",
  "state": "created",
  "model": "viduq3-pro",
  "prompt": "电影级商业产品广告，镜头缓慢推进展示产品细节",
  "duration": 10,
  "aspect_ratio": "9:16",
  "resolution": "1080p",
  "audio": true,
  "off_peak": false,
  "created_at": "2026-01-20T06:37:57Z"
}

拿到 task_id 后，调用 Vidu 查询结果 获取最终视频 URL。