生成任务 - API reference

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Authorization

string

可选

默认值:

Body 参数application/json

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

prompt

string

生成视频的提示词

必需

model

enum<string>

模型版本

可选

枚举值:

v4.5v4v3.5

quality

enum<string>

视频质量/分辨率

可选

枚举值:

360p540p720p1080p

duration

enum<number>

视频时长（秒）

可选

枚举值:

58

aspect_ratio

string

视频宽高比

可选

示例值:

16:99:161:14:33:4

motion_mode

enum<string>

视频运动模式

可选

枚举值:

normalperformance

seed

number

可选

随机种子，用于生成可重复的结果

img_url

string

可选

图片地址，支持URL和base64格式

正则匹配:

^(https?://.*|data:image/.*)

frame

array[string]

可选

视频帧图片地址，支持URL和base64格式（必须是2张图）

>= 2 items<= 2 items

extend

enum<number>

可选

扩展时长（0不扩展，1扩展）

枚举值:

01

original_video_id

number

原始视频ID

可选

style

enum<string>

视频风格

可选

枚举值:

cyberpunkanimecomicclay3d_animation

template_id

number

模板ID

可选

asset_id

number

自创建角色ID

可选

camera_movement

string

相机运镜方式

可选

示例值:

zoom_inzoom_outpan_leftpan_righttilt_uptilt_down

fusion

array[string]

可选

多主体图片地址，支持URL和base64格式（最多2张图）

<= 2 items

示例

{
    "prompt": "火气",
    "model": "v4.5",
    "quality": "360p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "motion_mode": "normal",
    "seed": 648043228
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request POST '/pixverse/generate' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "火气",
    "model": "v4.5",
    "quality": "360p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "motion_mode": "normal",
    "seed": 648043228
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{"ErrCode":0,"ErrMsg":"success","Resp":{"video_id":340957563791053,"video_ids":[340957563791053],"success_count":1,"total_count":1}}