Skip to content

视频生成 ​

文生视频、图生视频、首尾帧、参考生视频的调用示例

概述 ​

通过本接口可创建视频生成任务,支持以下模式:

模式路径说明
文生视频/vidu/ent/v2/text2video纯文本描述生成视频
图生视频/vidu/ent/v2/img2video单张图片生成视频
首尾帧/vidu/ent/v2/start-end2video首帧 + 尾帧生成过渡视频
参考生视频/vidu/ent/v2/reference2video参考图 + 文本描述生成视频

[!NOTE]

  • 本平台接口:POST https://aiapi.fhddos.com/vidu/ent/v2/{action}
  • 官方接口:POST https://api.vidu.cn/ent/v2/{action}

可用模型 ​

场景模型
图生viduq3-turbo、viduq3-pro、viduq2-pro-fast、viduq2-pro、viduq2-turbo、viduq1、viduq1-classic、vidu2.0、vidu1.5
首尾帧viduq3-turbo、viduq3-pro、viduq2-pro-fast、viduq2-pro、viduq2-turbo、viduq1、viduq1-classic、vidu2.0
文生viduq3-turbo、viduq3-pro、viduq2、viduq1、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❌回调地址

文生视频 ​

bash
curl -X POST "https://aiapi.fhddos.com/vidu/ent/v2/text2video" \
  -H "Authorization: Bearer <Fhddos Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3-turbo",
    "prompt": "A girl runs toward the camera and winks with a smile.",
    "audio": true,
    "duration": 5,
    "resolution": "720p",
    "style": "general",
    "off_peak": false
  }'

专属参数:

  • prompt(必填):提示词,最长 2000 字符
  • style:风格,general(通用)或 anime(动漫)
  • audio:是否音画同出(仅 q3 系列支持)

图生视频 ​

bash
curl -X POST "https://aiapi.fhddos.com/vidu/ent/v2/img2video" \
  -H "Authorization: Bearer <Fhddos Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3-turbo",
    "images": ["https://your.cdn.com/first.png"],
    "prompt": "The astronaut waved and the camera moved up.",
    "audio": true,
    "duration": 5,
    "resolution": "720p",
    "off_peak": true
  }'

专属参数:

  • images(必填):图片 URL 数组,必须 1 张

首尾帧生成 ​

bash
curl -X POST "https://aiapi.fhddos.com/vidu/ent/v2/start-end2video" \
  -H "Authorization: Bearer <Fhddos 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 张(首帧 + 尾帧)

参考生视频 ​

bash
curl -X POST "https://aiapi.fhddos.com/vidu/ent/v2/reference2video" \
  -H "Authorization: Bearer <Fhddos 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 字符

返回示例 ​

json
{
  "task_id": "176843862716480",
  "platform_id": "video_01JSGXXXXXXXXXXXXXXXXXX",
  "state": "created"
}

INFO

task_id / id 为 Vidu 上游原始任务 ID,可直接用于 Vidu 官方查询接口。platform_id 为 Fhddos 平台统一追踪 ID(video_),可用于平台内查询、取消等操作。查询和取消接口同时接受两种 ID。

创建成功仅代表任务入队,需通过 任务查询 接口获取最终结果。

注意事项 ​

  • 错峰模式:off_peak=true 时价格减半,但生成时间可能延迟
  • 分辨率与时长:q3 系列支持 1–16 秒;Q2 系列支持 1–8 秒;vidu2.0 支持 4s/8s;vidu1.5 不支持首尾帧
  • 异步任务:所有生成都是异步的,请轮询或设置回调获取结果

Fhddos AI 用户文档