Video
PixVerse V6
用 PixVerse V6 从文本、图片、首尾帧、参考图或此前生成的视频生成 1–15 秒视频,360p 到 1080p,按秒计费。
PixVerse V6 是 PixVerse 的视频模型。一个模型 ID 覆盖五种模式:文生视频、图生视频、首尾帧转场、多图参考,以及延长你已生成的视频。模式由你发送的字段决定。视频时长为 1–15 秒,分辨率为 360p、540p、720p 或 1080p,可选原生音频。发送请求,保存返回的任务 ID,再从该任务读取生成完成的视频。图片以 URL 形式传入。
模型 ID
| 模型 ID | 输入 | 分辨率 | 时长 |
|---|---|---|---|
pixverse-v6 | 文本、一张图片、首帧 + 尾帧、1–7 张参考图、一个已完成的 pixverse-v6 任务 | 360p、540p、720p、1080p | 1–15 秒 |
当前价格请查看模型页面。要从文本或一张图片生成细节更丰富的单镜头视频,请看 PixVerse V6 Max。
快速示例
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pixverse-v6",
"prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
"resolution": "540p",
"duration": 5,
"size": "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 |
prompt | string | 必填 | 最多 5,000 个字符。所有模式均必填。 |
resolution | enum | 540p | 360p、540p、720p 或 1080p。 |
duration | integer | 5 | 1–15 秒。首尾帧转场仅支持 5 或 8 秒。 |
size | 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。同一个请求和种子会得到相似的结果。 |
negative_prompt | string | 无 | 描述视频中不要出现的内容。最多 2,048 个字符。 |
watermark | boolean | false | 添加水印。 |
motion_mode | enum | normal | 仅支持 normal。 |
generate_multi_clip_switch | boolean | false | 多片段生成。仅限文生视频和图生视频。 |
image_urls | URL 列表 | 无 | 图生视频。使用第一张图片。 |
first_frame_image | URL | 无 | 转场:首帧。与 last_frame_image 一起发送。 |
last_frame_image | URL | 无 | 转场:尾帧。与 first_frame_image 一起发送。 |
img_references | URL 列表 | 无 | 多图参考:1–7 张图片。 |
extend_from_task_id | string | 无 | 延长:你自己已完成的某个 pixverse-v6 任务的 ID。 |
请求结构是严格校验的:未知字段会被拒绝,而不是被忽略。不支持 callback_url;请改为轮询任务。
模式
模式由你发送的字段决定。每次请求只发送一种模式的字段。
| 模式 | 发送字段 | 说明 |
|---|---|---|
| 文生视频 | 不含图片或延长字段 | size 设置画幅。 |
| 图生视频 | image_urls | 视频以第一张图片开头。 |
| 转场 | first_frame_image + last_frame_image | 5 或 8 秒。 |
| 多图参考 | img_references(1–7 个 URL) | 组合图片中的人物、物体或场景;size 设置画幅。 |
| 延长 | extend_from_task_id | 延续你自己已完成的一个 pixverse-v6 任务。 |
{
"model": "pixverse-v6",
"prompt": "The puppy slowly turns into a kitten, soft studio light.",
"first_frame_image": "https://example.com/puppy.jpg",
"last_frame_image": "https://example.com/kitten.jpg",
"duration": 5
}{
"model": "pixverse-v6",
"prompt": "The paper boat drifts on toward a lily pad.",
"extend_from_task_id": "task_...",
"resolution": "540p",
"duration": 5
}延长视频会返回原视频加上新增片段,只按新增片段的 duration 计费。在我们的测试中,将一段 1 秒视频延长 1 秒后,返回的视频时长为 2.1 秒,按 1 秒计费。
媒体输入
图片是公开的 HTTP(S) URL。不接受 Base64 data URI:请把文件上传到你自己的存储,再传入它的 URL。请使用不超过 20 MB 的 JPG、PNG 或 WebP 图片。
计费维度
当前费率请查看模型定价部分。PixVerse V6 按视频秒数计费,费率由分辨率和是否生成音频决定:
cost = duration × rate per second for the resolution and audio setting所有模式的每秒费用相同;延长视频只对新增片段计费。时长在请求被受理时就已确定,因此预扣金额就是实际扣费金额。最终扣费请在账户的用量记录中查看。失败的任务不计费。
输出结构
提交后返回任务:
{"id": "task_...", "model": "pixverse-v6", "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",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689640,
"output": {
"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
}
}在我们的测试中,1 秒的 360p、16:9 视频返回为 640 × 360 的 MP4(H.264),从提交到完成用时 36–45 秒。
错误
在任务创建之前被拒绝的请求,会返回 HTTP 错误状态码和一个 error 对象,且不计费。受理之后才失败的任务,在查询时返回 HTTP 200,并带有 status: "failed" 和一个 error 对象。
错误码、HTTP 状态码和重试建议请参见公共错误目录。
{
"id": "task_...",
"model": "pixverse-v6",
"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渲染最终镜头。 - 要生成竖屏视频,请在文生视频时传入
size: "9:16",或使用一张竖图。 - 加上
no text, no logos,避免出现凭空编造的标记。
