Skip to main content
PixVerse

PixVerse -- generate a video from reference images

Submit a PixVerse V6 reference-to-video task

POST
/services/aigc/video-generation/video-synthesis
cURL - Reference-to-video
# Singapore (ap-southeast-1). This model is available only in this region.
# API keys are region-specific. See https://docs.qwencloud.com/developer-guides/getting-started/regions
curl --location 'https://ap-southeast-1.maas.qwencloudapi.com/api/v1/services/aigc/video-generation/video-synthesis' \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "pixverse/pixverse-v6-r2v",
  "input": {
    "prompt": "@man sits on a chair by the window, holding @guitar, playing a soothing American country folk song next to @coffeeshop.",
    "media": [
      {
        "type": "image_url",
        "url": "https://example.com/man.png",
        "ref_name": "man"
      },
      {
        "type": "image_url",
        "url": "https://example.com/guitar.png",
        "ref_name": "guitar"
      },
      {
        "type": "image_url",
        "url": "https://example.com/coffeeshop.png",
        "ref_name": "coffeeshop"
      }
    ]
  },
  "parameters": {
    "size": "1280*720",
    "duration": 5,
    "watermark": true
  }
}'
{
  "request_id": "<string>",
  "output": {
    "task_id": "<string>",
    "task_status": "PENDING"
  }
}
Blend subjects from up to 7 reference images into one video, with prompt control and subject consistency.
  • Model: pixverse/pixverse-v6-r2v.
  • Reference images: pass 1 to 7 images in input.media with type set to image_url. Each image must be a publicly accessible JPG, PNG, or WEBP file up to 20 MB.
  • Subject references: set ref_name for each image and reference it in the prompt with @ref_name, followed by a space. Each ref_name must be unique within the request.
  • Audio: set audio to true to generate background music or sound effects that match the video.

Workflow

  1. Submit a task with this endpoint and save the returned task_id.
  2. Poll Retrieve task result every 15 seconds until task_status is SUCCEEDED or FAILED.

Billing

Billing depends on the resolution tier, duration, and whether audio is generated. Check the model pricing before calling.

Errors

For common error codes, see Error messages.

Authorizations

string
header
required

DashScope API Key. Get one from the QwenCloud console.

Header Parameters

enum<string>
required

Must be set to enable. HTTP requests support asynchronous mode only. Omitting this header returns the error "current user api does not support synchronous calls".

enable

Body

application/json
enum<string>
required

Model ID. Only pixverse/pixverse-v6-r2v is supported.

pixverse/pixverse-v6-r2v
pixverse/pixverse-v6-r2v
object
required

Basic input information, including the reference images and the prompt.

object
required

Video generation parameters, such as resolution, duration, and audio.

Response

200-application/json
string

Unique request ID, useful for tracing and troubleshooting.

object

Task output.