Wan 2.5 Image-to-Video Preview API

alibaba/wan2.5-i2v-preview
Wan 2.5 marks a significant leap in AI video generation technology, blending high-quality photorealistic visuals, synchronized audio, and advanced cinematic controls.
Output
$0.05 / sec (variable)
Released
Nov 20, 2025

Overview

Wan 2.5 is an advanced AI-powered image-to-video generation model from Alibaba Cloud, designed to transform static images into dynamic, photorealistic videos with fully synchronized audio. It supports rich storytelling through cinematic motion control and extended video durations, making it ideal for content creators, advertisers, and filmmakers seeking high-quality, cost-effective video generation.

‍

Technical Specifications

  • Video duration: Up to 10 seconds (longer than many rivals capped at ~8 seconds)
  • Frame rate: 24 frames per second (fps)
  • Audio: Real-time synchronized voiceover, background music, and sound effects
  • Model architecture: Multimodal AI framework integrating vision, audio, and language understanding
  • Compatibility: Runs efficiently on a broad range of GPUs with optimized resource requirements

‍

Performance Benchmarks

  • Generation speed: 25% faster than Wan 2.2 baseline
  • Video quality: 30% improvement in visual fidelity and smoothness
  • Semantic compliance: 40% more accurate at reflecting input prompts in video content
  • Motion reconstruction: 35% smoother transitions and realistic movements
  • Audio-visual sync: High precision lip-syncing and sound alignment
  • Hardware efficiency: 20% better GPU resource utilization compared to previous versions

‍

Key Features

  • Image-to-video generation: Converts static images into dynamic videos up to 10 seconds.
  • Audio-video synchronization: Native support for integrated voiceover, music, and sound effects with lip-sync.
  • Advanced motion control: Cinematic camera moves including pan, tilt, zoom, dolly, and rack focus.
  • Multilingual support: Robust handling of Chinese and other languages in prompts for consistent AV alignment.
  • Efficient rendering: Optimized for faster generation and wider hardware compatibility.

API Pricing

  • 480p: $0.065;
  • 720p: $0.13;
  • 1080p: $0.195

Use Cases

  • Social media content creation with dynamic visuals and sound
  • Marketing videos and short advertisements
  • Cinematic storytelling for short films or promos
  • Educational animations with synchronized narration
  • Video enhancement and style transfer on existing footage

Code Sample

‍

Comparison with Other Models

vs Google Veo 3: Wan 2.5 offers native synchronized audio with lip-sync, supporting integrated voiceover and music, while Veo 3 focuses on realistic ambient sound and dialogue generation but can sometimes have audiovisual mismatches. Wan 2.5 is generally faster and more cost-effective for video generation.

vs Wan 2.2: Wan 2.5 delivers improved dynamic motion with smoother transitions and better visual fidelity compared to Wan 2.2’s moderate motion and detail sharpness. Hardware compatibility and rendering speed are also enhanced in 2.5, with optimized GPU utilization and broader device support.

vs Kling 2.5 Turbo: Wan 2.5 has richer audio-video synchronization capabilities, including lip-sync and sound effects, while Kling 2.5 Turbo emphasizes physics-consistent motion and natural object behavior in videos but with less advanced audio integration.

API Integration

Accessible via AI/ML API. Documentation: available here.

‍

Use cases

  • Social media content creation with dynamic visuals and sound
  • Marketing videos and short advertisements
  • Cinematic storytelling for short films or promos
  • Educational animations with synchronized narration
  • Video enhancement and style transfer on existing footage

‍

How to use Wan 2.5 Image-to-Video Preview API

Install any OpenAI-compatible SDK, point it at api.aimlapi.com/v1, and set the model to alibaba/wan2.5-i2v-preview.
import requests, time

headers = {"Authorization": "Bearer " + AIMLAPI_KEY}
job = requests.post(
    "https://api.aimlapi.com/v2/video/generations",
    headers=headers,
    json={
      "model": "alibaba/wan2.5-i2v-preview",
      "prompt": "A serene timelapse of clouds over a mountain range"
    },
).json()
gid = job["id"]

while True:
    res = requests.get(f"https://api.aimlapi.com/v2/video/generations?generation_id={gid}", headers=headers).json()
    if res.get("status") in ("completed", "error"):
        break
    time.sleep(5)
print(res["video"]["url"])
const headers = {
  Authorization: `Bearer ${process.env.AIMLAPI_KEY}`,
  "Content-Type": "application/json",
};
const job = await (await fetch("https://api.aimlapi.com/v2/video/generations", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "model": "alibaba/wan2.5-i2v-preview",
    "prompt": "A serene timelapse of clouds over a mountain range"
  }),
})).json();

let res;
do {
  await new Promise((r) => setTimeout(r, 5000));
  res = await (await fetch(`https://api.aimlapi.com/v2/video/generations?generation_id=${job.id}`, { headers })).json();
} while (!["completed", "error"].includes(res.status));
console.log(res.video.url);
# submit the generation — the response contains the job "id"
curl -X POST https://api.aimlapi.com/v2/video/generations \
  -H "Authorization: Bearer $AIMLAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"alibaba/wan2.5-i2v-preview","prompt":"A serene timelapse of clouds over a mountain range"}'

# then poll until status is "completed" — video.url holds the result
curl "https://api.aimlapi.com/v2/video/generations?generation_id={id}" -H "Authorization: Bearer $AIMLAPI_KEY"

OpenAI-compatible — swap the base URL and it works with your existing SDK.

Wan 2.5 Image-to-Video Preview API Pricing

TypePrice
Output
$0.05 / sec (variable)

Wan 2.5 Image-to-Video Preview vs other models

ModelInputOutputContextBest for
$0.05 / sec (variable)
Video generation
$0.2 / sec (variable)
Video generation
$1.95 / 1M tokens
$0.10136 / sec
Video generation
$0.0711 / sec
Cinematic video + native audio

Frequently asked questions

Wan 2.5 Image-to-Video Preview takes image as input and returns video.

Wan 2.5 Image-to-Video Preview became available on November 20, 2025.

Wan 2.5 Image-to-Video Preview is priced at $0.065 / sec (variable).

Wan 2.5 Image-to-Video Preview is billed per generation — a fixed charge per output rather than by prompt length.

Yes, Wan 2.5 Image-to-Video Preview accepts image input as well as a text prompt.

Wan 2.5 Image-to-Video Preview was built by Alibaba Cloud.

Send a request to v2/video/generations with alibaba/wan2.5-i2v-preview as the model id.

Yes. Wan 2.5 Image-to-Video Preview is served through AI/ML API, so the same key and endpoint format used for other models applies.

It supports 480p, 720p, and 1080p resolutions.

Video generations are created via the v2/video/generations endpoint.

Start building with Wan 2.5 Image-to-Video Preview

Get API Key
1000+ models, one API.