Wan 2.5 API

Wan 2.5 video from a prompt or from the first and last frames: 5 or 10 seconds, 480p to 1080p.

Developer: AlibabaModel key in the API: wan

For AI assistants:Download .md All documentation .md Open as text

Connect in three steps

Get a keyCreate a key in the dashboard after you confirm your email. One key opens every model.
Check the pricePOST /v1/price shows the cost of a run in advance, without charging you.
Run a task and collect the resultPOST /v1/tasks starts a task, GET /v1/tasks/{id} shows its status and files.

Ready-to-use code

Replace YOUR_API_KEY with your key. The code starts a task and waits for the result. In cURL, repeat the second request with the id from the first response instead of TASK_ID until status becomes succeeded.

cURLPythonNode.js

cURL

curl -X POST "https://api.cyhub.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "wan",
  "settings": {
    "mode": "text",
    "model": "2_5",
    "prompt": "Кот играет с клубком на солнечном подоконнике, камера медленно приближается",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": "5s"
  }
}'

curl "https://api.cyhub.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import time

import requests

API = "https://api.cyhub.ai/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

body = {
    "model": "wan",
    "settings": {
        "mode": "text",
        "model": "2_5",
        "prompt": "Кот играет с клубком на солнечном подоконнике, камера медленно приближается",
        "quality": "720p",
        "aspect_ratio": "16:9",
        "duration": "5s",
    },
}

response = requests.post(f"{API}/tasks", json=body, headers=HEADERS, timeout=60)
response.raise_for_status()
task = response.json()
while task["status"] in ("queued", "running"):
    time.sleep(5)
    task = requests.get(f"{API}/tasks/{task['id']}", headers=HEADERS, timeout=30).json()
print(task["status"], task["result"])

Node.js

const API = "https://api.cyhub.ai/v1";
const HEADERS = { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" };

const body = {
  "model": "wan",
  "settings": {
    "mode": "text",
    "model": "2_5",
    "prompt": "Кот играет с клубком на солнечном подоконнике, камера медленно приближается",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": "5s"
  }
};

async function main() {
  let response = await fetch(`${API}/tasks`, { method: "POST", headers: HEADERS, body: JSON.stringify(body) });
  if (!response.ok) throw new Error(await response.text());
  let task = await response.json();
  while (task.status === "queued" || task.status === "running") {
    await new Promise((resolve) => setTimeout(resolve, 5000));
    response = await fetch(`${API}/tasks/${task.id}`, { headers: HEADERS });
    task = await response.json();
  }
  console.log(task.status, task.result);
}

main();

Get a key

Price before the run

Prices as of 15.10.2026: from 20 ₽. POST /v1/price shows the exact price of your settings.

Mode	Price
From a prompt	from 20 ₽
From frames	from 20 ₽

Send the same settings to POST /v1/price: the response shows the price of the run without charging you.

cURL

curl -X POST "https://api.cyhub.ai/v1/price" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "wan",
  "settings": {
    "mode": "text",
    "model": "2_5",
    "prompt": "Кот играет с клубком на солнечном подоконнике, камера медленно приближается",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": "5s"
  }
}'

amount_minor: the price of the run in minor units (kopecks for rubles)
currency: the wallet currency
available_minor: how much your balance has for new tasks right now

Modes

Each mode has its own parameters and examples. The mode is set by the mode field.

From a prompt mode = text
From frames mode = frames

From a prompt

Video from text alone. Versions 2.5, 2.6 and 2.7; Wan 3.0 has no such mode.

Value of the mode field: text

This page is about Wan 2.5: send model = 2_5. Without the model field the task runs on 2_7.

Price in this mode from 20 ₽.

Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

promptRequired: What happens in the video: scene, motion, camera, style. Up to 5,000 characters.
Type: StringMinimum characters: 1Maximum characters: 5000
modelOptional: Wan version: 2.5, 2.6 or 2.7.
Type: StringAllowed values: 2_5Default: "2_7"
qualityOptional: Video resolution; the set depends on the version. The price per second depends on it.
Type: StringAllowed values: 480p720p1080pDefault: "720p"
aspect_ratioOptional: Frame shape. Wan 2.5 at 480p offers only 16:9, 9:16 and 1:1.
Type: StringAllowed values: 16:99:161:14:33:4The set depends on quality.
Exceptions
quality aspect_ratio
480p except 4:3, 3:4
Default: "16:9"
durationOptional: Video length: 5 or 10 seconds for Wan 2.5, 2 to 15 for 2.6 and 2.7. The price is per second.
Type: StringAllowed values: 5s10sDefault: "5s"
multi_shotsOptional: Split the video into several scenes. Wan 2.6 and 2.7 only.
Type: BooleanDefault: false
audioOptional: Your own sound for the video, such as a voice or music: one URL. Available in Wan 2.6 and 2.7. Sound longer than the video is cut to its length.
Type: List (String, uri)Maximum items: 1

`quality`	`aspect_ratio`
`480p`	except `4:3`, `3:4`

Parameters not listed here are not accepted: the response is 422 unknown_setting.

Input

Sound is a URL of an MP3 or WAV file up to 10 MB.

Field	Accepts	Formats	Files	File size up to
`audio`	Audio	mp3, wav	1	10 MB

How to send files

Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

Video from a prompt

JSON

{
  "model": "wan",
  "settings": {
    "mode": "text",
    "model": "2_5",
    "prompt": "Кот играет с клубком на солнечном подоконнике, камера медленно приближается",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": "5s"
  }
}

The price is calculated when the task is accepted, currency RUB.

Complete generation example

Output

One MP4 video.
Generation usually takes 5 to 10 minutes.

Kind	Formats	How many	Note
`video`	mp4	1

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

How to read the result and download files

From frames

The first frame, or the first and the last one: the model animates them by the prompt. Wan 3.0 needs a frame, the other versions also work without one.

Value of the mode field: frames

This page is about Wan 2.5: send model = 2_5. Without the model field the task runs on 3_0.

Price in this mode from 20 ₽.

Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

promptRequired: What happens in the video: scene, motion, camera, style. Up to 5,000 characters, up to 20,000 for Wan 3.0.
Type: StringMinimum characters: 1Maximum characters: 20000
image_urlsOptional: One URL: the first frame. Two URLs: the first and the last frames.
Type: List (String, uri)Maximum items: 2
modelOptional: Wan version. 3.0, the newest one, has no own sound and no splitting into scenes.
Type: StringAllowed values: 2_5Default: "3_0"
qualityOptional: Video resolution; the set depends on the version. The price per second depends on it.
Type: StringAllowed values: 480p720p1080pDefault: "720p"
aspect_ratioOptional: Frame shape. Wan 2.5 at 480p offers only 16:9, 9:16 and 1:1.
Type: StringAllowed values: 16:99:161:14:33:4The set depends on quality.
Exceptions
quality aspect_ratio
480p except 4:3, 3:4
Default: "16:9"
durationOptional: Video length: 5 or 10 seconds for Wan 2.5, 2 to 15 for 2.6 and 2.7, 2 to 30 for 3.0. The price is per second.
Type: StringAllowed values: 5s10sDefault: "5s"
multi_shotsOptional: Split the video into several scenes. Wan 2.6 and 2.7 only.
Type: BooleanDefault: false
audioOptional: Your own sound for the video, such as a voice or music: one URL. Available in Wan 2.6 and 2.7. Sound longer than the video is cut to its length.
Type: List (String, uri)Maximum items: 1

`quality`	`aspect_ratio`
`480p`	except `4:3`, `3:4`

Parameters not listed here are not accepted: the response is 422 unknown_setting.

Input

Frames are URLs of JPEG, PNG or WebP files up to 10 MB each.
Sound is a URL of an MP3 or WAV file up to 10 MB.

Field	Accepts	Formats	Files	File size up to
`image_urls`	Images	jpeg, jpg, png, webp	2	10 MB
`audio`	Audio	mp3, wav	1	10 MB

How to send files

Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

Animate a frame

JSON

{
  "model": "wan",
  "settings": {
    "mode": "frames",
    "prompt": "Медведь медленно поворачивает голову и улыбается, листья падают",
    "image_urls": [
      "https://example.com/first-frame.jpg"
    ],
    "quality": "720p",
    "duration": "5s",
    "model": "2_5"
  }
}

The price is calculated when the task is accepted, currency RUB.

Complete generation example

Output

One MP4 video.
Generation usually takes 5 to 10 minutes.

Kind	Formats	How many	Note
`video`	mp4	1

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

How to read the result and download files

Try Wan 2.5 through the API

One key opens every CyHUB model. Payment in rubles, and you see the price before the run.

Get an API key

Wan 2.5 API

Connect in three steps

Ready-to-use code

Price before the run

Modes

From a prompt

Parameters

Input

Request example

Output

From frames

Parameters

Input

Request example

Output

See also

Try Wan 2.5 through the API