Wan 3.0

Wan 3.0 поддерживает текст, изображения и референсные медиа с результатом в 480p, 720p или 1080p. Этот эндпоинт предназначен для стандартной модели; выбор 1080p не переключает её на Pro. Подробнее о модели и Playground.

Подключение к Wan APIКопировать ссылку на заголовок

Используйте https://api.wanapi.app как базовый URL API. Создайте ключ в настройках ключей API и передавайте его в заголовке Authorization: Bearer YOUR_API_KEY. Храните ключи на сервере. Playground использует вашу сессию на сайте и списывает средства с того же баланса; вставлять ключ в браузер не требуется.

Для доступа нужна активная учётная запись с достаточным балансом. Актуальные тарифы приведены на странице цен. У каждой модели свой эндпоинт и страница.

GET /v1/models возвращает модели, доступные вашему ключу. Выбор более высокого разрешения не меняет модель автоматически.

Общие поля запроса описывают все 14 нативных полей, ограничения медиа и сочетания входных данных. Эта модель использует wan3.0-video в URL нативных запросов и в поле model запросов Responses.

Создание задачи Wan 3.0Копировать ссылку на заголовок

Это запрос генерации двухсекундного видео по тексту в минимальном разрешении модели. Задайте ваш ключ в WAN_API_KEY на сервере. Модель определяется URL; не добавляйте поле model в тело этого нативного JSON-запроса.

curl https://api.wanapi.app/wan/v1/wan3.0-video/generation \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A blue ball rolls across a white table. Static camera.",
    "duration": 2,
    "resolution": "480p",
    "ratio": "16:9",
    "audio": false,
    "prompt_extend": false
  }'

Проверка задачи Wan 3.0Копировать ссылку на заголовок

Сохраните полученный task_info.id как TASK_ID, затем опрашивайте эндпоинт той же модели. Ответ на отправку подтверждает создание задачи, но не содержит готового видео. Начните с интервала в пять секунд; см. статусы задач и скачивание.

curl "https://api.wanapi.app/wan/v1/wan3.0-video/generation/$TASK_ID" \
  -H "Authorization: Bearer $WAN_API_KEY"

Цены Wan 3.0Копировать ссылку на заголовок

В таблице указаны текущие тарифы в USD за оплачиваемую секунду. Учитываются и секунды входного референсного видео, и секунды результата. Пример на пять секунд предполагает отсутствие референсного видео. О резервировании и окончательном списании см. оплату и обработку ошибок.

Посмотреть цены Wan 3.0.

Поля запросаКопировать ссылку на заголовок

Все четыре модели используют эти 14 нативных полей генерации и дополнительный параметр nsfw_checker. Укажите промпт или хотя бы один медиаисточник. Кадры нельзя сочетать с референсами, file или link; file и link взаимоисключающие.

В Playground и API для Wan 3.0 и Wan 3.0 Prime по умолчанию используется nsfw_checker: true. Существующим клиентам не нужно добавлять параметр. Варианты Pro поддерживают только false; значение по умолчанию — false. Проверки контента Playground действуют при любом значении. Изменение параметра меняет тариф; проверьте текущую цену выбранного значения. Недоступный вариант возвращает ошибку, а не переключается на другой.

Используйте стабильные прямые URL медиа, доступные до завершения задачи. Проверка длительности видео выполняет ограниченные HTTP range-запросы; видеосервер должен поддерживать их и предоставлять читаемые метаданные длительности MP4/MOV. При проверке длительности перенаправления не обрабатываются. URL частных сетей не поддерживаются. Суммарная длительность референсов и результата не должна превышать 30 секунд. Playground принимает JSON до 32 MiB; для более крупных входных данных используйте URL.

Фильтрация контента и ошибки проверкиКопировать ссылку на заголовок

nsfw_checker выбирает уровень проверки контента для Wan 3.0 и Wan 3.0 Prime:

• true (по умолчанию, в том числе при отсутствии параметра): строгая фильтрация контента.
• false: менее строгая фильтрация. Применяется другой посекундный тариф; проверьте текущую таблицу цен.

Если запрос явно отклонён проверкой контента или сохранённая задача получила статус failed с ошибкой политики контента, задайте для nsfw_checker значение false в новом запросе для менее строгой проверки. Сохраните тот же публичный ID модели и другие поддерживаемые параметры. Например, добавьте это поле в тело нативного запроса или JSON для /v1/responses:

{
  "nsfw_checker": false
}

Это фрагмент запроса, а не полный запрос генерации. Менее строгая проверка не гарантирует принятие; проверки контента Playground по-прежнему действуют. Этот параметр не устраняет ошибки параметров, недостаточный баланс и другие ошибки, не связанные с проверкой. При тайм-ауте отправки или неизвестном результате сначала получите существующую задачу; не отправляйте новую платную генерацию автоматически.

Варианты Pro поддерживают только false и по умолчанию используют false. Исторические задачи сохраняют исходное значение для получения статуса и расчётов.

content_filter по-прежнему принимается как устаревший псевдоним nsfw_checker. В новых интеграциях используйте nsfw_checker. При передаче обоих полей их логические значения должны совпадать; противоречащие значения отклоняются.

Опрос статуса и скачивание видеоКопировать ссылку на заголовок

Эндпоинт отправки каждой модели возвращает публичный ID задачи. Сначала сохраните его.

{
  "task_info": {
    "id": "task_EXAMPLE",
    "status": "pending"
  }
}

Используйте пример проверки из раздела нужной модели. Начните с интервала в пять секунд и увеличивайте задержку после временных ошибок. Храните ID модели вместе с ID задачи; не запрашивайте её через эндпоинт другой модели.

Нативные статусы: pending, processing, completed и failed. Ответ завершённой задачи содержит videos — массив с полным подписанным URL Bunny CDN.

{
  "task_info": { "id": "task_EXAMPLE", "status": "completed" },
  "videos": ["https://reapiflexible.b-cdn.net/flexible/v1/expires/2026-11/20261113T06/wanapi-task_EXAMPLE/video.mp4?token=HS256_SIGNATURE&expires=1794550071"]
}

Используйте полученный URL непосредственно для просмотра или скачивания; ключ API и заголовок Authorization для него не нужны. К файлам применяется действующая политика хранения. Проверка задачи не создаёт новое видео, не списывает средства повторно и не продлевает доступность файлов. Сохраняйте нужные файлы в собственное хранилище. Для проверки задач нужен ключ API; возвращаются только задачи вашей учётной записи.

Синхронные и фоновые ResponsesКопировать ссылку на заголовок

Для клиентов Responses API эндпоинт POST /v1/responses принимает ID модели, строку input и те же нативные поля генерации. Используйте input вместо prompt. Нативные медиа-поля, например reference_images, остаются на верхнем уровне.

{
  "model": "wan3.0-video",
  "input": "A blue ball rolls across a white table.",
  "resolution": "480p",
  "duration": 2,
  "background": true
}

При background: true сохраните ID ответа и опрашивайте GET /v1/responses/{response_id}. Без background HTTP-запрос ожидает завершения. stream: true использует server-sent events во время ожидания. Итоговый ответ ассистента содержит подписанный URL видео; считайте его конфиденциальной ссылкой доступа и не публикуйте случайно. Для длительных генераций и прокси с короткими тайм-аутами рекомендуется нативная отправка задач или фоновые Responses.

Разрыв соединения или тайм-аут синхронного запроса не отменяет генерацию. Задача остаётся на сервере. Не отправляйте ту же генерацию повторно автоматически.

Оплата и обработка ошибокКопировать ссылку на заголовок

Стоимость равна тарифу разрешения модели, умноженному на оплачиваемые секунды. Учитываются секунды референсного видео и результата; текст, изображения и аудио не добавляют видеосекунд. Для фиксированной длительности без референсного видео резервируется запрошенная длительность результата. Для автоматической длительности и запросов с референсным видео резервируется до 30 оплачиваемых секунд, затем списание рассчитывается по фактическому использованию, а остаток резерва возвращается. При ошибке генерации резерв освобождается. Опрос статуса не создаёт новую генерацию и не приводит к повторному списанию.

• Неверные параметры: исправьте запрос перед повторной отправкой. Неизвестные нативные поля отклоняются.
• Недостаточный баланс: пополните баланс перед новым платным запросом. Лимит ключа не добавляет средств на счёт.
• Ограничение частоты или временная ошибка опроса: повторяйте только запрос статуса, увеличивая задержку и ограничив время ожидания.
• Тайм-аут отправки, разрыв сети или отсутствие ID задачи: результат может быть неизвестен. Не повторяйте POST автоматически: это может создать вторую платную задачу.
• Ошибка задачи: показывайте неудачное завершение отдельно от недоступности запроса статуса.
• Ошибка скачивания: сначала повторите скачивание существующей завершённой задачи, прежде чем создавать новую генерацию.

Запросы генерации не повторяются автоматически и не переключаются на другую модель. Заявленного контракта отмены, вебхуков или ключей идемпотентности нет. Сохраните ID задачи и обратитесь в поддержку, если нужно выяснить результат неопределённой отправки.