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 is PixVerse’s unified video model: one model covers text-to-video, image-to-video, first/last-frame transitions and multi-image reference fusion, with a multi-shot engine for continuous narrative, native synchronized audio (dialogue, sound effects and background music) and cinematic camera control, at 360p to 1080p and 1 to 15 seconds. Under generate the mode follows the media fields you send; extend continues a completed task.

Quick start

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": "Golden hour, a corgi running through a sunflower field, tracking camera",
    "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": "A neon alley in Tokyo, light rain at night, street noise in the distance",
    "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": "The camera pushes in slowly, a breeze moves the leaves",
    "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": "Morning fading into dusk, the light turning warm",
    "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": "Place the character into the second scene, matching light, slow orbit",
    "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": "The character keeps walking into a forest",
    "resolution": "540p",
    "duration": 5
  }'

A successful submission returns a task_id. Retrieve the result with GET /v1/tasks/{task_id}, wait inline with Prefer: wait, or configure a webhook. Chaining an extension takes two steps. Submit action: "generate" and keep the task_id; once the task is completed, pass that task_id as ref_task_id on an action: "extend" request. ref_task_id is the task_id of a completed pixverse-v6 task in your account, not an upstream ID.

Request parameters

string

required

Must be pixverse-v6.

string

default:"generate"

generate — generate a video. prompt alone is text-to-video, image_urls is image-to-video, first_frame_image together with last_frame_image is a first/last-frame transition, and img_references is multi-image reference fusion.
extend — video extension; ref_task_id is required.

string

required

The video description, up to 5000 characters. Under action: "extend" it describes the continuation.

string

Negative prompt used to exclude unwanted content, up to 2048 characters.

integer

Video length in seconds, an integer from 1 to 15. First/last-frame mode accepts only 5 or 8.

string

default:"540p"

Output resolution: 360p, 540p, 720p or 1080p; defaults to 540p. Resolution selects the price tier.

string

Frame ratio: 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 or 21:9. Effective in text-to-video and multi-reference fusion only; other modes follow the input image, and action: "extend" follows the source video.

integer

Random seed from 0 to 2147483647. The same prompt and seed reproduce similar results.

string[]

Input image URLs for image-to-video; only the first image is used. action: "generate" only.

string

Starting frame URL for a first/last-frame transition. Must be sent together with last_frame_image. action: "generate" only.

string

Closing frame URL for a first/last-frame transition. Must be sent together with first_frame_image. action: "generate" only.

boolean

default:"false"

Whether to add a watermark in the bottom-right corner of the video.

boolean

default:"false"

Whether to generate a video with an audio track. Enabling it moves the task to the audio price tier.

string

Motion mode. pixverse-v6 supports normal only.

boolean

default:"false"

Whether to generate a multi-clip continuous video. Effective in the text-to-video and image-to-video modes of action: "generate" only.

string[]

Reference image URLs for multi-image fusion, 1 to 7 images. Sending this field selects fusion mode. action: "generate" only.

string

The task to extend; required under action: "extend". Use the task_id of a completed pixverse-v6 task in your account.

See Submit Task for callback_url, callback_events, Prefer: wait, Idempotency-Key and the maximum-cost header. Any other parameter returns 400 and is not billed.

Limits

Condition	Limit
`first_frame_image` provided	First/last frame mode only supports 5 or 8 seconds
`action: "extend"`	Extension continues the source task: a prompt is required, images and first/last frames cannot be sent, and the aspect ratio follows the source video.
Every request	This model produces one result per task; n is not supported

Item	Limit
Input image `image_urls`	Only the first image is used
First/last frame	`first_frame_image` and `last_frame_image` must be sent together
Fusion references `img_references`	1 to 7 images
Prompts	`prompt` up to 5000 characters, `negative_prompt` up to 2048
Duration `duration`	1 to 15 seconds; 5 or 8 in first/last-frame mode
Resolution `resolution`	`360p` / `540p` / `720p` / `1080p`, default `540p`

All image inputs must be publicly reachable HTTP(S) URLs; base64 and Data URIs return an error.

Pricing

Billing is resolution tier × output seconds, where the seconds come from the duration you send; without resolution the 540p tier applies. Each of the four resolutions is priced separately, and higher resolutions cost more. action: "extend" is billed the same way, on this request’s duration and resolution, independent of the source task. generate_audio is the second billing dimension: enabling it settles at the audio tier for the same resolution, which is above the silent tier. Reference images, first/last frames, the negative prompt and the aspect ratio carry no separate charge.

Per-model rates are in price_config on GET /v1/models, and in the console’s Model Market.What a single call actually cost is the cost field on the task response — an integer quota at 500,000 quota = 1 USD.

You are billed only for a delivered video. Failed and cancelled tasks, and upstream successes that carry no deliverable video, are refunded in full. The final charge is the cost field on the task response — an integer quota, not dollars (500,000 quota = 1 USD).

Response

Completed task

{
  "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"
  }
}

Generated videos are returned in result.videos; url is an array and expires_at is the link expiry in Unix seconds, so copy the file to your own storage before then. See Query Task Status for the full field reference.

Available models

Model ID	Resolution	Duration (s)	Action	Notes
`pixverse-v6`	`360p` / `540p` / `720p` / `1080p`	Any integer 1 to 15	`generate` `extend`	Text, image, first/last frame, fusion and extension in one model, with optional audio

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();

Text Generation

Image Generation

Video Generation

Audio

Tools & Embeddings

Task Management

Account & Usage

Quick start

Request parameters

Limits

Pricing

Response

Available models

​Quick start

​Request parameters

​Limits

​Pricing

​Response

​Available models

​Related

Quick start

Request parameters

Limits

Pricing

Response

Available models

Related