生成文生视频

POST

/openapi/v2/video/text/generate

通过prompt 进行文生视频的生成.

请求参数

Header 参数

API-KEY

string

必需

示例值:

sk-xxxx

Ai-trace-id

string

必需

示例值:

asdfasdf-13423-1234ysdh

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

aspect_ratio

string

必需

"16:9","9.16","4:3","3:4","1:1" 画幅比

duration

integer

必需

5,8 视频生成时间

model

string

必需

模型 "v3.5","v4","v4.5"

motion_mode

string

可选

"normal","fast". "fast" 不支持 8s

negative_prompt

string

可选

2048 Characters 以内

prompt

string

必需

2048 Characters 以内

quality

string

必需

"360p","540p","720p","1080p"

seed

integer

可选

可传随机数 0 - 2147483647

template_id

integer

可选

模版(特效)ID , 使用之前需要激活

water_mark

boolean

可选

示例

{
    "aspect_ratio": "16:9",
    "duration": 5,
    "model": "v3.5",
    "motion_mode": "normal",
    "negative_prompt": "string",
    "prompt": "string",
    "quality": "540p",
    "seed": 0,
    "template_id": 302325299692608,
    "water_mark": false
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://app-api.pixverseai.cn/openapi/v2/video/text/generate' \
--header 'API-KEY: sk-xxxx' \
--header 'Ai-trace-id: asdfasdf-13423-1234ysdh' \
--header 'Content-Type: application/json' \
--data-raw '{
    "aspect_ratio": "16:9",
    "duration": 5,
    "model": "v3.5",
    "motion_mode": "normal",
    "negative_prompt": "string",
    "prompt": "string",
    "quality": "540p",
    "seed": 0,
    "template_id": 302325299692608,
    "water_mark": false
}'

返回响应

🟢200成功

application/json

Body

ErrCode

integer

报错代码

必需

ErrMsg

string

报错信息

必需

Resp

object

必需

video_id

integer

请求成功的视频id

必需

示例


{
  "ErrCode": 0,
  "ErrMsg": "string",
  "Resp": {
    "video_id": 0
  }
}

修改于 2025-05-27 05:48:03

上传图片

生成图生视频