Vidu 参考生视频

型号与创建入口核对日期：2026-10-08。来源：apizt 当前模型目录。目录收录不等于你的令牌已开通权限，提交前核对账户模型与价格。

请求参数

图片示例地址是占位地址，提交前替换为可读取的实际素材。

{
  "model": "viduq2-pro",
  "images": [
    "https://example.com/reference.png"
  ],
  "prompt": "保持参考主体一致，让主体在草地上自然行走。",
  "duration": 5
}

请求示例代码

先设置 tokenba_API_KEY；Python 安装 requests，JavaScript 使用 Node.js 20+。示例未进行付费生成实测。

curl --fail-with-body --request POST "https://api.apizt.com/ent/v2/reference2video" \
  --header "Authorization: Bearer $tokenba_API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "model": "viduq2-pro",
  "images": [
    "https://example.com/reference.png"
  ],
  "prompt": "保持参考主体一致，让主体在草地上自然行走。",
  "duration": 5
}'

import os
import requests

headers = {"Authorization": f"Bearer {os.environ['tokenba_API_KEY']}"}
payload = {'model': 'viduq2-pro', 'images': ['https://example.com/reference.png'], 'prompt': '保持参考主体一致，让主体在草地上自然行走。', 'duration': 5}
response = requests.post('https://api.apizt.com/ent/v2/reference2video', headers=headers, json=payload, timeout=60)
response.raise_for_status()
print(response.json())

(async () => {
  const headers = { Authorization: `Bearer ${process.env.tokenba_API_KEY}`, "Content-Type": "application/json" };
  const response = await fetch("https://api.apizt.com/ent/v2/reference2video", { method: "POST", headers, body: JSON.stringify({"model": "viduq2-pro", "images": ["https://example.com/reference.png"], "prompt": "保持参考主体一致，让主体在草地上自然行走。", "duration": 5}) });
  if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  console.log(await response.json());
})().catch(console.error);

创建与查询

1. 提交一次 POST，保存原生响应中的 task_id。
2. 通过原生任务详情接口查询 state。
3. success 后读取 creations[].url 并及时下载；failed 时保留任务 ID 和错误码。

任务结构参考：Vidu 官方对应模式文档。旧的 base_resp 响应模板不用于 /ent/v2 原生任务。