Wan 2.5 API
Alibaba Wan 2.5 — text-to-video и image-to-video до 1080p с синхронизированным звуком, а также video-extend, image-edit и text-to-image в том же семействе, с вариантами Fast для видео-конечных точек.
Это руководство по Wan 2.5 API описывает работающие конечные точки в WaveSpeedAI: text-to-video, image-to-video и video-extend с вариантами Fast, image-edit и text-to-image. Playground, примеры, цены и образцы API ниже используют работающие конечные точки Wan 2.5.
Обзор
О модели Wan 2.5 API
Что делает Wan 2.5, какое место занимает в линейке моделей Alibaba и почему её выбирают команды.
Wan 2.5 — модель генерации видео от Alibaba, доступная через REST API WaveSpeedAI. Alibaba Wan 2.5 — text-to-video и image-to-video до 1080p с синхронизированным звуком, а также video-extend, image-edit и text-to-image в том же семействе, с вариантами Fast для видео-конечных точек.
Это руководство по Wan 2.5 API описывает работающие конечные точки в WaveSpeedAI: text-to-video, image-to-video и video-extend с вариантами Fast, image-edit и text-to-image. Playground, примеры, цены и образцы API ниже используют работающие конечные точки Wan 2.5.
Семейство Wan 2.5 в WaveSpeedAI включает 8 REST-эндпоинтов для сценариев: Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video. У каждого варианта свои цены, параметры и примеры результатов — выберите тот, что подходит под ваш тип входных данных и требования продакшена, или вызывайте несколько с одним API-ключом и собирайте многошаговые пайплайны.
Запускайте Wan 2.5 с тем же API-ключом, платёжным аккаунтом и лимитами, что и остальные 1000+ ИИ-моделей WaveSpeedAI. Без отдельной регистрации у вендора, без SDK для каждого провайдера, без разных лимитов у каждого поставщика — одна интеграция охватывает всё: от текста в изображение и текста в видео до синтеза аудио, 3D-генерации, апскейлинга и редактирования.
Характеристики
Возможности Wan 2.5 API и статус релиза
То, что разработчики ищут перед выбором API: доступность, ожидаемая длина результата, поддержка референсов и текущая рабочая альтернатива.
Доступность
Уже доступно
Конечные точки Wan 2.5 работают в каталоге WaveSpeedAI: text-to-video, image-to-video и video-extend (каждая с вариантом Fast), image-edit и text-to-image — всё в одном REST-процессе предсказаний.
Разрешения
480p, 720p, 1080p
Видео доступно в 480p, 720p и 1080p в зависимости от конечной точки; text-to-video предлагает горизонтальные и вертикальные размеры для каждого из них.
Длительность
От 3 до 10 секунд
Text-to-video создаёт клипы на 5 или 10 секунд; image-to-video Fast и video-extend — от 3 до 10 секунд.
Звук
Синхронизированный звук
Видео-конечные точки создают звук, синхронизированный с картинкой, а необязательный аудиофайл (WAV или MP3, не короче 3 секунд, до 15 MB) может направлять генерацию.
Варианты Fast
Текст, изображение и продление
Wan 2.5 Fast доступен для text-to-video, image-to-video и video-extend и позиционируется как более быстрая и доступная генерация.
Инструменты для изображений
Редактирование и text-to-image
image-edit принимает до двух входных изображений с промптом, а text-to-image создаёт статичные изображения в том же семействе, что и видео-конечные точки.
Эндпоинты
Все эндпоинты API Wan 2.5
Сейчас в WaveSpeedAI доступно эндпоинтов Wan 2.5: 8 — выберите вариант под ваш сценарий.
/filters:quality(82)/media/images/20260408104220_jymu91ex.webp)
Wan 2.5 Image Edit
Refine existing visuals with WAN 2.5 image-edit using prompt-driven adjustments and stylistic upgrades for photos and graphics. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104211_97h9m7p7.webp)
Wan 2.5 Text To Image
WAN 2.5 Text-to-Image turns text prompts into AI-generated images with the WAN 2.5 model for on-demand image creation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104203_64hpvi1b.webp)
Wan 2.5 Video Extend Fast
WAN 2.5 Fast is an AI-powered video extender that turns short clips into longer videos while preserving audio tracks for seamless extensions. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104158_jzbs7q2h.webp)
Wan 2.5 Video Extend
WAN 2.5 Video-Extend turns short clips into longer videos with preserved or generated synchronized audio for continuity. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104214_334vajy7.webp)
Wan 2.5 Text To Video
WAN 2.5 makes 480p-1080p text/image-to-video with synced audio and is faster, more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104222_y5iz96kb.webp)
Wan 2.5 Text To Video Fast
WAN 2.5 Fast creates synchronized-audio videos from text or images in 720p, faster and more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104205_99s4gqxu.webp)
Wan 2.5 Image To Video Fast
WAN 2.5 Fast converts text or images into synchronized-audio videos in 480p, 720p, or 1080p, offering faster, more affordable generation compared to Google Veo3. REST API, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104159_4c1hr4ym.webp)
Wan 2.5 Image To Video
WAN 2.5 converts text or images into videos (480p/720p/1080p) with synced audio, faster and more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Примеры
Wan 2.5 в деле
Реальные результаты, созданные через API Wan 2.5. Наведите курсор на видео для предпросмотра, нажмите, чтобы открыть в полном размере.
Как использовать
Как использовать API Wan 2.5
Четыре шага от регистрации до готовой генерации. Полные примеры на Python, Node.js и cURL — в разделе API ниже.
- 01
Получите API-ключ
Создайте аккаунт WaveSpeedAI и скопируйте API-ключ на панели управления. Новые аккаунты получают бесплатные стартовые кредиты — их хватит, чтобы несколько десятков раз запустить playground до начала списаний.
- 02
Отправьте предсказание
Отправьте входные данные в формате JSON методом POST на https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video. Эндпоинт сразу возвращает id предсказания — генерация асинхронная, поэтому соединение не нужно держать открытым на время инференса.
- 03
Опрашивайте до завершения
Выполняйте GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. При статусе completed забирайте результат; при failed, cancelled, timeout или deleted остановитесь с ошибкой; при любом другом статусе продолжайте опрос.
- 04
Получите URL результата
Когда статус станет "completed", возьмите URL из data.outputs[0]. Он указывает на созданный файл в CDN WaveSpeedAI — изображение, видео, аудио или 3D-файл, в зависимости от вызванного варианта Wan 2.5.
Сценарии применения
Что можно создать с Wan 2.5
Типичные сценарии, для которых разработчики и авторы используют API Wan 2.5.
Text-to-video с синхронизированным звуком
alibaba/wan-2.5/text-to-video превращает промпт в клип на 5 или 10 секунд до 1080p со звуком, сгенерированным вместе с картинкой.
Image-to-video из статичного изображения
alibaba/wan-2.5/image-to-video и вариант Fast оживляют референсное изображение по промпту, в 720p или 1080p и от 3 до 10 секунд на конечной точке Fast.
Продление клипа
alibaba/wan-2.5/video-extend продолжает существующее видео с сохранённым или сгенерированным синхронизированным звуком, в 480p, 720p или 1080p, а вариант Fast делает то же дешевле.
Управление клипом собственным звуком
Передайте аудиофайл в видео-конечные точки, чтобы направить генерацию, например реплику или ритм, за которым должно следовать движение.
Редактирование изображений в том же семействе
alibaba/wan-2.5/image-edit применяет правки по промпту к одному или двум изображениям, так что статичные изображения и клипы создаются одним семейством моделей.
Статичные изображения через text-to-image
alibaba/wan-2.5/text-to-image создаёт изображения по промпту с размером в пикселях до 2880.
Советы
Советы по написанию запросов для Wan 2.5
Практические советы, как получать лучшие результаты от Wan 2.5, — на основе приёмов, которые работают в продакшен-пайплайнах для моделей видео.
- 01
Прототипируйте на Fast, сдавайте на стандартной точке
Используйте варианты Fast, чтобы проверять промпты и движение, затем запускайте стандартную конечную точку для итогового клипа.
- 02
Выбирайте размер под площадку
Text-to-video предлагает горизонтальные и вертикальные размеры в 480p, 720p и 1080p, поэтому до генерации выберите размер под то место, где клип будет воспроизводиться.
- 03
Направляйте тайминг звуком
Короткий WAV или MP3 длиной не менее 3 секунд может направлять генерацию — это помогает, когда движение должно следовать за репликой или ритмом.
- 04
Продлевайте небольшими шагами
В video-extend продолжайте клип по несколько секунд и описывайте, что происходит дальше, чтобы каждый шаг сохранял непрерывность сцены и звука.
Цены
Цены на API Wan 2.5
Оплата — за каждый результат. Итоговая стоимость зависит от параметров, заданных в playground каждого варианта (разрешение, длительность, количество результатов, референсы).
| Эндпоинт | Тип | Цена от |
|---|---|---|
| alibaba/ | image-to-image | $0.035 |
| alibaba/ | text-to-image | $0.03 |
| alibaba/ | video-extend | $0.068 |
| alibaba/ | video-extend | $0.10 |
| alibaba/ | text-to-video | $0.10 |
| alibaba/ | text-to-video | $0.068 |
| alibaba/ | image-to-video | $0.068 |
| alibaba/ | image-to-video | $0.10 |
API
Вызов API Wan 2.5
Получите API-ключ на wavespeed.ai/accesskey, затем отправьте предсказание через REST. Playground генерирует готовые к вставке примеры для любой комбинации входных данных.
POSThttps://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": false
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": false
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": False
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Сравнение
Wan 2.5 и альтернативы
Когда стоит выбрать Wan 2.5, а не похожие модели в WaveSpeedAI.
Wan 2.5 и Wan 2.7
Wan 2.7 — более новое поколение с reference-to-video, video-edit и выводом 1080p на большем числе конечных точек. Wan 2.5 остаётся вариантом с Fast и синхронизированным звуком.
Wan 2.5 и Veo 3.1
Каталог позиционирует Wan 2.5 как более быстрый и доступный, чем Google Veo 3, с генерацией по аудио и video-extend. Veo 3.1 предлагает уровни Standard, Fast и Lite в 1080p.
Wan 2.5 и Kling 2.6
Kling 2.6 добавляет motion control и конечную точку create-voice. Wan 2.5 охватывает 480p–1080p с синхронизированным звуком, video-extend, image-edit и text-to-image в одном семействе.
FAQ
Wan 2.5 API — часто задаваемые вопросы
Цены, лицензия, интеграция — частые вопросы о запуске Wan 2.5 в WaveSpeedAI.
Какие разрешения поддерживает Wan 2.5?
Видео-конечные точки выдают 480p, 720p и 1080p в зависимости от конечной точки. Text-to-video также предлагает вертикальные размеры, а image-to-video Fast выдаёт 720p или 1080p.
Создаёт ли Wan 2.5 звук?
Да. Видео-конечные точки создают звук, синхронизированный с картинкой, а необязательный аудиофайл можно отправить, чтобы направить результат.
Что такое Wan 2.5 Fast?
Это варианты Fast для text-to-video, image-to-video и video-extend, позиционируемые как более быстрая и доступная генерация, чем у стандартных вариантов.
Можно ли продлить существующее видео в Wan 2.5?
Да. Конечная точка video-extend продолжает короткий клип до более длинного, с сохранённым или сгенерированным синхронизированным звуком, и имеет вариант Fast.
Что такое API Wan 2.5?
Wan 2.5 — модель генерации видео от Alibaba, доступная как REST API в WaveSpeedAI. Alibaba Wan 2.5 — text-to-video и image-to-video до 1080p с синхронизированным звуком, а также video-extend, image-edit и text-to-image в том же семействе, с вариантами Fast для видео-конечных точек. Её можно вызывать программно или попробовать в playground по ссылке выше.
Как вызывать API Wan 2.5?
Создайте аккаунт WaveSpeedAI, скопируйте API-ключ на странице /accesskey и отправьте POST на https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video с входными данными в JSON. Эндпоинт вернёт id предсказания. Опрашивайте эндпоинт результата примерно раз в 2 секунды, для долгих задач увеличивайте интервал и останавливайтесь на любом финальном статусе. Примеры для продакшена на Python / Node.js / cURL — выше.
Сколько стоит API Wan 2.5?
Wan 2.5 стоит от $0.03 за запуск. Точная стоимость зависит от заданных параметров (разрешение, длительность, количество результатов, референсы). Предпросмотр стоимости рядом с кнопкой «Сгенерировать» в playground показывает точную цену для ваших текущих данных.
Какие варианты Wan 2.5 доступны?
В WaveSpeedAI доступно рабочих эндпоинтов Wan 2.5: 8 — alibaba/wan-2.5/image-edit, alibaba/wan-2.5/text-to-image, alibaba/wan-2.5/video-extend-fast, alibaba/wan-2.5/video-extend, alibaba/wan-2.5/text-to-video, alibaba/wan-2.5/text-to-video-fast, alibaba/wan-2.5/image-to-video-fast, alibaba/wan-2.5/image-to-video. У каждого варианта своя страница playground и свои цены.
Можно ли использовать результаты Wan 2.5 в коммерческих целях?
Права на коммерческое использование определяются лицензией модели Alibaba. Большинство моделей Alibaba разрешают коммерческое использование результатов; краткое описание лицензии смотрите на странице playground каждой модели, а условия платформы — в Условиях использования WaveSpeedAI.
Зачем использовать Wan 2.5 в WaveSpeedAI, а не напрямую?
Один API-ключ и один платёжный аккаунт для Wan 2.5 И для 1000+ других ИИ-моделей от разных провайдеров. Без настройки SDK для каждого вендора, без отдельных лимитов, без переписывания интеграционного кода под каждого поставщика. Цены, как правило, на уровне прямого API Alibaba или ниже.
Разработчик
О Alibaba
Команда, стоящая за Wan 2.5 и всей линейкой моделей Alibaba в WaveSpeedAI.
Лаборатория Tongyi Lab компании Alibaba выпускает семейство видеомоделей Wan и семейство LLM Qwen. Wan известна открытыми весами, широким набором вариантов (text-to-video, image-to-video, reference-to-video, video-edit, video-extend, image-edit, text-to-image) и стабильно сильными показателями по устойчивости движения и следованию промпту в многоязычных запросах.
Начните создавать с Wan 2.5 в WaveSpeedAI
Бесплатные стартовые кредиты при регистрации. Один API-ключ для 1000+ ИИ-моделей от Alibaba и всех остальных провайдеров.