Vidu 视频生成

可用模型

调用时在 model 字段填写控制台开放的模型名。当前 Vidu 系列开放以下模型：

接口和能力

Vidu 统一使用任务式接口 POST /v1/video/generations 创建任务，通过 task_type 指定能力。

常用参数

图片 URL 必须能被服务端公网访问，不能使用本机地址、内网地址、需要登录的地址或已过期签名地址。

计费说明

Vidu 常规视频能力按视频秒数结算，并根据能力和清晰度匹配不同计费项。模型广场会横向展示每个分组可用的计费项价格，最终价格以控制台和模型广场展示为准。

文生视频示例

curl "https://youlai.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3-turbo",
    "task_type": "text2video",
    "prompt": "清晨的现代厨房，一杯咖啡被放到木质桌面上，镜头缓慢推进，真实广告片质感",
    "duration": 5,
    "resolution": "540p"
  }'

图生视频示例

curl "https://youlai.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3-pro",
    "task_type": "img2video",
    "prompt": "保持主体和构图一致，让画面中的产品缓慢旋转，背景光线柔和变化",
    "image": "https://example.com/product.jpg",
    "duration": 5,
    "resolution": "720p"
  }'

首尾帧示例

curl "https://youlai.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3-turbo",
    "task_type": "start-end2video",
    "prompt": "从第一张图自然过渡到第二张图，保持主体一致，动作连贯",
    "images": [
      "https://example.com/start.jpg",
      "https://example.com/end.jpg"
    ],
    "duration": 5,
    "resolution": "720p"
  }'

参考生视频示例

curl "https://youlai.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3-turbo",
    "task_type": "reference2video",
    "prompt": "综合参考图中的人物、服装和画面风格，生成一段自然转身的短视频",
    "images": [
      "https://example.com/reference-1.jpg",
      "https://example.com/reference-2.jpg",
      "https://example.com/reference-3.jpg"
    ],
    "duration": 5,
    "resolution": "540p"
  }'

模板能力示例

模板类能力需要使用平台已开放的模板 ID，并传入模板要求的素材字段。是否可用以模型广场价格项和接口返回为准。

curl "https://youlai.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3-turbo",
    "task_type": "template",
    "prompt": "生成一段节日促销视频",
    "metadata": {
      "template_id": "your-template-id"
    }
  }'

查询任务结果

提交成功后会返回平台任务 ID。使用任务查询接口轮询结果，直到任务进入成功或失败状态。

curl "https://youlai.ai/v1/video/generations/TASK_ID" \
  -H "Authorization: Bearer sk-xxxxxxxx"

排障建议