任务：文生视频

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

model

enum<string>

模型名称

必需

注意：不支持vidu2.0

枚举值:

vidu1.5vidu1.0

duration

enum<integer>

视频时长

必需

枚举值:

48

resolution

enum<string>

分辨率

必需

vidu1.0 仅可使用360p
vidu1.5 4秒的视频可使用360p、720p、1080p
8秒的视频仅可使用720p

枚举值:

360p720p1080p

默认值:

360p

style

enum<string>

风格

可选

general：通用风格，可以通过提示词来控制风格
anime：动漫风格，仅在动漫风格表现突出，可以通过不同的动漫风格提示词来控制

枚举值:

generalanime

默认值:

general

prompt

string

文本提示词

可选

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

seed

integer

随机种子

可选

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

aspect_ratio

enum<string>

视频比例

可选

枚举值:

16:99:161:1

默认值:

16:9

movement_amplitude

enum<string>

运动幅度

可选

供 vidu1.5 模型可用
高动态性是 vidu 模型的特色之一，为了更好的服务不同的需求，我们开放了控制视频动态幅度的参数

枚举值:

autosmallmediumlarge

默认值:

auto

callback_url

string

Callback 协议

可选

需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致
回调返回的"status"包括以下状态：

processing 任务处理中

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

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

示例

{
  "model": "vidu1.5",
  "style": "general",
  "prompt": "古风美女，刘海，双辫子，国风、完美妆容，淡绿色的民族衣服，苗族服饰，简单的小饰品，完美纯净的皮肤，背景是中国古代建筑，特写镜头，看着镜头，高级感，唯美意境，大师级，HDR，通透的光影，高对比度，超清晰，高品质",
  "duration": 4,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "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/text2video' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "vidu1.5",
  "style": "general",
  "prompt": "古风美女，刘海，双辫子，国风、完美妆容，淡绿色的民族衣服，苗族服饰，简单的小饰品，完美纯净的皮肤，背景是中国古代建筑，特写镜头，看着镜头，高级感，唯美意境，大师级，HDR，通透的光影，高对比度，超清晰，高品质",
  "duration": 4,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "movement_amplitude": "auto"
}'

返回响应

🟢200成功

application/json

Body

task_id

string

必需

state

string

必需

model

string

必需

style

string

必需

prompt

string

必需

duration

integer

必需

seed

integer

必需

aspect_ratio

string

必需

resolution

string

必需

movement_amplitude

string

必需

created_at

string

必需

示例

{
  "task_id": "SPC6X7SLGD0HCJMWFQ3RTLRUNZZV4I1M",
  "state": "created",
  "model": "vidu1.5",
  "style": "general",
  "prompt": "古风美女，刘海，双辫子，国风、完美妆容...",
  "duration": 4,
  "seed": 1234,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "movement_amplitude": "auto",
  "created_at": "2025-01-01T15:41:31.968916Z"
}