Skip to main content
First frame

PixVerse -- generate a video from an image

Submit a PixVerse V6 image-to-video task

POST
/services/aigc/video-generation/video-synthesis
# 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-it2v",
  "input": {
    "prompt": "The woman in the image slowly turns her head and smiles at the camera, with soft sunlight passing through the window.",
    "media": [
      {
        "type": "image_url",
        "url": "https://example.com/image.png"
      }
    ]
  },
  "parameters": {
    "resolution": "720P",
    "duration": 5,
    "watermark": true
  }
}'
{
  "request_id": "<string>",
  "output": {
    "task_id": "<string>",
    "task_status": "PENDING"
  }
}
Animate an input image with a text prompt using PixVerse V6.
  • Model: pixverse/pixverse-v6-it2v.
  • Input image: pass exactly one image in input.media with type set to image_url. The image must be a publicly accessible JPG, PNG, or WEBP file up to 20 MB.
  • Multi-shot: set parameters.shot_type to multi to let the model plan multiple shots automatically. The default single produces one continuous shot.
  • 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-it2v is supported.

pixverse/pixverse-v6-it2v
pixverse/pixverse-v6-it2v
object
required

Basic input information, such as the prompt and the input image.

object

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.