# Wan 3.0 Prime Pro (https://wanapi.app/ru/docs/wan-3-0-prime-pro) Wan 3.0 Prime Pro использует отдельный ID модели и тарифы, поддерживая разрешения 1080p, 2K и 4K. Принимает текст, изображения и референсные медиа. Эндпоинт отличается от Prime; запрос 4K через эндпоинт Prime не выбирает Prime Pro. [Подробнее о модели и Playground](/ru/models/wan-3-0-prime-pro). ## Подключение к Wan API [#подключение-к-wan-api] Используйте `https://api.wanapi.app` как базовый URL API. Создайте ключ в [настройках ключей API](/ru/settings/apikeys) и передавайте его в заголовке `Authorization: Bearer YOUR_API_KEY`. Храните ключи на сервере. Playground использует вашу сессию на сайте и списывает средства с того же баланса; вставлять ключ в браузер не требуется. Для доступа нужна активная учётная запись с достаточным балансом. Актуальные тарифы приведены на странице [цен](/ru/pricing). У каждой модели свой эндпоинт и [страница](/ru/models). `GET /v1/models` возвращает модели, доступные вашему ключу. Выбор более высокого разрешения не меняет модель автоматически. | Параметр | Wan 3.0 Prime Pro | | ------------ | ----------------------------------------------------------------------------------- | | ID модели | `w3.0-video-prime-pro` | | `resolution` | `1080p`, `2k`, `4k`; по умолчанию: `1080p`. | | `duration` | 2–30 секунд результата или `-1` для автоматической длительности; по умолчанию: `5`. | | `ratio` | `adaptive`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`; по умолчанию: `adaptive`. | | `audio` | По умолчанию `true`. `false` не снижает тариф. | [Общие поля запроса](#поля-запроса) описывают все 14 нативных полей, ограничения медиа и сочетания входных данных. Эта модель использует `w3.0-video-prime-pro` в URL нативных запросов и в поле `model` [запросов Responses](#синхронные-и-фоновые-responses). ## Создание задачи Wan 3.0 Prime Pro [#создание-задачи-wan-30-prime-pro] Это запрос генерации двухсекундного видео по тексту в минимальном разрешении модели. Задайте ваш ключ в `WAN_API_KEY` на сервере. Модель определяется URL; не добавляйте поле `model` в тело этого нативного JSON-запроса. ```bash curl https://api.wanapi.app/wan/v1/w3.0-video-prime-pro/generation \ -H "Authorization: Bearer $WAN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "prompt": "A camera glides past sunlit coastal cliffs above a calm sea.", "duration": 2, "resolution": "1080p", "ratio": "16:9", "audio": false, "prompt_extend": false }' ``` ## Проверка задачи Wan 3.0 Prime Pro [#проверка-задачи-wan-30-prime-pro] Сохраните полученный `task_info.id` как `TASK_ID`, затем опрашивайте эндпоинт той же модели. Ответ на отправку подтверждает создание задачи, но не содержит готового видео. Начните с интервала в пять секунд; см. [статусы задач и скачивание](#опрос-статуса-и-скачивание-видео). ```bash curl "https://api.wanapi.app/wan/v1/w3.0-video-prime-pro/generation/$TASK_ID" \ -H "Authorization: Bearer $WAN_API_KEY" ``` ## Цены Wan 3.0 Prime Pro [#цены-wan-30-prime-pro] В таблице указаны текущие тарифы в USD за оплачиваемую секунду. Учитываются и секунды входного референсного видео, и секунды результата. Пример на пять секунд предполагает отсутствие референсного видео. О резервировании и окончательном списании см. [оплату и обработку ошибок](#оплата-и-обработка-ошибок). [Посмотреть цены Wan 3.0 Prime Pro](/ru/models/wan-3-0-prime-pro#pricing). ## Поля запроса [#поля-запроса] Все четыре модели используют эти 14 нативных полей генерации и дополнительный параметр `nsfw_checker`. Укажите промпт или хотя бы один медиаисточник. Кадры нельзя сочетать с референсами, `file` или `link`; `file` и `link` взаимоисключающие. | Поле | Тип | Условия | | ------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------- | | `prompt` | string | До 20,000 символов. | | `first_frame` | string | Публичный HTTP(S) URL изображения в вашем хранилище. Base64 и data URI отклоняются. | | `last_frame` | string | Публичный HTTP(S) URL изображения в вашем хранилище. Base64 и data URI отклоняются. | | `reference_images` | string\[] | До 10 изображений в том же формате, что и кадры. | | `reference_videos` | string\[] | До 5 публичных URL MP4/MOV; 1–15 секунд на ролик и не более 15 секунд референсов суммарно. | | `reference_audios` | string\[] | До 5 HTTP(S) URL аудио. | | `file` | string | Публичный URL документа. | | `link` | string | Публичный URL веб-страницы. | | `resolution` | string | См. таблицу модели. По умолчанию: `1080p`. | | `ratio` | string | `adaptive`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`. По умолчанию: `adaptive`. | | `duration` | integer | 2–30 секунд результата или `-1` для автоматической длительности. По умолчанию: `5`. | | `audio` | boolean | Генерировать звук. По умолчанию: `true`. Отключение не снижает тариф. | | `seed` | integer | 0–2147483647. Не указывайте для случайной генерации. | | `prompt_extend` | boolean | Расширять промпт. По умолчанию: `true`. | | `nsfw_checker` | boolean | По умолчанию: `true` для Wan 3.0 и Wan 3.0 Prime, `false` для вариантов Pro. `true` не поддерживает входные данные `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`: ```json { "nsfw_checker": false } ``` Это фрагмент запроса, а не полный запрос генерации. Менее строгая проверка не гарантирует принятие; проверки контента Playground по-прежнему действуют. Этот параметр не устраняет ошибки параметров, недостаточный баланс и другие ошибки, не связанные с проверкой. При тайм-ауте отправки или неизвестном результате сначала получите существующую задачу; не отправляйте новую платную генерацию автоматически. Варианты Pro поддерживают только `false` и по умолчанию используют `false`. Исторические задачи сохраняют исходное значение для получения статуса и расчётов. `content_filter` по-прежнему принимается как устаревший псевдоним `nsfw_checker`. В новых интеграциях используйте `nsfw_checker`. При передаче обоих полей их логические значения должны совпадать; противоречащие значения отклоняются. ## Опрос статуса и скачивание видео [#опрос-статуса-и-скачивание-видео] Эндпоинт отправки каждой модели возвращает публичный ID задачи. Сначала сохраните его. ```json { "task_info": { "id": "task_EXAMPLE", "status": "pending" } } ``` Используйте пример проверки из раздела нужной модели. Начните с интервала в пять секунд и увеличивайте задержку после временных ошибок. Храните ID модели вместе с ID задачи; не запрашивайте её через эндпоинт другой модели. Нативные статусы: `pending`, `processing`, `completed` и `failed`. Ответ завершённой задачи содержит `videos` — массив с полным подписанным URL Bunny CDN. ```json { "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] Для клиентов Responses API эндпоинт `POST /v1/responses` принимает ID модели, строку `input` и те же нативные поля генерации. Используйте `input` вместо `prompt`. Нативные медиа-поля, например `reference_images`, остаются на верхнем уровне. ```json { "model": "w3.0-video-prime-pro", "input": "A blue ball rolls across a white table.", "resolution": "1080p", "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 задачи и обратитесь в [поддержку](/ru/contact), если нужно выяснить результат неопределённой отправки.