Get API Key Get API
Docs

Wan2.6 Video Generation

- Alibaba Cloud Wanxiang video generation model

  • Supports Text-to-Video and Image-to-Video
  • Supports 720p/1080p resolution, 5/10/15 seconds duration
  • Supports automatic prompt extension and audio generation

Request example

curl --request POST \
  --url https://api.openveer.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.6",
    "prompt": "A cute cat running on the grass",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

Response example

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

Authorization

Authorization string

All API endpoints require Bearer Token authentication

Get your API Key:

Visit the API Key Management Page to get your API Key

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Request Parameters

model string

Video generation model name, fixed as wan2.6

nsfw_check boolean

Whether to run content moderation before submitting the video task.

  • true: use omni-moderation-latest to review prompts and input images
  • false or omitted: do not send a moderation request, adding no moderation cost or latency (default)
prompt string

Video content description

Required for text-to-video mode. Describe scenes, actions, and styles in detail for better results

Example: "A cute cat stretching in the sunlight"

image_urls string

">
Reference image URL array (only 1 image supported)

Required for image-to-video mode. Supports publicly accessible image URLs

Example: ["https://example.com/image.jpg"]

Note



The system automatically selects text-to-video or image-to-video mode based on whether image_urls is included

negative_prompt string

Negative prompt describing unwanted content

Example: "blurry, low quality, distorted"

aspect_ratio string

Video aspect ratio

Options:

  • 16:9 - Landscape (default)
  • 9:16 - Portrait
  • 1:1 - Square
  • 4:3 - Landscape
  • 3:4 - Portrait

Default: 16:9

Warning



Not supported in image-to-video mode

resolution string

Video resolution

Options:

  • 720p - Standard (default)
  • 1080p - High definition

Default: 720p

Warning



480p resolution is not supported

Note



Billed per second. Pricing varies by resolution. Please refer to the model marketplace for specific pricing

duration integer

Video duration (seconds)

Supported values: 5, 10, 15 seconds only

Default: 5

seed integer

Random seed for reproducible results

Example: 12345

prompt_extend boolean

Whether to automatically extend the prompt

When enabled, the system will automatically optimize and enrich your prompt

audio boolean

Whether to automatically add audio

When enabled, the system will generate matching audio for the video

audio_url string

Specified audio URL

Takes priority over the audio parameter

Warning



Audio duration cannot exceed video duration. If audio is shorter than video duration, the first part of the video will have sound while the rest will be silent.

shot_type string

Shot type

Options:

  • single - Single shot
  • multi - Multiple shots
watermark boolean

Whether to add watermark

template string

Effect template name for image-to-video special effects mode

Note



When using effects mode:

* Only one image is required (passed via `image_urls`)
* No prompt is needed (model ignores the `prompt` field)

General Effects:

  • squish - Squish & Squeeze
  • rotation - Rotation
  • poke - Poke
  • inflate - Balloon Inflate
  • dissolve - Molecular Dissolve
  • melt - Heat Wave Melt
  • icecream - Ice Cream Planet
  • flying - Magic Levitation

Single Person Effects:

  • carousel - Time Carousel
  • singleheart - Love You
  • dance1 - Swing Moment
  • dance2 - Dance Move

For more effects, refer to Alibaba Wanxiang Template Documentation

Resolution and Aspect Ratio Combinations

Aspect Ratio Description 720p Size 1080p Size
16:9 Landscape (default) 1280×720 1920×1080
9:16 Portrait 720×1280 1080×1920
1:1 Square 960×960 1440×1440
4:3 Landscape 1088×832 1632×1248
3:4 Portrait 832×1088 1248×1632

Response

code integer

Response status code, 200 on success

data array
Response data array
status string

Task status, submitted when initially submitted

task_id string

Unique task identifier for querying task status and results

Use Cases

Case 1: Text-to-Video (Simple Request)

{
  "model": "wan2.6",
  "prompt": "A cute cat stretching in the sunlight"
}

Case 2: Text-to-Video (Full Parameters)

{
  "model": "wan2.6",
  "prompt": "A cute cat running on the grass",
  "negative_prompt": "blurry, low quality, distorted",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "seed": 12345,
  "prompt_extend": true,
  "audio": true,
  "shot_type": "single",
  "watermark": false
}

Case 3: Image-to-Video

{
  "model": "wan2.6",
  "prompt": "A kitten running on the ground",
  "image_urls": ["https://upload.openveer.com/f/openveer-models-images/9998233432754770-c059992d-9b01-47d5-810d-ea0502ac9279-image_task_01KD7SSXDBCEWZ869D6PF249ZW_0.png"],
  "resolution": "1080p",
  "duration": 10
}

Case 4: Image-to-Video (Base64 Image)

{
  "model": "wan2.6",
  "prompt": "Make the cat stand up and walk",
  "image_urls": ["data:image/png;base64,iVBORw0KGgo..."],
  "duration": 5
}

Mode Description

Text-to-Video

  • prompt parameter is required
  • image_urls parameter is not needed

Image-to-Video

  • image_urls parameter is required (only 1 image supported)
  • prompt parameter is optional, used to describe expected actions
Note

The system automatically selects the mode based on whether image_urls is included in the request

Note

Query Task Results

Video generation is an async task that returns a task_id upon submission. Use the Get Task Status endpoint to query generation progress and results.

This documentation is built and hosted on Mintlify, a developer documentation platform.