Vidu 视频生成

提交 Vidu 视频生成任务（文生、首帧、首尾帧、参考图、参考视频）。

请求地址仍为 POST /v1/video/generations，完成后用 GET /v1/video/generations/{task_id} 查询。

素材只通过 metadata.content 传入。首帧必须写 role=first_frame；不写 role 时按参考图提交。

尾帧只支持 vidu-video-q2-pro 和 vidu-video-q2-turbo。参考视频只支持 vidu-video-q2-pro。宽高比 4:3、3:4 只支持 vidu-video-q2。

各版本能力与字段说明见下方接口文档。

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string

模型 ID。

model	说明
`vidu-video-q2`	文生、首帧、参考图；宽高比另支持 `4:3`、`3:4`
`vidu-video-q2-pro`	文生、首帧、尾帧、参考图、参考视频
`vidu-video-q2-turbo`	文生、首帧、尾帧、参考图
`vidu-video-q3`	文生、首帧、参考图
`vidu-video-q3-pro`	文生、首帧、参考图
`vidu-video-q3-turbo`	文生、首帧、参考图

prompt?string

文本描述提示词。t2v 模式必填；i2v / 参考图模式建议填写以精确描述运动效果。

duration?number

视频时长（秒）。范围 1–10。超出范围时限制到范围内。

resolution?string

分辨率。720P、1080P，默认 720P，使用大写 P。

ratio?string

宽高比。文生和参考生可选 16:9、9:16、1:1。vidu-video-q2 另支持 4:3、3:4。

seed?integer

随机种子，控制生成结果可复现性。全部模型支持。

metadata?

扩展参数。尾帧仅 vidu-video-q2-pro、vidu-video-q2-turbo。参考视频仅 vidu-video-q2-pro。

字段	类型	说明
`content`	array	素材列表。见下方元素字段
`negative_prompt`	string	反向提示词
`enhance_prompt`	string	自动优化提示词，`Enabled` / `Disabled`
`scene_type`	string	`template_effect`，特效模板
`audio_generation`	string	是否生成 AI 音频，`Enabled` / `Disabled`。有值即转发
`enhance_switch`	string	视频超分增强，`Enabled` / `Disabled`
`frame_interpolate`	string	智能插帧，`Enabled` / `Disabled`

`content` 元素结构

字段	类型	说明
`type`	string	`image_url` / `video_url`
`role`	string	见下表
`image_url.url`	string	图片地址
`video_url.url`	string	视频地址

role 取值：

role	适用 type	说明
`first_frame`	image_url	首帧。必须显式填写，省略时按参考图提交
`last_frame`	image_url	尾帧。仅 `vidu-video-q2-pro`、`vidu-video-q2-turbo`，须与首帧同时传入
`reference_image`	image_url	参考图
`reference_video`	video_url	参考视频。仅 `vidu-video-q2-pro`

Response Body

application/json

curl -X POST "https://loading/v1/video/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vidu-video-q2",
    "prompt": "人物转过头微笑，背景轻微虚化",
    "resolution": "1080P",
    "duration": 4,
    "metadata": {
      "frame_interpolate": "Enabled",
      "content": [
        {
          "type": "image_url",
          "role": "first_frame",
          "image_url": {
            "url": "https://example.com/portrait.jpg"
          }
        }
      ]
    }
  }'

curl -X POST "https://loading/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "vidu-video-q2",    "prompt": "人物转过头微笑，背景轻微虚化",    "resolution": "1080P",    "duration": 4,    "metadata": {      "frame_interpolate": "Enabled",      "content": [        {          "type": "image_url",          "role": "first_frame",          "image_url": {            "url": "https://example.com/portrait.jpg"          }        }      ]    }  }'

{
  "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw",
  "status": "queued"
}

{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}

Authorization

Request Body

content 元素结构

Response Body

200application/json

400application/json

`content` 元素结构

application/json

application/json