任务：参考生视频

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

用于生成视频的API请求参数

model

enum<string>

模型名称

必需

可选值为 vidu2.0、vidu1.5、vidu1.0

枚举值:

vidu2.0vidu1.5vidu1.0

默认值:

vidu2.0

images

array[string]

图像参数

必需

支持输入 1-3 张图片（vidu1.0 仅支持输入1张图片，vidu1.5 和 vidu2.0 支持输入1-3张图片），模型会以参数中的任意图片的主题风格生成具有主题一致的视频。

注意：

1.

支持传入图片 Base64 编码或图片 URL（需带可访问权限）。

2.

图片支持 png、jpeg、jpg、webp格式。

3.

图片分辨率建议不低于 128×128，因此传入图片宽度与高度乘积建议不小于 41。

4.

图片大小不能超过50M。

5.

vidu1.0 模型下，仅支持传入一张图片。

6.

请注意，base64 decode之后的字节长度需要小于50M，且编码必须包含适当的内容类型字符串，例如：data:image/png;base64,{base64_encode}。

prompt

string

文本提示词

必需

生成视频的文本描述，长度不能超过1500个字符。

duration

enum<integer>

视频时长

必需

视频时长，vidu2.0 可选值：4。默认值：4。

枚举值:

4

resolution

enum<string>

分辨率

必需

可选值：360p。vidu1.5 和 vidu2.0 可选值：360p、720p、1080p。4秒的视频可使用 [360p, 720p]。

枚举值:

360p720p1080p

默认值:

360p

seed

integer

随机种子

可选

当默认不传或值传0时，会使用随机数替代。手动设置则可使用固定的种子。

默认值:

0

aspect_ratio

enum<string>

比例

可选

可选值：16:9。vidu1.5 和 vidu2.0 可选值：16:9、9:16。

枚举值:

16:99:16

默认值:

16:9

movement_amplitude

enum<string>

运动幅度

可选

vidu1.5 和 vidu2.0 模型可用。
可选值：auto、small、medium、large。
高运动幅度视频视觉体验更丰富，为了更好的兼容不同需求，我们开放了控制视频运动幅度的参数。

枚举值:

autosmallmediumlarge

默认值:

auto

callback_url

string <uri>

Callback协议

可选

需要您在创建任务时主动设置 callback_url，请求方法为 POST。当视频生成结束后，Vidu 将把处理结果以对应的状态码返回至 callback_url。

请求内容结构的参数与任务创建时的 API 请求体一致。

状态码说明：

processing: 任务处理中

success: 任务完成（如发送失败，可重试三次）

failed: 任务失败（如发送失败，可重试三次）

示例

{
  "model": "vidu2.0",
  "images": [
    "https://p1-kling.klingai.com/bs2/upload-ylab-stunt/59c557811fa2f2c8852d028bc1123eb4.png"
  ],
  "prompt": "女孩款款向镜头走来，脸上带着开心的笑容，花草在微风中轻轻摇曳，镜头缓缓拉开，环绕女孩拍摄",
  "resolution": "720p",
  "duration": 4,
  "movement_amplitude": "auto"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.gpt.ge/task/vidu/reference2video' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "vidu2.0",
  "images": [
    "https://p1-kling.klingai.com/bs2/upload-ylab-stunt/59c557811fa2f2c8852d028bc1123eb4.png"
  ],
  "prompt": "女孩款款向镜头走来，脸上带着开心的笑容，花草在微风中轻轻摇曳，镜头缓缓拉开，环绕女孩拍摄",
  "resolution": "720p",
  "duration": 4,
  "movement_amplitude": "auto"
}'

返回响应

🟢200成功

application/json

Body

task_id

string

必需

type

string

必需

state

string

必需

model

string

必需

style

string

必需

prompt

string

必需

images

array[string]

必需

duration

integer

必需

seed

integer

必需

aspect_ratio

string

必需

resolution

string

必需

movement_amplitude

string

必需

created_at

string

必需

示例

{
    "task_id": "809390691347075072",
    "type": "character2video",
    "state": "created",
    "model": "vidu2.0",
    "style": "general",
    "prompt": "女孩款款向镜头走来，脸上带着开心的笑容，花草在微风中轻轻摇曳，镜头缓缓拉开，环绕女孩拍摄",
    "images": [
        "https://p1-kling.klingai.com/bs2/upload-ylab-stunt/59c557811fa2f2c8852d028bc1123eb4.png"
    ],
    "duration": 4,
    "seed": 305233514,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "movement_amplitude": "auto",
    "created_at": "2025-04-14T15:41:33.695830549Z"
}