Skip to main content

​
概述

通过本接口可创建视频生成任务，支持以下模式：
模式路径说明
文生视频/vidu/ent/v2/text2video纯文本描述生成视频
图生视频/vidu/ent/v2/img2video单张图片生成视频
首尾帧/vidu/ent/v2/start-end2video首帧 + 尾帧生成过渡视频
参考生视频/vidu/ent/v2/reference2video参考图 + 文本描述生成视频
[!NOTE]
  • 本平台接口：POST https://models.kapon.cloud/vidu/ent/v2/{action}
  • 官方接口：POST https://api.vidu.cn/ent/v2/{action}

​
可用模型

场景模型
图生/首尾帧viduq2-pro-fast、viduq2-pro、viduq2-turbo、viduq1、viduq1-classic、vidu2.0、vidu1.5
文生/参考生viduq2、viduq1、vidu2.0、vidu1.5

​
通用参数

参数类型必填说明
modelstring✅模型名称
durationint❌视频时长（秒），不同模型取值不同
resolutionstring❌分辨率：540p / 720p / 1080p
movement_amplitudestring❌镜头运动：auto / small / medium / large
off_peakbool❌错峰模式，开启后半价
watermarkbool❌是否添加水印
wm_positionstring❌水印位置
wm_urlstring❌水印图片 URL
callback_urlstring❌回调地址

​
文生视频

curl -X POST "https://models.kapon.cloud/vidu/ent/v2/text2video" \
  -H "Authorization: Bearer <kapon Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq2-turbo",
    "prompt": "A girl runs toward the camera and winks with a smile.",
    "duration": 4,
    "resolution": "720p",
    "style": "general",
    "off_peak": false
  }'
专属参数：
  • prompt（必填）：提示词，最长 2000 字符
  • style：风格，general（通用）或 anime（动漫）

​
图生视频

curl -X POST "https://models.kapon.cloud/vidu/ent/v2/img2video" \
  -H "Authorization: Bearer <kapon Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vidu1.5",
    "images": ["https://your.cdn.com/first.png"],
    "duration": 4,
    "resolution": "720p",
    "off_peak": true
  }'
专属参数：
  • images（必填）：图片 URL 数组，必须 1 张

​
首尾帧生成

curl -X POST "https://models.kapon.cloud/vidu/ent/v2/start-end2video" \
  -H "Authorization: Bearer <kapon Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq2-pro",
    "images": [
      "https://your.cdn.com/start.png",
      "https://your.cdn.com/end.png"
    ],
    "duration": 5,
    "resolution": "1080p"
  }'
专属参数：
  • images（必填）：图片 URL 数组，必须 2 张（首帧 + 尾帧）

​
参考生视频

curl -X POST "https://models.kapon.cloud/vidu/ent/v2/reference2video" \
  -H "Authorization: Bearer <kapon Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq1",
    "images": [
      "https://your.cdn.com/ref-1.jpg",
      "https://your.cdn.com/ref-2.jpg"
    ],
    "prompt": "A mouse runs toward the camera, smiling and blinking.",
    "duration": 5,
    "resolution": "1080p"
  }'
专属参数：
  • images（必填）：参考图 URL 数组，1–7 张
  • prompt（必填）：提示词，最长 2000 字符

​
返回示例

{
  "task_id": "176843862716480",
  "state": "created"
}
创建成功仅代表任务入队，需通过 任务查询 接口获取最终结果。

​
注意事项

  • 错峰模式：off_peak=true 时价格减半，但生成时间可能延迟
  • 分辨率与时长：Q2 系列支持 1–10 秒，老模型（vidu2.0/1.5）限 4s/8s 档
  • 异步任务：所有生成都是异步的，请轮询或设置回调获取结果