PixVerse V6

POST

tasks

PixVerse V6

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "negative_prompt": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "seed": 123,
  "image_urls": [
    "<string>"
  ],
  "first_frame_image": "<string>",
  "last_frame_image": "<string>",
  "watermark": true,
  "generate_audio": true,
  "motion_mode": "<string>",
  "generate_multi_clip_switch": true,
  "img_references": [
    "<string>"
  ],
  "ref_task_id": "<string>"
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "negative_prompt": "<string>",
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "seed": 123,
    "image_urls": ["<string>"],
    "first_frame_image": "<string>",
    "last_frame_image": "<string>",
    "watermark": True,
    "generate_audio": True,
    "motion_mode": "<string>",
    "generate_multi_clip_switch": True,
    "img_references": ["<string>"],
    "ref_task_id": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    negative_prompt: '<string>',
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>',
    seed: 123,
    image_urls: ['<string>'],
    first_frame_image: '<string>',
    last_frame_image: '<string>',
    watermark: true,
    generate_audio: true,
    motion_mode: '<string>',
    generate_multi_clip_switch: true,
    img_references: ['<string>'],
    ref_task_id: '<string>'
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"seed\": 123,\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"watermark\": true,\n  \"generate_audio\": true,\n  \"motion_mode\": \"<string>\",\n  \"generate_multi_clip_switch\": true,\n  \"img_references\": [\n    \"<string>\"\n  ],\n  \"ref_task_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"seed\": 123,\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"watermark\": true,\n  \"generate_audio\": true,\n  \"motion_mode\": \"<string>\",\n  \"generate_multi_clip_switch\": true,\n  \"img_references\": [\n    \"<string>\"\n  ],\n  \"ref_task_id\": \"<string>\"\n}")
  .asString();

PixVerse V6 是 PixVerse 的统一视频生成模型：一个模型同时覆盖文生视频、图生视频、首尾帧转场和多图参考融合，支持多镜头连续叙事、原生同步音频（对白、音效与背景音乐）以及电影镜头控制，输出 360p 到 1080p、1–15 秒的片段。generate 的生成模式由传入的媒体字段决定；extend 接着已完成的任务往后续写。

快速开始

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pixverse-demo-001" \
  -d '{
    "model": "pixverse-v6",
    "action": "generate",
    "prompt": "金色黄昏，一只柯基穿过向日葵花田，镜头跟随",
    "resolution": "540p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "action": "generate",
    "prompt": "东京霓虹小巷，细雨夜景，远处传来街声",
    "resolution": "720p",
    "duration": 8,
    "generate_audio": true
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "action": "generate",
    "prompt": "镜头缓缓推近，微风拂动树叶",
    "image_urls": ["https://cdn.example.com/first-frame.jpg"],
    "resolution": "540p",
    "duration": 5
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "action": "generate",
    "prompt": "从清晨过渡到黄昏，光线逐渐变暖",
    "first_frame_image": "https://cdn.example.com/first.jpg",
    "last_frame_image": "https://cdn.example.com/last.jpg",
    "resolution": "720p",
    "duration": 5
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "action": "generate",
    "prompt": "把人物放进第二张的场景，光线统一，镜头缓慢环绕",
    "img_references": [
      "https://cdn.example.com/person.jpg",
      "https://cdn.example.com/scene.jpg"
    ],
    "resolution": "720p",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "action": "extend",
    "ref_task_id": "task-wave1775285160b950328499",
    "prompt": "人物继续向前，走进树林",
    "resolution": "540p",
    "duration": 5
  }'

提交成功后返回 task_id。用 GET /v1/tasks/{task_id} 查询结果，也可以用 Prefer: wait 在一次调用里等待，或配置 Webhook。 接着往下做：续写分两步。先提交 action: "generate" 拿到 task_id；任务 completed 后，把这个 task_id 作为 ref_task_id 提交 action: "extend"。ref_task_id 是本账户下已完成的 pixverse-v6 任务的 task_id，不是上游 ID。

请求参数

string

必填

固定为 pixverse-v6。

string

默认值:"generate"

generate：生成视频。只给 prompt 是文生视频，带 image_urls 是图生视频，first_frame_image 与 last_frame_image 成对是首尾帧转场，带 img_references 是多图参考融合。
extend：视频续写，必须提供 ref_task_id。

string

必填

视频描述，最多 5000 字符。action: "extend" 时描述续写部分。

string

负向提示词，用于排除不想要的内容，最多 2048 字符。

integer

视频时长（秒），1–15 的整数。首尾帧模式只支持 5 或 8。

string

默认值:"540p"

输出分辨率：360p、540p、720p 或 1080p，默认 540p。分辨率决定计费档位。

string

画面比例：16:9、4:3、1:1、3:4、9:16、2:3、3:2、21:9。只在文生视频与多图融合模式下生效，其余模式跟随输入图；action: "extend" 跟随源视频。

integer

随机种子，范围 0–2147483647。相同提示词与相同种子可复现相近结果。

string[]

图生视频的输入图 URL 数组，只取第一张。仅 action: "generate"。

string

首尾帧转场的起始帧图片 URL，必须与 last_frame_image 一起提供。仅 action: "generate"。

string

首尾帧转场的结束帧图片 URL，必须与 first_frame_image 一起提供。仅 action: "generate"。

boolean

默认值:"false"

是否在视频右下角加水印。

boolean

默认值:"false"

是否生成带音轨的视频。开启后走带声计价档。

string

运动模式。pixverse-v6 只支持 normal。

boolean

默认值:"false"

是否生成多镜头连续视频。只在 action: "generate" 的文生视频与图生视频模式下有效。

string[]

多图参考融合的图片 URL 数组，1–7 张。传入即进入多图融合模式。仅 action: "generate"。

string

要续写的任务 ID，action: "extend" 时必填。取本账户下已完成的 pixverse-v6 任务返回的 task_id。

通用的 callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。以上之外的参数会返回 400，不计费。

限制

条件	限制
提供了 `first_frame_image`	首尾帧模式只支持 5 或 8 秒
`action: "extend"`	续写接着源任务生成：必须提供提示词，不能再传图片或首尾帧，画幅跟随源视频。
每次请求	本模型一次任务只产出一个结果，不支持用 n 批量生成

项目	上限
输入图 `image_urls`	只取第一张
首尾帧	`first_frame_image` 与 `last_frame_image` 必须成对提供
多图融合 `img_references`	1–7 张
提示词	`prompt` ≤ 5000 字符，`negative_prompt` ≤ 2048 字符
时长 `duration`	1–15 秒整数；首尾帧模式为 5 或 8 秒
分辨率 `resolution`	`360p` / `540p` / `720p` / `1080p`，默认 `540p`

所有图片输入只接受公网可访问的 HTTP(S) 链接，不接受 base64 与 Data URI。

计费

按输出分辨率档 × 输出秒数计费，秒数取请求里的 duration，不传 resolution 时按 540p 档计。四档分辨率各有单独的单价，分辨率越高越贵。action: "extend" 同样按本次请求的 duration 与 resolution 计费，与源任务无关。 generate_audio 是第二个计费维度：开启后按同一分辨率的带声档结算，带声档高于静音档。参考图、首尾帧、负向提示词与画面比例都不单独计费。

各模型的单价见 GET /v1/models 返回的 price_config，或控制台「模型市场」。看这一单实际花了多少：任务响应里的 cost（整数 quota，500,000 quota = 1 USD）。

只有成功出片才计费。任务失败、取消，或上游返回成功但没有可交付视频时，全额退款。最终费用以任务响应里的 cost 为准，cost 是整数 quota 不是美元（500,000 quota = 1 USD）。

响应

任务完成

{
  "task_id": "task-wave1775285160b950328499",
  "model": "pixverse-v6",
  "action": "generate",
  "status": "completed",
  "progress": "100%",
  "created_at": 1775285160,
  "completed_at": 1775285260,
  "result": {
    "videos": [
      {
        "expires_at": 1775371560,
        "url": ["https://cdn.example.com/result.mp4"]
      }
    ]
  },
  "billing_status": "settled",
  "cost": 22500,
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499/cancel"
  }
}

result.videos 返回生成的视频，url 是数组，expires_at 是链接过期时间（Unix 秒），过期前请自行转存。完整字段说明见查询任务状态。

可用模型

模型 ID	分辨率	时长（秒）	动作	说明
`pixverse-v6`	`360p` / `540p` / `720p` / `1080p`	1–15 任意整数	`generate` `extend`	文生 / 图生 / 首尾帧 / 多图融合 / 续写，可选带声输出

相关文档

PixVerse V6

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "negative_prompt": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "seed": 123,
  "image_urls": [
    "<string>"
  ],
  "first_frame_image": "<string>",
  "last_frame_image": "<string>",
  "watermark": true,
  "generate_audio": true,
  "motion_mode": "<string>",
  "generate_multi_clip_switch": true,
  "img_references": [
    "<string>"
  ],
  "ref_task_id": "<string>"
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "negative_prompt": "<string>",
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "seed": 123,
    "image_urls": ["<string>"],
    "first_frame_image": "<string>",
    "last_frame_image": "<string>",
    "watermark": True,
    "generate_audio": True,
    "motion_mode": "<string>",
    "generate_multi_clip_switch": True,
    "img_references": ["<string>"],
    "ref_task_id": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    negative_prompt: '<string>',
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>',
    seed: 123,
    image_urls: ['<string>'],
    first_frame_image: '<string>',
    last_frame_image: '<string>',
    watermark: true,
    generate_audio: true,
    motion_mode: '<string>',
    generate_multi_clip_switch: true,
    img_references: ['<string>'],
    ref_task_id: '<string>'
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"seed\": 123,\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"watermark\": true,\n  \"generate_audio\": true,\n  \"motion_mode\": \"<string>\",\n  \"generate_multi_clip_switch\": true,\n  \"img_references\": [\n    \"<string>\"\n  ],\n  \"ref_task_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"seed\": 123,\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"watermark\": true,\n  \"generate_audio\": true,\n  \"motion_mode\": \"<string>\",\n  \"generate_multi_clip_switch\": true,\n  \"img_references\": [\n    \"<string>\"\n  ],\n  \"ref_task_id\": \"<string>\"\n}")
  .asString();

文本生成

图像生成

视频生成

音频处理

工具与嵌入

任务管理

账户与用量

快速开始

请求参数

限制

计费

响应

可用模型

相关文档

​快速开始

​请求参数

​限制

​计费

​响应

​可用模型

​相关文档

快速开始

请求参数

限制

计费

响应

可用模型

相关文档