接入文档

视频模型 pixverse

支持文生视频与图生视频。按次计费，一次一个视频，价格与版本、时长、模式、像素相关。

计费

以 v3.5 / 360p / 时长 5s / normal 模式为基数（1 倍）：

v2.5 为 0.5 倍
时长 8s 为 2 倍
像素质量：540P 为 1.5 倍、720P 为 2 倍、1080P 为 4 倍
模式 performance 为 2 倍
以上倍数相乘：例如 720P + 时长 8s 为 2×2=4 倍，再加 performance 则为 8 倍

基数单价待补，以控制台「日志与用量」为准。

Pixverse API

1.生成任务

关键字段说明

字段	类型	说明
prompt	string	生成视频的提示词
model	string	模型，支持 v3、v3.5、v2.5
quality	string	画质，支持 360p、480p、720p、1080p
duration	number	视频时长，5 或 8
aspect_ratio	string	视频宽高比
motion_mode	string	运动模式，normal 或 performance
seed	number	随机种子
img_url	string	图片地址，支持 url 或 base64
frame	string[]	视频帧图片地址，支持 url 或 base64，必须为 2 张图
extend	number	扩展时长，0 不扩展，1 扩展
original_video_id	number	原始视频 id
style	string	风格，可选 cyberpunk、anime、comic、clay、3d_animation
template_id	number	模版 id
asset_id	number	自创建角色 id

2.查询任务状态

关键字段说明

字段	类型	说明
video_id	number	视频 id，查询与扩展都用它
url	string	视频链接
first_frame	string	封面
video_status	number	状态：1 完成成功、5 已提交、10 生成中、7 内容审核不通过失败、8 生成失败

3.创建角色

调用创建角色接口 /pixverse/character，返回体中的 AssetId 可重复使用，但不可跨账号使用。

应用场景

场景 1: 文生视频

text

{
  "prompt": "牛鬼蛇神",
  "model": "v3.5",
  "quality": "360p",
  "duration": 5,
  "aspect_ratio": "16:9",
  "motion_mode": "normal",
  "seed": 648043228
}

场景 2: 图生视频

text

{
  "prompt": "颤抖",
  "model": "v3.5",
  "quality": "360p",
  "duration": 5,
  "aspect_ratio": "16:9",
  "motion_mode": "normal",
  "seed": 648043228,
  "img_url": "<图片地址，支持 url 或 base64>"
}

场景 3: Transition 前后帧

text

{
  "prompt": "渐变",
  "model": "v3.5",
  "quality": "360p",
  "duration": 5,
  "aspect_ratio": "16:9",
  "motion_mode": "normal",
  "frame": [
    "<首帧图片地址>",
    "<尾帧图片地址>"
  ],
  "seed": 739052608
}

场景 4: Extend 扩展

text

{
  "prompt": "牛奶",
  "model": "v3.5",
  "quality": "360p",
  "duration": 5,
  "motion_mode": "normal",
  "seed": 622979623,
  "platform": "web",
  "extend": 1,
  "original_video_id": 314958906984512
}

场景 5: Effetc 模版特效

text

{
  "prompt": "放马西行，直面天命！",
  "model": "v3.5",
  "quality": "360p",
  "duration": 5,
  "aspect_ratio": "16:9",
  "motion_mode": "normal",
  "seed": 648043228,
  "img_url": "<图片地址>",
  "template_id": 313359209531840
}

场景 6: Style 风格

text

{
  "prompt": "放马西行，直面天命！",
  "model": "v3.5",
  "quality": "360p",
  "duration": 5,
  "aspect_ratio": "16:9",
  "motion_mode": "normal",
  "style": "cyberpunk",
  "seed": 648043228
}

场景 7: character 角色

A. 通过创建角色接口生成角色 ID（AssetId）。

B. 用 AssetId 进行创作，示例如下：

text

{
  "prompt": "微笑",
  "model": "v3.5",
  "quality": "360p",
  "duration": 5,
  "aspect_ratio": "16:9",
  "motion_mode": "normal",
  "seed": 648043228,
  "asset_id": 315472036507328
}