Wan API

Восемь видеомоделей — один ключ

Четыре варианта Wan — 3.0, 3.0 Prime, 3.0 Pro и 3.0 Prime Pro — стоят рядом с Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast и Seedance 2.0 Mini на одной платформе. GET /v1/models показывает, что доступно текущему ключу; у каждой модели свой задокументированный идентификатор, например wan3.0-video или w3.0-video-prime-pro.

Мультимодальные входы

Запрос может содержать только текстовый промпт, первый или последний кадр либо набор референсов: до 10 изображений, 5 видеороликов и 5 аудиозаписей, плюс документ или публичная веб-страница. Режимы ключевых кадров и референсов не смешиваются в одном запросе, промпт ограничен 20 000 символов.

Playground с предпросмотром нативного запроса

На каждой странице модели встроен Playground, который собирает плоское нативное тело запроса, не записывает пустые необязательные поля и проверяет доступность генерации до отправки. Он работает через сессию сайта и тот же предоплаченный баланс, поэтому ключ не нужно вставлять в браузер.

Асинхронный API задач

Отправка на эндпоинт модели сразу возвращает публичный ID задачи; статусы — pending, processing, completed, failed, а в готовом ответе лежит подписанная ссылка Bunny CDN, для воспроизведения и скачивания которой не нужен заголовок Authorization. POST /v1/responses поддерживает синхронное ожидание, фоновый режим и server-sent events.

Уровень модерации влияет на тариф

Необязательное поле nsfw_checker выбирает строгую или более мягкую проверку контента для Wan 3.0 и Wan 3.0 Prime, и у каждой настройки своя цена за секунду. Варианты Pro принимают только false. Отклонённую модерацией отправку можно повторить с другим значением, сохранив тот же публичный ID модели.

Баланс и удаление задач

GET /v1/balance возвращает доступный баланс аккаунта и остаток лимита самого ключа. DELETE /v1/tasks/{task_id} удаляет одну завершённую задачу вместе с сохранёнными видео и последним кадром. Тексты сайта дополнительно опубликованы в машиночитаемом виде по адресам /llms.txt и /llms-full.txt.

• E-commerce и продуктовые команды: превратить статичный снимок товара в медленный облёт или наезд камеры, проверить форму, блики и надписи, и только потом брать клип в кампанию.
• Сценаристы, сториборд и соцсети: когда нет ни съёмки, ни ключевых артов, собрать текстовую сцену в видеопревью и по короткому клипу оценить свет, движение камеры и темп.
• Агентства, работающие по брифу: подать ёмкий документ или публичную страницу, чтобы письменная идея стала визуальной отправной точкой для одной аудитории и одного сообщения.
• Инженерные команды, интегрирующие видео: сравнить тарифы, длительность и лимиты референсов Wan и Seedance рядом, а выбранную модель держать под тем же ключом и балансом.
• Персонажная работа по референсам: назначить каждому загруженному файлу роль — внешность, движение, звук — чтобы в длинных сценах Seedance 2.5 персонажи и локации оставались различимыми.

Это официальный сервис Alibaba или ByteDance?

Нет. Wan API работает независимо на wanapi.app и не связана с Alibaba, Wan или ByteDance, и они её не одобряли; эти названия лишь обозначают сторонние модели, а товарные знаки принадлежат их владельцам.

Нужна подписка для генерации?

Месячный видео-пакет не предлагается. Доступ зависит от активного аккаунта с балансом, а цена — это тариф разрешения, умноженный на billable seconds.

Какие секунды оплачиваются?

Секунды референсного видео плюс секунды результата. Текст, изображения и аудио секунд не добавляют, а отключение генерируемого звука не снижает тариф.

Можно отменить задачу или автоматически повторить?

Отмена, webhook и idempotency-ключ не заявлены, автоповтор и переключение модели при отправке не делаются. После таймаута или потери ID сначала запросите существующую задачу: повторный POST может создать вторую платную.

Сколько доступны готовые видео?

Завершённая задача отдаёт подписанную CDN-ссылку без ключа, но файлы живут по политике хранения платформы. Опрос срок не продлевает — важное копируйте к себе.

Какую модель выбрать для первого теста?

Wan 3.0 покрывает 480p–1080p по наименьшей ставке; Prime — отдельная модель с другим прайсом; 2K и 4K есть только у Pro-вариантов. У Seedance свои лимиты по длительности и референсам, поэтому отталкивайтесь от требований к материалу и не предполагайте высокое разрешение у дешёвой модели.

Можно переиспользовать тело запроса между моделями?

Четыре модели Wan делят 14 нативных полей, но значения разрешений, ID модели и поддержка nsfw_checker различаются: Pro-варианты принимают только мягкое значение. Неизвестные поля отклоняются, так что сначала сверьтесь со страницей модели.

• Войдите в wanapi.app через Google и пополните баланс в настройках аккаунта: одного сайта-аккаунта для генерации недостаточно.
• Создайте ключ в разделе API key settings и держите его только на сервере; Playground работает через сессию сайта и тот же баланс.
• Выберите модель в обзоре или через GET /v1/models, затем на её странице проверьте доступные разрешения, диапазон длительности и лимиты референсов.
• Соберите запрос в Playground этой модели и скопируйте показанное нативное тело либо соберите JSON вручную по задокументированному ID модели.
• Отправив запрос, сразу сохраните ID задачи и начните опрос с интервала в пять секунд, увеличивая его при временных ошибках.
• Воспроизведите или скачайте файл по подписанной URL из готового ответа и скопируйте его в своё хранилище до истечения срока хранения.