Skip to content
Docs menu

Video models

Wan 2.5

On this page

Wan 2.5 — high-quality AI video generation.

modelIdwan-2-5-image-to-video, wan-2-5-text-to-video
Modalityvideo
PricingSee this model on the Pricing page for the current per-call price (with your markup).

Operations

OperationmodelIdEndpointRequired input
Image To Videowan-2-5-image-to-videoPOST /api/v1/generateprompt, image_url
Text To Videowan-2-5-text-to-videoPOST /api/v1/generateprompt
Poll taskGET /api/v1/task/{id}?model=wan-2-5-image-to-video

Image To Video — wan-2-5-image-to-video

FieldTypeRequiredValues / example
promptstringYesThe text prompt describing the desired video motion Max 800 characters. (default: Animate the still: the chef plates the final course, swirling a ribbon of sauce and setting a single herb leaf with tweezers, steam rising under warm pass lighting, a subtle push-in on the hands.)
image_urlstringYesURL of the image to use as the first frame. Must be publicly accessible (image URL)
durationstringNoThe duration of the generated video in seconds (options: 5 | 10) (default: 5)
resolutionstringNoVideo resolution. Valid values: 720p, 1080p (options: 720p | 1080p) (default: 1080p)
negative_promptstringNoNegative prompt to describe content to avoid Max 500 characters.
enable_prompt_expansionbooleanNoWhether to enable prompt rewriting using LLM (true/false) (default: true)
seednumberNoRandom seed for reproducibility. If None, a random seed is chosen
nsfw_checkerbooleanNoA configurable parameter. Defaults to true in the Playground. (true/false) (default: true)
bash
curl -X POST https://you.bot/api/v1/generate \
  -H "Authorization: Bearer $YOUBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"wan-2-5-image-to-video","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","image_url":"https://example.com/input.jpg","duration":"5","resolution":"720p","negative_prompt":"blurry, low quality, distorted, watermark, text","enable_prompt_expansion":true,"seed":1,"nsfw_checker":true}}'

Text To Video — wan-2-5-text-to-video

FieldTypeRequiredValues / example
promptstringYesThe text prompt for video generation. Supports Chinese and English, max 800 characters. Max 800 characters. (default: A hot slice of pizza lifts away from the pan in a long stretch of melting cheese, flour dust drifting in the oven's amber glow as the camera tracks the rising slice in crisp slow motion.)
durationstringNoThe duration of the generated video in seconds (options: 5 | 10) (default: 5)
aspect_ratiostringNoThe aspect ratio of the generated video (options: 16:9 | 9:16 | 1:1) (default: 16:9)
resolutionstringNoVideo resolution tier (options: 720p | 1080p) (default: 1080p)
negative_promptstringNoNegative prompt to describe content to avoid. Max 500 characters. Max 500 characters.
enable_prompt_expansionbooleanNoWhether to enable prompt rewriting using LLM. Improves results for short prompts but increases processing time. (true/false) (default: true)
seednumberNoRandom seed for reproducibility. If None, a random seed is chosen.
nsfw_checkerbooleanNoA configurable parameter. Defaults to true in the Playground. (true/false) (default: true)
bash
curl -X POST https://you.bot/api/v1/generate \
  -H "Authorization: Bearer $YOUBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"wan-2-5-text-to-video","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","duration":"5","aspect_ratio":"16:9","resolution":"720p","negative_prompt":"blurry, low quality, distorted, watermark, text","enable_prompt_expansion":true,"seed":1,"nsfw_checker":true}}'