Skip to main content
POST
Create video generation and wait

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
string
required
Examples:

"wan3.0-prime-text-to-video"

"wan3.0-prime-image-to-video"

"wan3.0-prime-reference-video"

prompt
string
required
duration

Output duration. Wan 3.0 Prime requires an integer from 2 to 30 seconds.

Example:

5

resolution
string

Resolution or quality alias.

Example:

"720p"

quality
enum<string>

Wan 3.0 Prime output quality.

Available options:
480p,
720p,
1080p
ratio
string
Example:

"16:9"

aspect_ratio
enum<string>

Wan 3.0 Prime output aspect ratio.

Available options:
adaptive,
16:9,
9:16,
1:1,
4:3,
3:4
generate_audio
boolean
default:true

Request synchronized audio when the selected model supports it.

image_start
string<uri>

Required first frame for wan3.0-prime-image-to-video.

image_end
string<uri>

Optional final frame for wan3.0-prime-image-to-video.

image_urls
string<uri>[]

Ordered image references for wan3.0-prime-reference-video.

Maximum array length: 10
video_urls
string<uri>[]

Ordered video references for wan3.0-prime-reference-video.

Maximum array length: 5
audio_urls
string<uri>[]

Ordered audio references for wan3.0-prime-reference-video.

Maximum array length: 5
model_params
object

Optional Wan 3.0 Prime reference context. file_url and link_url are mutually exclusive.

input_images
string<uri>[]
input_videos
string<uri>[]
input_audio
string<uri>[]
callback_url
string<uri>

Response

Completed video task.

task_id
string
required
Example:

"task_123"

status
enum<string>
required
Available options:
pending,
processing,
completed,
failed,
expired
model
string
created_at
string<date-time>
completed_at
string<date-time> | null
result
object

Completed task result. Image tasks use the OpenAI image format (image URL at data[0].url); video and audio tasks expose video_url/audio_url plus a urls[] array.

error
any | null