PixVerse 视频生成

PixVerse 使用 OpenAI 兼容视频接口。支持的公开模型名带有 PixVerse/ 前缀，包括 PixVerse/c1、PixVerse/v6、PixVerse/v5.6、PixVerse/v5.5、PixVerse/v5、PixVerse/v4.5、PixVerse/v4 和 PixVerse/v3.5。

调用方式

使用 POST /v1/videos 创建任务，使用 GET /v1/videos/{task_id} 查询状态，并使用 GET /v1/videos/{task_id}/content 下载完成的视频。

curl -X POST "https://router.aionclaw.ai/v1/videos" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -F "model=PixVerse/v6" \
  -F "prompt=A hummingbird flying through a garden in slow motion" \
  -F "duration=5"

提交成功的响应示例：

{
  "id": "task_01HZX7Q8K6P3Y4M2N9R5T1V0AB",
  "task_id": "task_01HZX7Q8K6P3Y4M2N9R5T1V0AB",
  "object": "video",
  "model": "PixVerse/v6",
  "status": "queued",
  "progress": 0,
  "created_at": 1780000000
}

保存 id 或 task_id。任务完成后，GET /v1/videos/{task_id} 的顶层 status 为 completed，视频地址在 metadata.url。完整的查询响应、状态和下载命令见异步任务工作流。

请求头

Header	必填	说明
`Authorization`	是	`Bearer <API_KEY>`。
`Content-Type`	是	使用表单时由客户端自动生成 `multipart/form-data` 的 boundary。

创建任务字段

字段	类型	必填	说明
`model`	string	是	带 `PixVerse/` 前缀的模型 ID。
`prompt`	string	是	文本提示词。
`duration`	integer	否	视频时长。未传时默认 5 秒；合法范围取决于模型。
`image`	string	图生时必填	一张公开图片 URL 或 data URI。一次请求只接受一张；不支持将本地文件作为 `image` 表单文件上传。
`resolution` 或 `size`	string	否	输出画质：`360p`、`540p`、`720p` 或 `1080p`；默认 `720p`。
`metadata`	object 或 JSON 字符串	否	传递画幅、运动、音频和其他 PixVerse 专有控制。

模型与时长

模型	时长	额外能力
`PixVerse/c1`、`PixVerse/v6`	1–15 秒	支持音频开关。
`PixVerse/v5.6`、`PixVerse/v5.5`	5、8 或 10 秒	`v5.5` 支持多片段开关。`1080p` 不支持 10 秒。
`PixVerse/v5`	5 或 8 秒	标准短视频。
`PixVerse/v4.5`、`PixVerse/v4`、`PixVerse/v3.5`	5 或 8 秒	`1080p` 仅支持 5 秒。

画质可通过顶层 resolution 或 size，或者 metadata.quality 设置为 360p、540p、720p 或 1080p。未设置时默认 720p。顶层 quality 不会被当前适配器读取。

专有参数

将 PixVerse 专有控制放入 metadata。常用字段包括 quality、aspect_ratio、motion_mode、camera_movement、seed、style、negative_prompt、generate_audio_switch 和 generate_multi_clip_switch。

字段	类型	必填	说明
`quality`	string	否	`360p`、`540p`、`720p` 或 `1080p`。可替代顶层 `resolution`。
`aspect_ratio`	string	否	文生视频的目标画幅，例如 `16:9` 或 `9:16`。
`motion_mode`	string	否	`normal` 或 `fast`。`fast` 仅支持 `v4.5`、`v4`、`v3.5` 的 5 秒、非 `1080p` 请求。
`camera_movement`	string	否	镜头运动控制。请按目标模型支持的值填写。
`seed`	integer	否	随机种子。
`style`	string	否	风格控制。
`negative_prompt`	string	否	不希望出现在视频中的内容。
`generate_audio_switch`	boolean	否	仅 `c1`、`v6`、`v5.6` 和 `v5.5` 支持。
`generate_multi_clip_switch`	boolean	否	仅 `v5.5` 和 `v6` 支持。也兼容 `generate_multi_shot_clip_switch`。
`img_id`	integer	否	可复用已上传图片的 ID，必须是正整数。

图片输入使用 image。一次图生请求只接受一张公开 URL 或 data URI；需要复用上传素材时传 metadata.img_id。请在发布前使用目标模型验证参数组合。

完整图生调用示例

传入公开图片 URL 或 data URI。Router 会先将图片上传给 PixVerse，再创建视频任务。一次请求只传一张图片。

# 1. 用图片 URL 创建图生任务。
curl -X POST "https://router.aionclaw.ai/v1/videos" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "PixVerse/v6",
    "prompt": "让画面中的纸船沿着雨后的水洼缓慢前行，微距镜头，真实水面反光",
    "image": "https://example.com/paper-boat.jpg",
    "duration": 5,
    "resolution": "720p",
    "metadata": {
      "aspect_ratio": "16:9",
      "generate_audio_switch": true
    }
  }'

# 2. status 为 completed 后下载视频。
curl -L "https://router.aionclaw.ai/v1/videos/task_01HZX7Q8K6P3Y4M2N9R5T1V0AB/content" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  --output pixverse.mp4

PixVerse 的媒体结果可能是短期地址。请通过 AionRouter 的 /content 接口下载，并将需要长期保存的视频转存到自己的存储。

​调用方式

​请求头

​创建任务字段

​模型与时长

​专有参数

​完整图生调用示例

调用方式

请求头

创建任务字段

模型与时长

专有参数

完整图生调用示例