Wan 2.7 API

Видео Wan 2.7 по описанию, по первому и последнему кадру или по референсам с персонажами, предметами и местами. От 2 до 15 секунд, 720p или 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_7",
    "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_7",
        "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_7",
    "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: от 16 ₽. Точную цену своих настроек покажет POST /v1/price.

Режим	Цена
По описанию	от 16 ₽
По кадрам	от 16 ₽
По референсам с файлом на 1 с	от 24 ₽

Отправьте те же настройки в 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_7",
    "prompt": "Кот играет с клубком на солнечном подоконнике, камера медленно приближается",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": "5s"
  }
}'

amount_minor: цена запуска в копейках (для рублей)
currency: валюта кошелька
available_minor: сколько сейчас доступно на балансе для новых задач

Режимы

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

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

По описанию

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

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

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

Параметры

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

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

Параметры, которых нет в списке, не принимаются: ответ 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_7",
    "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.7: передайте model = 2_7. Без поля model запустится 3_0.

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

Параметры

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

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

Параметры, которых нет в списке, не принимаются: ответ 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",
    "model": "2_7",
    "prompt": "Лев смотрит в камеру и говорит этим голосом",
    "image_urls": [
      "https://example.com/lion.jpg"
    ],
    "audio": [
      "https://example.com/voice.mp3"
    ],
    "duration": "5s"
  }
}

Цена считается при приёме задачи, валюта 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"
      }
    ]
  }
}

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

По референсам

Персонажи, предметы и места с ваших картинок и видео в новом ролике. Версии 2.7 и 3.0.

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

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

Цена в этом режиме от 24 ₽, с файлом на 1 с.

Параметры

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

promptОбязательно: Что происходит в ролике. На вложения ссылайтесь подписями @Image1, @Video1, каждое нужно упомянуть. До 5000 знаков, у 3.0 до 20 000.
Тип: СтрокаМинимум символов: 1Максимум символов: 20000
ref_image_urlsНеобязательно: Картинки с персонажами, предметами или местом, в описании @Image1, @Image2 по порядку ссылок. Картинок и видео вместе до 5, хотя бы одно из них обязательно.
Тип: Список (Строка, uri)Максимум элементов: 5
ref_video_urlsНеобязательно: Видео с персонажем, в описании @Video1, @Video2. Каждое от 1 до 5 секунд, их секунды входят в цену. У 2.7 с видео готовый ролик не длиннее 10 секунд.
Тип: Список (Строка, uri)Максимум элементов: 5
first_frame_urlНеобязательно: Первый кадр ролика, необязательно. С ним пропорции берутся у кадра, и поле aspect_ratio не действует.
Тип: Список (Строка, uri)Максимум элементов: 1
modelНеобязательно: Версия Wan: 2.7 или 3.0.
Тип: СтрокаДопустимые значения: 2_7По умолчанию: "3_0"
qualityНеобязательно: Разрешение ролика, набор зависит от версии. От него зависит цена секунды.
Тип: СтрокаДопустимые значения: 720p1080pПо умолчанию: "720p"
aspect_ratioНеобязательно: Пропорции кадра.
Тип: СтрокаДопустимые значения: 16:99:161:14:33:4Набор зависит от quality.По умолчанию: "16:9"
durationНеобязательно: Длина ролика: у 2.7 от 2 до 15 секунд, а с видео среди вложений до 10; у 3.0 от 2 до 30. Цена за каждую секунду.
Тип: СтрокаДопустимые значения: 2s3s4s5s6s7s8s9s10s11s12s13s14s15sПо умолчанию: "5s"
multi_shotsНеобязательно: Разбить ролик на несколько сцен. Только у 2.7.
Тип: Да/нетПо умолчанию: false

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

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

Каждое вложение нужно упомянуть в описании подписью: @Image1, @Image2, @Video1 и так далее. Номер это место ссылки в поле своего типа. Писать ровно так: с большой буквы, без пробела.
Картинки передаются ссылками на JPEG, PNG или WebP до 10 МБ каждая, видео ссылками на MP4 или MOV до 100 МБ.
Видео уходит в модель целиком, без обрезки, и его секунды входят в цену.

Поле	Что принимает	Форматы	Файлов	Размер файла до
`ref_image_urls`	Картинки	jpeg, jpg, png, webp	5	10 МБ
`ref_video_urls`	Видео	mp4, mov	5	100 МБ
`first_frame_url`	Картинки	jpeg, jpg, png, webp	1	10 МБ

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

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

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

Два персонажа и первый кадр

JSON

{
  "model": "wan",
  "settings": {
    "mode": "reference",
    "model": "2_7",
    "prompt": "@Image1 встречает @Video1 у входа в кафе и машет рукой",
    "ref_image_urls": [
      "https://example.com/hero.png"
    ],
    "ref_video_urls": [
      "https://example.com/friend.mp4"
    ],
    "first_frame_url": [
      "https://example.com/cafe.jpg"
    ],
    "duration": "5s"
  }
}

Цена считается при приёме задачи, валюта 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.7: возможности и цены
Другие версии: Wan 3.0 API, Wan 2.6 API, Wan 2.5 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.7 через API

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

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