Overview
Wan 2.5 generates short videos from a text prompt or from one reference image plus a prompt.Endpoint and authentication
Base URL:
All requests require your APIXO API key:
Copy-paste async quickstart
taskId; you need it to poll for the final result.
Poll for result
resultJson after state becomes success:
Request body
Text-to-video
Image-to-video
Parameters
Result delivery mode. Use
async for polling with statusTask, or callback for webhook delivery.Required when
request_type is callback. Must be a public HTTPS URL that can receive the final task payload. See Webhooks.Response format
Submit task response
POST /generateTask/wan-2-5-video returns a task ID when the task is accepted:
Status response fields
Webhook callback mode
Use callback mode when your backend should receive the final result automatically instead of polling.Billing
New non-LLM requests use 1 credit =$0.001. Calculate the full amount, including billable quantity and add-ons, apply the applicable account discount, then round the request total upward to the next whole credit. Agreed fixed unit prices retain their precision and replace the standard price and discount; final rounding still applies. See credit conversion and rounding.
Wan 2.5 is billed per generated second.
Final cost formula:
Latency and polling
Video generation is long-running. Actual latency may vary by prompt complexity, mode, selected resolution, and current queue load.
Practical notes:
- Use
aspect_ratioonly withtext-to-video. audio_urlssupports one MP3/WAV URL with max 15 MB; recommended duration range is 3-30 seconds.- For
image-to-video,image_urlsmust contain exactly one image URL and the image file should be at most 20 MB. - Result URLs are temporary. Download important outputs promptly.
429, slow down requests and retry with backoff. For account-level details, see System APIs.
Errors and troubleshooting
HTTP errors
Task failure codes
Parameter troubleshooting
promptis required fortext-to-video, optional forimage-to-video.image_urlsis required only forimage-to-videoand must contain exactly one URL.audio_urlssupports exactly one MP3/WAV URL when provided; file size should be ≤ 15 MB and recommended duration range is 3-30 seconds.resolutiondefaults to1080pwhen omitted.durationdefaults to5when omitted and only accepts5or10.aspect_ratioapplies only totext-to-video.
MCP integration
The complete model schema declares result decoding inmcp.result and supported file bindings in mcp.attachments. These are client integration metadata, not generation input parameters. Attachment paths: image_urls, audio_urls. Preserve the user’s file order. Model parameter validation remains on the API.