任务：首尾帧视频

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

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

model

enum<string>

模型名称

必需

指定用于生成视频的模型名称

枚举值:

vidu2.0vidu1.5

默认值:

vidu2.0

images

array[string <uri>]

图像

必需

支持输入两张图片，上传的第一张图片为视觉首帧图，第二张图片为视觉尾帧图。模型将以此参考中传入的图片来生成视频。

注意事项：

1.

首尾帧两张输入图的分辨率需相近，首帧图的分辨率/尾帧图的分辨率需在0.8~1.25之间，且图图片比例需为1:1或宽高4:1。

2.

支持传入图片 Base64 编码或图片 URL（确保可访问）。

3.

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

4.

图片大小不超过50M。

5.

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

duration

enum<integer>

视频时长

必需

生成视频的时长，单位为秒。

枚举值:

48

resolution

enum<string>

分辨率

必需

生成视频的分辨率。vidu1.5和vidu2.0支持使用360p、720p、1080p，但vidu2.04秒视频仅可使用720p。

枚举值:

360p720p1080p

prompt

string

文本提示词

可选

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

seed

integer

随机种子

可选

用于生成随机效果的种子值。当未传递该值时，会使用随机数替代。

movement_amplitude

enum<string>

运动幅度

可选

用于控制视频动态效果的参数。高动态性使vidu模型的特色之一，为了更好的服务不同需求，我们开放了控制视频动态幅度的参数。

枚举值:

autosmallmediumlarge

默认值:

auto

callback_url

string <uri>

Callback 协议

可选

需要在任务创建后主动设置callback_url。请求方法为POST，当视频生成任务有状态变更时，Vidu将向此地址发送任务最新状态的回调请求。

回调请求内容需与当前任务的API格式一致。

回调返回的status包括以下状态：

processing: 任务处理中

success: 任务完成（如发送失败，回调三次）

failed: 任务失败（如发送失败，回调三次）

示例

{
  "model": "vidu2.0",
  "images": [
    "https://p1-...",
    "https://p2-..."
  ],
  "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/start-end2video' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "vidu2.0",
  "images": [
    "https://p1-...",
    "https://p2-..."
  ],
  "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"
}