Video
PixVerse V6 Max
用 PixVerse V6 Max 从提示词或一张图片生成 1–15 秒视频,360p 到 1080p,可选音频,按秒计费,以任务形式交付。
PixVerse V6 Max 是 PixVerse V6 的高细节版本。它能从一条提示词,或一张起始图片加上可选的提示词,生成一段 1–15 秒的视频,分辨率为 360p、540p、720p 或 1080p,可选原生音频。发送请求,保存返回的任务 ID,再从该任务读取生成完成的视频。图片以 URL 形式传入。
模型 ID
| 模型 ID | 输入 | 分辨率 | 时长 |
|---|---|---|---|
pixverse-v6-max | 文本、一张图片 | 360p、540p、720p、1080p | 1–15 秒 |
当前价格请查看模型页面。转场、多图参考和延长视频是 PixVerse V6 的功能。
快速示例
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pixverse-v6-max",
"prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9"
}'端点
POST https://api.seedrouter.ai/v1/videos/generations| 请求头 | 值 |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
响应是一个任务({"id": "task_...", "status": "processing"}),而不是生成完成的视频。请轮询 GET /v1/tasks/{task_id} 获取结果。请把 API 密钥保存在服务端代码中。
参数
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
model | string | 必填 | pixverse-v6-max |
prompt | string | 见说明 | 文生视频:必填,最多 5,000 个字符。使用图片时:可选,最多 2,048 个字符。 |
image_urls | URL 列表 | 无 | 图生视频:恰好一张图片。不传时为文生视频。 |
resolution | enum | 540p | 360p、540p、720p 或 1080p。 |
quality | enum | 无 | resolution 的别名,取值相同。同时发送时以 resolution 为准。 |
duration | integer | 5 | 1–15 秒。 |
aspect_ratio | enum | 16:9 | 16:9、4:3、1:1、3:4、9:16、2:3、3:2 或 21:9。仅用于文生视频;使用图片时,视频的画幅与图片一致。 |
audio | boolean | false | 生成原生音频。按带音频费率计费。 |
seed | integer | 无 | 0–2147483647。同一个请求和种子会得到相似的结果。 |
请求结构是严格校验的:未知字段会被拒绝,而不是被忽略。first_frame_image、last_frame_image、img_references 和 extend_from_task_id 会返回 400,并提示使用 pixverse-v6。不支持 callback_url;请改为轮询任务。
图生视频
在 image_urls 中传入一张图片。视频以它开头,画幅与它一致,因此竖图会生成竖屏视频。此时提示词可选。
{
"model": "pixverse-v6-max",
"prompt": "The subject slowly turns toward the camera, soft natural light.",
"image_urls": ["https://example.com/start.png"],
"resolution": "1080p",
"duration": 5
}媒体输入
图片是一个公开的 HTTP(S) URL。不接受 Base64 data URI:请把文件上传到你自己的存储,再传入它的 URL。请使用不超过 20 MB 的 JPG、PNG 或 WebP 图片,每边最多 10,000 像素。
计费维度
当前费率请查看模型定价部分。PixVerse V6 Max 按视频秒数计费,费率由分辨率和是否生成音频决定:
cost = duration × rate per second for the resolution and audio setting文生视频和图生视频价格相同。时长在请求被受理时就已确定,因此预扣金额就是实际扣费金额。最终扣费请在账户的用量记录中查看。失败的任务不计费。
输出结构
提交后返回任务:
{"id": "task_...", "model": "pixverse-v6-max", "status": "processing", "created_at": 1789689600}查询任务
GET https://api.seedrouter.ai/v1/tasks/{task_id}每 10–20 秒轮询一次,直到 status 变为 completed 或 failed。轮询过程中出现网络超时,并不意味着生成失败:请保留任务 ID 并继续查询。不要为了查看进度而再创建一个任务。
完成的任务
{
"id": "task_...",
"model": "pixverse-v6-max",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689690,
"output": {
"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
}
}在我们的测试中,1 秒的 360p、16:9 视频返回为 640 × 360 的 MP4(H.264),从提交到完成用时 81–89 秒。
错误
在任务创建之前被拒绝的请求,会返回 HTTP 错误状态码和一个 error 对象,且不计费。受理之后才失败的任务,在查询时返回 HTTP 200,并带有 status: "failed" 和一个 error 对象。
错误码、HTTP 状态码和重试建议请参见公共错误目录。
{
"id": "task_...",
"model": "pixverse-v6-max",
"status": "failed",
"error": {
"code": 60001,
"message": "The request was rejected by the content policy. Please revise the prompt or input images."
}
}如果提交本身超时,请先检查你的任务列表再重新提交:第一次请求有可能已经被受理。
实用建议
- 在提示词中描述主体、地点、运镜和光线;开启
audio时,请写明你想要的声音。 - 先用
360p或540p出草稿,再用同一个请求和seed以1080p渲染最终镜头。 - 要生成竖屏视频,请传入
aspect_ratio: "9:16",或一张竖图。 - 加上
no text, no logos,避免出现凭空编造的标记。
