Skip to main content
POST
wan2.6-image-to-video-flash API

Authorizations

Authorization
string
header
required

##All APIs require Bearer Token authentication##

Get API Key:

Visit API Key Management Page to get your API Key

Add to request header:

Body

application/json
model
enum<string>
default:wan2.6-image-to-video-flash
required

Model name

Available options:
wan2.6-image-to-video-flash
Example:

"wan2.6-image-to-video-flash"

prompt
string
required

Prompt describing the desired video, limited to 1500 characters

Maximum string length: 1500
Example:

"A cat playing piano"

image_urls
string<uri>[]
required

Reference image URL list for first-frame image-to-video generation

Note:

  • Number of images per request: 1 image
  • Image size: not exceeding 10MB
  • Supported image formats: .jpeg, .jpg, .png (no transparency), .bmp, .webp
  • Image resolution: width and height range [360, 2000] pixels
  • Image URL must be directly viewable or downloadable (typically URLs ending with image extensions like .png, .jpg)
Maximum array length: 1
Example:
duration
integer

Specify the duration of the generated video (seconds)

Note:

  • Supports any integer value between 2~15 seconds
  • Each request will be pre-charged based on the duration value, actual charges are based on the generated video duration
Required range: 2 <= x <= 15
Example:

5

quality
string

Video quality, defaults to 720p

Options:

  • 720p: Standard quality, standard pricing, this is the default
  • 1080p: High quality, higher pricing
Example:

"720p"

prompt_extend
boolean

Whether to enable intelligent prompt rewriting. When enabled, uses a large model to optimize the prompt, particularly effective for simple or insufficiently descriptive prompts. Default is true

Example:

true

model_params
object

Model parameter configuration

audio_url
string<uri>

Audio file URL. When generate_audio=true, the audio guides lip movements during speech or singing and becomes the soundtrack. With generate_audio=false, the video is silent even if audio_url is provided.

Format: mp3; length: 3~30 seconds; maximum file size: 15MB.

Audio longer than duration is clipped to the first duration seconds. If it is shorter than the video, the remaining part is silent.

Example:

"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/xxx.mp3"

generate_audio
boolean
default:true

Whether to generate audio, defaults to true

Options:

  • true: Generate video with audio, higher pricing
  • false: Generate video without audio, lower pricing

Audio file URL. When generate_audio=true, the audio guides lip movements during speech or singing and becomes the soundtrack. With generate_audio=false, the video is silent even if audio_url is provided.

Example:

true

callback_url
string<uri>

HTTPS callback URL for task completion

Callback timing:

  • Triggered when task is completed, failed, or cancelled
  • Sent after billing confirmation is complete

Security restrictions:

  • Only HTTPS protocol supported
  • Cannot callback to internal IP addresses (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • URL length not exceeding 2048 characters

Callback mechanism:

  • Timeout: 10 seconds
  • Maximum 3 retries on failure (retries at 1/2/4 seconds after failure)
  • Callback response format is consistent with task query API response
  • Callback URL returning 2xx status code is considered successful, other status codes trigger retries
Example:

"https://your-domain.com/webhooks/video-task-completed"

Response

Video task created successfully

created
integer

Task creation timestamp

Example:

1757169743

id
string

Task ID

Example:

"task-unified-1757169743-7cvnl5zw"

model
string

Actual model name used

Example:

"wan2.6-image-to-video-flash"

object
enum<string>

Specific task type

Available options:
video.generation.task
progress
integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100
Example:

0

status
enum<string>

Task status

Available options:
pending,
processing,
completed,
failed
Example:

"pending"

task_info
object

Video task details

type
enum<string>

Task output type

Available options:
text,
image,
audio,
video
Example:

"video"

usage
object

Usage and billing information