Wan 2.5 API

Видео Wan 2.5 по описанию или по первому и последнему кадру: 5 или 10 секунд, от 480p до 1080p.

Разработчик: AlibabaКлюч модели в API: wan

Для нейросети:Скачать .md Вся документация .md Открыть как текст

Подключение в три шага

Получите ключКлюч создаётся в кабинете после подтверждения почты. Один ключ открывает все модели.
Узнайте ценуPOST /v1/price считает стоимость запуска заранее, деньги при этом не списываются.
Запустите задачу и заберите результатPOST /v1/tasks ставит задачу, GET /v1/tasks/{id} показывает её статус и файлы.

Готовый код

Замените YOUR_API_KEY своим ключом. Код ставит задачу и ждёт результата. В cURL второй запрос повторяйте, подставив вместо TASK_ID поле id из ответа первого, пока status не станет 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();

Получить ключ

Цена до запуска

Цены на 15.10.2026: от 20 ₽. Точную цену своих настроек покажет POST /v1/price.

Режим	Цена
По описанию	от 20 ₽
По кадрам	от 20 ₽

Отправьте те же настройки в POST /v1/price: ответ покажет цену запуска, деньги при этом не списываются.

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: цена запуска в копейках (для рублей)
currency: валюта кошелька
available_minor: сколько сейчас доступно на балансе для новых задач

Режимы

У каждого режима свои параметры и примеры. Режим выбирает поле mode.

По описанию mode = text
По кадрам mode = frames

По описанию

Видео только по тексту. Версии 2.5, 2.6 и 2.7, у 3.0 этого режима нет.

Значение поля mode: text

На этой странице версия Wan 2.5: передайте model = 2_5. Без поля model запустится 2_7.

Цена в этом режиме от 20 ₽.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

promptОбязательно: Что происходит в ролике: сцена, движение, камера, стиль. До 5000 знаков.
Тип: СтрокаМинимум символов: 1Максимум символов: 5000
modelНеобязательно: Версия Wan: 2.5, 2.6 или 2.7.
Тип: СтрокаДопустимые значения: 2_5По умолчанию: "2_7"
qualityНеобязательно: Разрешение ролика, набор зависит от версии. От него зависит цена секунды.
Тип: СтрокаДопустимые значения: 480p720p1080pПо умолчанию: "720p"
aspect_ratioНеобязательно: Пропорции кадра. У 2.5 в 480p только 16:9, 9:16 и 1:1.
Тип: СтрокаДопустимые значения: 16:99:161:14:33:4Набор зависит от quality.
Исключения
quality aspect_ratio
480p кроме 4:3, 3:4
По умолчанию: "16:9"
durationНеобязательно: Длина ролика: у 2.5 только 5 или 10 секунд, у 2.6 и 2.7 от 2 до 15. Цена за каждую секунду.
Тип: СтрокаДопустимые значения: 5s10sПо умолчанию: "5s"
multi_shotsНеобязательно: Разбить ролик на несколько сцен. Только у 2.6 и 2.7.
Тип: Да/нетПо умолчанию: false
audioНеобязательно: Свой звук для ролика, например голос или музыка: одна ссылка. Есть у 2.6 и 2.7. Звук длиннее ролика обрезается по его длине.
Тип: Список (Строка, uri)Максимум элементов: 1

`quality`	`aspect_ratio`
`480p`	кроме `4:3`, `3:4`

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Входные данные

Звук передаётся ссылкой на MP3 или WAV до 10 МБ.

Поле	Что принимает	Форматы	Файлов	Размер файла до
`audio`	Аудио	mp3, wav	1	10 МБ

Как передать файлы

Пример запроса

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Видео по описанию

JSON

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

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Одно видео MP4.
Генерация обычно занимает от 5 до 10 минут.

Вид (kind)	Форматы	Сколько	Пояснение
`video`	mp4	1

Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "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"
      }
    ]
  }
}

Как читать результат и скачивать файлы

По кадрам

Первый кадр или первый и последний: модель оживляет их по описанию. У 3.0 кадр обязателен, у остальных версий можно и без него.

Значение поля mode: frames

На этой странице версия Wan 2.5: передайте model = 2_5. Без поля model запустится 3_0.

Цена в этом режиме от 20 ₽.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

promptОбязательно: Что происходит в ролике: сцена, движение, камера, стиль. До 5000 знаков, у 3.0 до 20 000.
Тип: СтрокаМинимум символов: 1Максимум символов: 20000
image_urlsНеобязательно: Одна ссылка: первый кадр. Две ссылки: первый и последний кадры.
Тип: Список (Строка, uri)Максимум элементов: 2
modelНеобязательно: Версия Wan. У 3.0, самой новой, нет своего звука и деления на сцены.
Тип: СтрокаДопустимые значения: 2_5По умолчанию: "3_0"
qualityНеобязательно: Разрешение ролика, набор зависит от версии. От него зависит цена секунды.
Тип: СтрокаДопустимые значения: 480p720p1080pПо умолчанию: "720p"
aspect_ratioНеобязательно: Пропорции кадра. У 2.5 в 480p только 16:9, 9:16 и 1:1.
Тип: СтрокаДопустимые значения: 16:99:161:14:33:4Набор зависит от quality.
Исключения
quality aspect_ratio
480p кроме 4:3, 3:4
По умолчанию: "16:9"
durationНеобязательно: Длина ролика: у 2.5 только 5 или 10 секунд, у 2.6 и 2.7 от 2 до 15, у 3.0 от 2 до 30. Цена за каждую секунду.
Тип: СтрокаДопустимые значения: 5s10sПо умолчанию: "5s"
multi_shotsНеобязательно: Разбить ролик на несколько сцен. Только у 2.6 и 2.7.
Тип: Да/нетПо умолчанию: false
audioНеобязательно: Свой звук для ролика, например голос или музыка: одна ссылка. Есть у 2.6 и 2.7. Звук длиннее ролика обрезается по его длине.
Тип: Список (Строка, uri)Максимум элементов: 1

`quality`	`aspect_ratio`
`480p`	кроме `4:3`, `3:4`

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Входные данные

Кадры передаются ссылками на JPEG, PNG или WebP до 10 МБ каждый.
Звук передаётся ссылкой на MP3 или WAV до 10 МБ.

Поле	Что принимает	Форматы	Файлов	Размер файла до
`image_urls`	Картинки	jpeg, jpg, png, webp	2	10 МБ
`audio`	Аудио	mp3, wav	1	10 МБ

Как передать файлы

Пример запроса

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Оживить кадр

JSON

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

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Одно видео MP4.
Генерация обычно занимает от 5 до 10 минут.

Вид (kind)	Форматы	Сколько	Пояснение
`video`	mp4	1

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "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"
      }
    ]
  }
}

Как читать результат и скачивать файлы

Смотрите также

Нейросеть Wan 2.5: возможности и цены
Другие версии: Wan 3.0 API, Wan 2.7 API, Wan 2.6 API
Похожие модели: Seedance 2.5 API, Kling 3.0 API, Kling Motion 3.0 API, Veo 3.1 API, MiniMax H3 (Hailuo 03) API, Gemini Omni API
Документация API
Ошибки API и что с ними делать

Попробуйте Wan 2.5 через API

Один ключ открывает все модели CyHUB. Оплата в рублях, цену видно до запуска.

Получить ключ API