Video · Text to video · Image to video

Wan 2.5 API

Alibaba Wan 2.5. Strong text-to-video at competitive price.

Price
From $0.25 per run from $0.05/s
Typical time
~2 min
Model id
wan_2_5

Wan 2.5 runs on one varg API key and one credit balance, the same as every other model here. You pay the provider's price, with no markup.

POST /v2/tools/video/call
curl -X POST https://api.varg.ai/v2/tools/video/call \
  -H "Authorization: Bearer $VARG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan_2_5",
  "prompt": "cherry blossom petals falling in slow motion, Japanese garden",
  "files": [
    {
      "url": "https://s3.varg.ai/u/1580f459-9459-47db-9400-b64100181743/tmp_3545c2a5-01d.png"
    }
  ],
  "aspect_ratio": "9:16",
  "duration": 9
}'
Try it in the PlaygroundGet an API key
Real outputcherry blossom petals falling in slow motion, Japanese garden

Wan 2.5 pricing

From $0.25 per run. Prices are in US dollars and are the provider's own, with no markup. Wan 2.5 has 2 routes: "model": "wan_2_5" picks one automatically, or pass a route key as "model" to pin it. For the exact price of a request, send the same body to POST https://api.varg.ai/v2/estimate.

  • fal from $0.05/s
    fal:wan_2.5/t2v

    Text to video

    Resolution 480p
    $0.05/s
    Resolution 720p
    $0.10/s
    Resolution 1080p
    $0.15/s
    Minimum charge
    $0.25
    Most one request can cost
    $1.50
    Typical time
    ~2 min
  • fal from $0.05/s
    fal:wan_2.5/i2v

    Image to video

    Resolution 480p
    $0.05/s
    Resolution 720p
    $0.10/s
    Resolution 1080p
    $0.15/s
    Minimum charge
    $0.25
    Most one request can cost
    $1.50
    Typical time
    ~2 min

Wan 2.5 inputs

The JSON body of the request. Media inputs are URLs: upload a local file with POST /v2/files and pass the URL it returns. Full JSON Schema, no key needed: api.varg.ai/v2/tools/video?model=wan_2_5

Wan 2.5 request fields
FieldWhat it does
model string requiredwan_2_5 picks a route automatically. To pin one, pass a route key from Pricing above.
prompt string —
files array of { url } —
aspect_ratio string Allowed e.g. 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | auto
resolution string Quality tier. Supported by this model: 480p, 720p, 1080p. Unsupported tiers fall back to the nearest available. Allowed 480p | 720p | 1080p | 4k
audio boolean Native audio track request. Not supported by this model — ignored if sent.
duration integer Length in seconds. Supported by this model's routes: fal: 5, 10. A non-numeric value such as "auto" is routed to a route whose schema accepts it; when none does, the request is rejected. Allowed 5–10

Provider options

Optional, under provider_options.<provider>. Only the options of the provider that runs the job apply; pin a route to choose it.

provider_options.fal

Wan 2.5 options for fal
FieldWhat it does
prompt string —
duration string Allowed 5 | 10
resolution string Allowed 480p | 720p | 1080p
aspect_ratio string Allowed e.g. 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | auto
image_url string (URL) —

Call the Wan 2.5 API

POST https://api.varg.ai/v2/tools/video/call with Authorization: Bearer $VARG_API_KEY. It answers 202 with a job right away.

1. Send the request

cURL
curl -X POST https://api.varg.ai/v2/tools/video/call \
  -H "Authorization: Bearer $VARG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan_2_5",
  "prompt": "cherry blossom petals falling in slow motion, Japanese garden",
  "files": [
    {
      "url": "https://s3.varg.ai/u/1580f459-9459-47db-9400-b64100181743/tmp_3545c2a5-01d.png"
    }
  ],
  "aspect_ratio": "9:16",
  "duration": 9
}'
JavaScript
JavaScript
const headers = {
  Authorization: `Bearer ${process.env.VARG_API_KEY}`,
  'Content-Type': 'application/json',
}

const res = await fetch('https://api.varg.ai/v2/tools/video/call', {
  method: 'POST',
  headers,
  body: JSON.stringify({
    "model": "wan_2_5",
    "prompt": "cherry blossom petals falling in slow motion, Japanese garden",
    "files": [
      {
        "url": "https://s3.varg.ai/u/1580f459-9459-47db-9400-b64100181743/tmp_3545c2a5-01d.png"
      }
    ],
    "aspect_ratio": "9:16",
    "duration": 9
  }),
})
const job = await res.json() // { id: "job_…", status: "queued" }
Python
Python
import os
import requests

headers = {"Authorization": f"Bearer {os.environ['VARG_API_KEY']}"}

job = requests.post(
    "https://api.varg.ai/v2/tools/video/call",
    headers=headers,
    json={
      "model": "wan_2_5",
      "prompt": "cherry blossom petals falling in slow motion, Japanese garden",
      "files": [
        {
          "url": "https://s3.varg.ai/u/1580f459-9459-47db-9400-b64100181743/tmp_3545c2a5-01d.png"
        }
      ],
      "aspect_ratio": "9:16",
      "duration": 9
    },
).json()  # {"id": "job_…", "status": "queued"}

2. Get the result

Poll the job until its status is completed, failed or cancelled; Wan 2.5 typically takes about 2 min. The result is at output.outputs[0].url.

GET /v2/jobs/{id}
curl https://api.varg.ai/v2/jobs/$JOB_ID \
  -H "Authorization: Bearer $VARG_API_KEY"

# Poll until "status" is completed, failed or cancelled.
# The result is in output.outputs[0].url
JavaScript
JavaScript
let current = job
while (!['completed', 'failed', 'cancelled'].includes(current.status)) {
  await new Promise((resolve) => setTimeout(resolve, 3000))
  current = await (await fetch(`https://api.varg.ai/v2/jobs/${current.id}`, { headers })).json()
}
console.log(current.output?.outputs?.[0]?.url)
Python
Python
import time

while job["status"] not in ("completed", "failed", "cancelled"):
    time.sleep(3)
    job = requests.get(f"https://api.varg.ai/v2/jobs/{job['id']}", headers=headers).json()

print(job["output"]["outputs"][0]["url"])
Or take a webhook instead of polling

Add options.webhook_url and varg POSTs the finished job to it.

request body
{
  "model": "wan_2_5",
  "prompt": "cherry blossom petals falling in slow motion, Japanese garden",
  "files": [
    {
      "url": "https://s3.varg.ai/u/1580f459-9459-47db-9400-b64100181743/tmp_3545c2a5-01d.png"
    }
  ],
  "aspect_ratio": "9:16",
  "duration": 9,
  "options": {
    "webhook_url": "https://your-app.com/varg-webhook"
  }
}

From Claude, ChatGPT or Cursor (MCP)

The varg MCP server, https://mcp.varg.ai/mcp, runs Wan 2.5 with call_tool. Sign in with varg, no API key to paste. How to connect it

call_tool
{
  "tool": "video",
  "input": {
    "model": "wan_2_5",
    "prompt": "cherry blossom petals falling in slow motion, Japanese garden",
    "files": [
      {
        "url": "https://s3.varg.ai/u/1580f459-9459-47db-9400-b64100181743/tmp_3545c2a5-01d.png"
      }
    ],
    "aspect_ratio": "9:16",
    "duration": 9
  },
  "wait": true
}

Related models

Same API key, same request shape: change the model string to switch.

All models

Wan 2.5 API: questions

How much does Wan 2.5 cost on varg?
Wan 2.5 costs from $0.25 per run on varg (from $0.05/s on the cheapest route). varg charges the provider's price with no markup, from one credit balance. For the exact price of a request before you run it, send the same body to POST https://api.varg.ai/v2/estimate.
How do I call the Wan 2.5 API?
Send POST https://api.varg.ai/v2/tools/video/call with the header "Authorization: Bearer $VARG_API_KEY" and a JSON body that includes "model": "wan_2_5". The call answers 202 with a job right away. Poll GET https://api.varg.ai/v2/jobs/{id} until "status" is "completed", then read output.outputs[0].url, or pass options.webhook_url to be called back.
Can I use Wan 2.5 from Claude, ChatGPT or Cursor?
Yes. Add the varg MCP server (https://mcp.varg.ai/mcp) to Claude, ChatGPT, Cursor or any other MCP client and sign in with varg, with no API key to paste. The agent runs Wan 2.5 with call_tool, passing tool "video" and "model": "wan_2_5".
How long does a Wan 2.5 request take?
Typically about 2 min on the fastest route, by the catalog's estimate. The API answers at once with a job id, so nothing waits on an open connection while it runs.

For AI agents: this page as Markdown is varg.ai/models/wan_2_5.md, and every model is listed in varg.ai/models/llms.txt.