PixVerse 视频生成

提交 PixVerse 视频生成任务（文生、首帧、参考图、多主体参考）。

请求地址仍为 POST /v1/video/generations，完成后用 GET /v1/video/generations/{task_id} 查询。

素材只通过 metadata.content 传入。首帧必须写 role=first_frame；不写 role 时按参考图提交。不支持尾帧和参考视频。

分辨率使用小写：540p、720p、1080p、2k、4k，默认 720p。

pixverse-video-c1 的主体和背景要写 reference_type 与 name，提示词里用 @名字 引用。

各版本能力与字段说明见下方接口文档。

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string

模型 ID。

model	说明
`pixverse-video-v5.6`	文生、首帧、参考图
`pixverse-video-v6`	文生、首帧、参考图
`pixverse-video-c1`	文生、首帧、多主体参考。`reference_type` 取 `subject` / `background`，提示词用 `@名字`

prompt?string

文本描述提示词。t2v 模式必填；i2v / 参考图模式建议填写以精确描述运动效果。

duration?number

视频时长（秒）。范围 1–15，默认 5。超出范围时限制到范围内；不传则使用默认 5 秒。

resolution?string

分辨率，使用小写：540p、720p、1080p、2k、4k，默认 720p。

ratio?string

宽高比。可选 16:9、9:16、1:1、4:3、3:4、2:3、3:2、21:9。

seed?integer

随机种子，控制生成结果可复现性。全部模型支持。

metadata?

扩展参数。不支持尾帧和参考视频。

字段	类型	说明
`content`	array	素材列表。见下方元素字段
`negative_prompt`	string	反向提示词
`audio_generation`	string	是否生成 AI 音频，`Enabled` / `Disabled`。有值即转发

`content` 元素结构

字段	类型	说明
`type`	string	`image_url`
`role`	string	见下表
`image_url.url`	string	图片地址
`reference_type`	string	`pixverse-video-c1` 使用。`subject` 主体，`background` 背景
`name`	string	`pixverse-video-c1` 使用。提示词里用 `@名字` 引用

role 取值：

role	适用 type	说明
`first_frame`	image_url	首帧。必须显式填写，省略时按参考图提交
`reference_image`	image_url	参考图

Response Body

application/json

curl -X POST "https://loading/v1/video/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-video-c1",
    "prompt": "让 @小猫 在 @花园 中自由奔跑",
    "resolution": "1080p",
    "duration": 5,
    "metadata": {
      "content": [
        {
          "type": "image_url",
          "role": "reference_image",
          "reference_type": "subject",
          "name": "小猫",
          "image_url": {
            "url": "https://example.com/cat.jpg"
          }
        },
        {
          "type": "image_url",
          "role": "reference_image",
          "reference_type": "background",
          "name": "花园",
          "image_url": {
            "url": "https://example.com/garden.jpg"
          }
        }
      ]
    }
  }'

curl -X POST "https://loading/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "pixverse-video-c1",    "prompt": "让 @小猫 在 @花园 中自由奔跑",    "resolution": "1080p",    "duration": 5,    "metadata": {      "content": [        {          "type": "image_url",          "role": "reference_image",          "reference_type": "subject",          "name": "小猫",          "image_url": {            "url": "https://example.com/cat.jpg"          }        },        {          "type": "image_url",          "role": "reference_image",          "reference_type": "background",          "name": "花园",          "image_url": {            "url": "https://example.com/garden.jpg"          }        }      ]    }  }'

{
  "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw",
  "status": "queued"
}

{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}

PixVerse 视频生成

Authorization

Request Body

content 元素结构

Response Body

200application/json

400application/json

`content` 元素结构

application/json

application/json