Wan 2.5 Image to Video API

Transform static images into dynamic, high-definition videos. The Wan 2.5 image to video API delivers industry-leading character consistency, fluid motion, and native audio synchronization for developers and creators.

Configure Request

Response

Click "Generate" to see results

Wan 2.5 I2V — Automate Cinematic Video Generation

Use our RESTful Wan 2.5 image to video API to render 5s or 10s clips in 480p, 720p, or 1080p. Supports 16:9, 9:16, and 1:1 ratios with auto-generated lip-sync and sound effects.

What can you build with the Wan 2.5 API?

Interactive Avatar APIs

Power virtual agents and interactive characters. The Wan 2.5 image to video API maintains strict facial identity while animating speech and expressions.

View documentation

E-commerce Video Automation

Scale your creative production by turning product stills into high-converting video ads programmatically via the Wan 2.5 image to video API.

View documentation

Cinematic Storytelling

Generate B-roll and narrative clips from concept art. Wan 2.5 excels at interpreting atmospheric prompts to create immersive scenes with matching ambient audio.

View documentation

Why developers choose Wan 2.5 I2V

A robust Wan 2.5 image to video API offering superior motion quality, native audio support, and flexible resolution options.

Stable Character Identity

Advanced algorithms ensure faces and objects remain consistent throughout the 10-second generation, solving the 'morphing' issue.

Integrated Audio Generation

Unlike older models, Wan 2.5 generates synchronized speech, background music, and sound effects in a single API call.

Cost-Effective Scaling

Efficient token-based billing allows for affordable batch processing of 1080p marketing assets and social media content.

How to integrate the Wan 2.5 Image to Video API

Three simple steps to automate your video production workflow.

Step 1 — Send API Request

POST your reference image URL and text prompt to the Wan 2.5 image to video API endpoint. Define style and motion parameters.

Step 2 — Configure Specs

Set parameters for duration (5s/10s), resolution (up to 1080p), and aspect ratio (16:9, 9:16, 1:1) within your JSON payload.

Step 3 — Retrieve Video

The API processes the generation asynchronously. Receive a high-fidelity MP4 with embedded audio ready for streaming or download.

Open API Playground

Wan 2.5 API Capabilities

Technical specifications for the Wan 2.5 image to video API

Audio

Native Audio Sync

Generates matching SFX and lip-sync based on video content.

Resolution

High-Res Output

Supports 480p, 720p, and full 1080p HD video generation.

Formats

Flexible Ratios

Output in 16:9, 9:16, or 1:1 for any social platform.

Consistency

Identity Lock

Preserves subject fidelity better than previous diffusion models.

Control

Camera Control

Prompt-based control for dolly, pan, and tilt movements.

Quality

Negative Prompting

Filter out unwanted artifacts programmatically via API.

Wan 2.5 I2V vs. Competitors

Why developers prefer the Wan 2.5 image to video API

Model	Duration	Resolution	Price	Strength
Wan 2.5 Image-to-Video	5s / 10s	Up to 1080p	Flexible API Token Pricing	Native audio, high character consistency, 1080p support.
Wan 2.1 Standard	5s	720p	Token-based	Good motion, but lacks native audio integration and full HD.
Sora (v1)	Varies	1080p	High / Restricted Access	Complex physics, but limited public API availability.

Frequently Asked Questions

Everything you need to know about the product and billing.

You can access the Wan 2.5 image to video API through EvoLink. Simply sign up for an API key, view our documentation, and start making requests using standard RESTful methods or our SDKs.

Yes, a key feature of the Wan 2.5 image to video API is its ability to generate native audio, including speech, music, and sound effects, that synchronizes with the visual motion.

The API supports resolutions ranging from 480p for fast previews up to 1080p (Full HD) for final production-quality assets.

Yes, videos generated via the paid tier of the Wan 2.5 image to video API generally grant you full commercial rights to the output.

Generation times vary by resolution. A 5s clip at 480p is fastest, while a 10s clip at 1080p typically takes 1-5 minutes to render via the API.

Absolutely. Wan 2.5 is optimized for 'Reference-to-Video' tasks, ensuring the facial features and clothing of the subject in your input image remain consistent.

API Reference

Select endpoint

Authentication

All APIs require Bearer Token authentication.

Header

Authorization: 
Bearer YOUR_API_KEY

Get API Key

POST

/v1/videos/generations

Create Video

Wan 2.5 Image to Video (wan2.5-image-to-video) model supports image-to-video generation mode.

Asynchronous processing mode, use the returned task ID to .

Generated video links are valid for 24 hours, please save them promptly.

Request Parameters

modelstringRequiredDefault: wan2.5-image-to-video

Video generation model name.

Examplewan2.5-image-to-video

promptstringRequired

Prompt describing what kind of video to generate from the input image.

Notes

Limited to 2000 tokens

ExampleA cat playing piano

durationintegerOptional

Duration of the generated video (seconds).

Value	Description
5	5 seconds
10	10 seconds

Notes

Pre-charged based on duration, actual charge based on generated video duration

Example5

qualitystringOptionalDefault: 720p

Video quality.

Value	Description
480p	Lower quality, lower price
720p	Standard quality (default)
1080p	High quality, higher price

Example720p

image_urlsarrayRequired

Reference image URL list for first-frame image-to-video feature.

Notes

1 image required for image-to-video generation
Max size: 10MB per image
Formats: .jpeg, .jpg, .png (no transparent), .bmp, .webp
Resolution: width and height range [360, 2000] pixels
URLs must be directly viewable by the server

Examplehttps://example.com/image1.png

prompt_extendbooleanOptionalDefault: true

Whether to enable intelligent prompt rewriting.

Notes

When enabled, a large language model will optimize the prompt
Effective for prompts that lack detail or are too simple

Exampletrue

callback_urlstringOptional

HTTPS callback address after task completion.

Notes

Triggered on completion, failure, or cancellation
Sent after billing confirmation
HTTPS only, no internal IPs
Max length: 2048 chars
Timeout: 10s, Max 3 retries

Examplehttps://your-domain.com/webhooks/video-task-completed

Request Example

{
  "model": "wan2.5-image-to-video",
  "prompt": "A cat playing piano",
  "duration": 5,
  "quality": "720p",
  "image_urls": [
    "https://example.com/image1.png"
  ]
}

Response Example

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "wan2.5-image-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 7,
    "user_group": "default"
  }
}