Video · Alibaba

Wan API

Wan API access for a video and image suite covering text-to-video, image-to-video, video editing, and storyboards.

Operational · 18 variants · from $0.050
Try in playground API reference →
runapi.ai
curl -X POST https://runapi.ai/api/v1/wan/image_to_video \
  -H "Authorization: Bearer $RUNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-2.7-text-to-video",
  "image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
  "prompt": "Generate a 5-second video of a cat jumping onto a bookshelf, natural indoor lighting, handheld camera feel."
}'
import { WanClient } from "@runapi.ai/wan";

const client = new WanClient();
const result = await client.imageToVideo.run({
    model: "wan-2.7-text-to-video",
    image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
    prompt: "Generate a 5-second video of a cat jumping onto a bookshelf, natural indoor lighting, handheld camera feel.",
});
<?php

require __DIR__ . "/vendor/autoload.php";

use RunApi\Wan\WanClient;

$client = new WanClient();
$result = $client->imageToVideo->run([
        'model' => 'wan-2.7-text-to-video',
        'image_url' => 'https://cdn.runapi.ai/public/samples/image.jpg',
        'prompt' => 'Generate a 5-second video of a cat jumping onto a bookshelf, natural indoor lighting, handheld camera feel.',
]);
require "runapi/wan"

client = RunApi::Wan::Client.new
result = client.image_to_video.run(
    model: "wan-2.7-text-to-video",
    image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
    prompt: "Generate a 5-second video of a cat jumping onto a bookshelf, natural indoor lighting, handheld camera feel."
)
npx skills add runapi-ai/wan -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

# Codex
codex plugin install runapi-mcp@agents

# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
@runapi.ai/wan v1
OVERVIEW

Wan is Alibaba's comprehensive video and image generation suite covering text-to-video, image-to-video, video editing, speech-to-video, and storyboard generation. It spans multiple model versions optimized for quality, speed, and specialized creative tasks.

  • Multiple variants for different speed, quality, and cost tiers
  • Model skill includes docs, schemas, pricing, and setup notes
  • Works with Claude Code, Codex, Gemini CLI, Cursor, and VS Code
  • Single API key and unified billing across all variants
  • Async task management with polling and webhook callbacks
  • Failed generations are not charged
VARIANTS

Compare all API variants

Variant Billing From
wan-2.2-a14b-image-to-video-turbo call $0.400 View →
wan-2.2-a14b-speech-to-video-turbo second $0.240 View →
wan-2.2-a14b-text-to-video-turbo call $0.400 View →
wan-2.2-animate-move second $0.130 View →
wan-2.2-animate-replace second $0.130 View →
wan-2.5-image-to-video second $0.120 View →
wan-2.5-text-to-video second $0.120 View →
wan-2.6-edit-video second $0.140 View →
wan-2.6-flash-edit-video call $0.300 View →
wan-2.6-flash-image-to-video call $0.300 View →
wan-2.6-image-to-video second $0.140 View →
wan-2.6-text-to-video second $0.140 View →
wan-2.7-edit-video second $0.160 View →
wan-2.7-image call $0.050 View →
wan-2.7-image-pro call $0.120 View →
wan-2.7-image-to-video second $0.160 View →
wan-2.7-r2v second $0.160 View →
wan-2.7-text-to-video second $0.160 View →
SKILLS

Install the Wan skill for app development

Load the model docs, schemas, pricing notes, and setup steps into your coding workspace.

# Install the model skill for app development workflows
npx skills add runapi-ai/wan -g
Installs docs, schemas, pricing context, and setup notes into your developer workspace.
Or use this setup request in your coding tool:
Install the Wan skill for this app:

1. Add runapi-ai/wan with the skills installer.
2. Load SKILL.md in this workspace.
3. Use its docs, schemas, pricing notes, and setup steps when adding model features.
4. Confirm the install path when done.
OpenClaw

Use Wan in OpenClaw

Prompt, curl command, parameters, and FAQ.
Hermes Agent

Use Wan in Hermes Agent

Custom provider setup, API call, and FAQ.
HOW IT WORKS

From model skill to first result in four steps

01

Choose a model

Browse the model catalog and pick the model and variant that match your output type, quality bar, and latency target. Each variant page shows its model ID, pricing, and parameter constraints so you can compare before committing.

02

Configure

Set your RunAPI API key as an environment variable and install the model skill in your coding workspace. The skill loads docs, typed schemas, pricing notes, and setup steps so your agent has the right context from the start.

03

Call

Use the skill instructions to add the model feature inside your application. Send a POST request with your prompt, model ID, and parameters. RunAPI routes the request, manages the async lifecycle, and returns structured JSON.

04

Receive

Poll by task ID for completion, stream results end-to-end when supported, or configure a webhook callback URL to receive results automatically. The CLI provides a built-in wait command, and the SDKs offer both polling and callback patterns.

CONTEXT

What is the Wan API?

Wan is Alibaba's full-spectrum video and image model suite, one of the most complete open-weight video families available. Through RunAPI, all Wan versions share a single key and unified billing.

Provider
Alibaba
Modality
Video
WHY RUNAPI

Why route the Wan API through RunAPI

One auth, every provider

A single RunAPI API key unlocks the whole model catalog across all providers. No separate accounts to create, no API keys to rotate per integration, and no credential management overhead. Add a new model to your app by changing one parameter.

Unified pricing & billing

Per-call pricing in USD, billed monthly into a single invoice. No subscription tiers, no minimum spend, and failed generations are never charged. The pricing page and check_pricing API show exact costs before you commit to a model.

Schema-first SDK

Typed schemas, parameter constraints, and setup notes are packaged in the model skill so your implementation starts from the right contract. The skill loads into Claude Code, Codex, Gemini CLI, Cursor, and VS Code — your agent knows the correct request shape before you write a line of code.

FAQ

Common questions

Which variant should I start with?

Pick the cheapest variant that meets your quality bar. Most teams start on the fast variant and graduate to pro for production.

Is there a free tier?

New accounts get free first calls on every model. After that, pay per call.

Do you stream results?

Where streaming is available, RunAPI streams end-to-end.

How are failures billed?

Failed generations are not charged.

Are outputs cached?

Generated outputs are stored and retrievable by task ID. Inputs are not cached.

Can I use commercially?

Yes — commercial use is included for every variant unless a model license explicitly restricts it, which is called out on the variant page.

What about rate limits?

Per-key rate limits scale with usage tier. See pricing page for current limits.

Where can I report issues?

Open an issue on the public GitHub repo or email support.

SIMILAR MODELS

If you like the Wan API, try these

Gemini Omni
from $0.0000
Grok Imagine
from $0.020
Hailuo
from $0.300
HappyHorse
from $0.480
START NOW

Start building with the Wan API.

Create free account Read the quickstart →
Variants
Same category
From this provider
Docs