# Wan 3.0 Prime — видео, Alibaba Qwen, через API СОЮЗа

> Идентификатор для поля `model`: `wan-3.0-prime`. Страница: https://souz.ai/models/wan-3.0-prime. Текст, изображение, видео, звук → Видео. Выпущена 24 августа 2026.

СОЮЗ — единый API к нейросетям разных вендоров: один ключ, общий баланс в рублях, списание только за успешный запрос. Эта модель вызывается по контракту ниже.

Wan 3.0 Prime — быстрее обычной версии: 30 секунд со звуком, герои и голос из фото, видео и записей. Для черновиков.

## Цены

Неуспешный запрос не тарифицируется. В ответах API итог — `price` у задачи и `usage.cost` у чата — целые микроединицы валюты платформы (1 единица = 1 000 000 микро), а сама валюта приезжает рядом полем `currency` (сейчас `RUB`). У незавершённой задачи `price: null`.

- Разрешение 480p, 2 с — от 9,065075 ₽ за секунду
- Разрешение 720p, 2 с — от 18,663389 ₽ за секунду
- Разрешение 1080p, 2 с — от 37,326778 ₽ за секунду

Цены и типичное время пресетов роутинга — поле `routing`: `cheap` «Дешевле», `balanced` «Баланс» (по умолчанию), `fast` «Быстрее». Пресет задаёт порядок каналов; где пресеты начинают с одного канала, цена у них общая. Потолок `max_price_multiplier` (`1.5`, `2`, `3`, `5`, `10`) не даёт пробовать каналы дороже цены пресета больше чем во столько раз.

- Разрешение 480p, 2 с: Синий (`blue`) — 9,96557 ₽ за секунду; Салатовый (`lime`) — 9,998244 ₽ за секунду; Розовый (`pink`) — 9,998244 ₽ за секунду; Голубой (`cyan`) — 20,510287 ₽ за секунду; Зелёный (`green`) — 9,065075 ₽ за секунду; Фиолетовый (`violet`) — 12,600729 ₽ за секунду.
- Разрешение 720p, 2 с: Синий (`blue`) — 20,58462 ₽ за секунду; Салатовый (`lime`) — 20,58462 ₽ за секунду; Розовый (`pink`) — 20,58462 ₽ за секунду; Голубой (`cyan`) — 42,227061 ₽ за секунду; Зелёный (`green`) — 18,663389 ₽ за секунду; Фиолетовый (`violet`) — 25,201457 ₽ за секунду.
- Разрешение 1080p, 2 с: Синий (`blue`) — 41,16924 ₽ за секунду; Салатовый (`lime`) — 41,16924 ₽ за секунду; Розовый (`pink`) — 41,16924 ₽ за секунду; Голубой (`cyan`) — 84,454122 ₽ за секунду; Зелёный (`green`) — 37,326778 ₽ за секунду; Фиолетовый (`violet`) — 50,402913 ₽ за секунду.

Ставки за секунду ролика; с видео-референсом оплачиваются и секунды входного клипа. Цена «от» — у самого дешёвого канала; цены и скорость каждого — в блоке «Каналы». При авто-роутинге цена может меняться.

## Каналы

Канал — постоянный цвет внутри модели: у каждого свои ставки, задержка, скорость и стабильность. Цвет не означает «дешёвый» или «быстрый», одинаковый цвет у другой модели — другой канал. Задержка и скорость — медиана за последний час, стабильность — доля успешных вызовов за 7 дней; «нет данных» — замеров пока мало, а не ноль.

Каналов: 6. Данные на момент сборки страницы; свежие — `GET https://api.souz.ai/v1/models/wan-3.0-prime/channels` без ключа (там же HEX цвета, пределы входа и p90).

| Канал (`id`) | Название | Доступен | Ставки | Время ответа, p50 за сутки | Стабильность, 7 дней |
| --- | --- | --- | --- | --- | --- |
| `blue` | Синий | да | 102,9231 ₽ за запрос с параметрами по умолчанию | 1 мин 19 с | 100% |
| `lime` | Салатовый | да | 102,9231 ₽ за запрос с параметрами по умолчанию | 1 мин 39 с | 100% |
| `pink` | Розовый | да | 102,9231 ₽ за запрос с параметрами по умолчанию | 2 мин 20 с | 100% |
| `cyan` | Голубой | да | 84,454122 ₽ за запрос с параметрами по умолчанию | 3 мин 17 с | 100% |
| `green` | Зелёный | да | 93,316944 ₽ за запрос с параметрами по умолчанию | 1 мин 1 с | нет данных |
| `violet` | Фиолетовый | да | 126,007281 ₽ за запрос с параметрами по умолчанию | 3 мин 1 с | нет данных |

Как выбрать канал:

- По умолчанию канал выбирает Авто-роутинг: пресет `routing` (`cheap`, `balanced`, `fast`) задаёт порядок каналов, при отказе запрос переходит к следующему.
- На один запрос — поле `routing_options`: `{"only": ["blue"]}` — только этот канал, без запасных; `{"order": ["blue"]}` — сначала он, затем остальные; `"allow_fallbacks": false` — только каналы из `order`; `{"ignore": [...]}` — исключить; `max_price` — пределы ставок. SDK OpenAI — через `extra_body`.
- Бесплатная проверка без запуска: `POST https://api.souz.ai/v1/models/wan-3.0-prime/routing/preview` с теми же `routing`, `routing_options` и `params` — каналы в порядке попыток (`channels`), у каждого оценка `estimated_price`; запрос начнётся с первого. Пустой `channels` — с такими условиями запрос не выполнить. Настройки аккаунта превью применяет, как запрос.
- Закрепить по умолчанию для всех запросов аккаунта к модели: `PATCH https://api.souz.ai/v1/settings` ключом управления с `{"routing_options": {"wan-3.0-prime": {"only": ["blue"]}}}`. PATCH заменяет всю карту — сначала прочитайте `GET https://api.souz.ai/v1/settings` и сохраните настройки других моделей. Запрос без `routing_options` наследует настройку; `{}` в запросе — автоматический выбор на один вызов.
- MCP: https://api.souz.ai/mcp — инструменты `list_channels`, `compare_channels`, `preview_routing`, `pin_channel`, `unpin_channel`. Подключение в Claude Code: `claude mcp add --transport http souz https://api.souz.ai/mcp --header "Authorization: Bearer $SOUZ_API_KEY"`.
- Каким каналом выполнен запрос — поле `channel` в ответе (у чата — и в каждом чанке потока), в задаче, вебхуке и истории запросов; `attempt_count` — сколько было попыток.

## Подключение по API

- Адрес: `POST https://api.souz.ai/v1/videos`
- Авторизация: заголовок `Authorization: Bearer <ключ>`. Ключ создаётся в кабинете: https://souz.ai/keys.
- Тело запроса — JSON, `Content-Type: application/json`, поле `model` — `wan-3.0-prime`.
- Ответ — `202` с объектом задачи (`object: "job"`); дальше `GET https://api.souz.ai/v1/jobs/{id}` до `status: completed` или `failed`, события `GET …/jobs/{id}/events` (SSE) или вебхук по `callback_url`. Ролик — в `data[0].url`, итог — в `price`. Файлы живут 1 день по подписанной ссылке: нужен дольше — скачайте.
- Ошибки — JSON вида `{ "error": { "type", "code", "message", "detail" } }` с кодом HTTP 4xx/5xx; ветвиться — по `type` и `code`. `401` — неверный ключ; `402` с кодом `insufficient_balance` — не хватает средств на балансе, `key_spend_limit_exceeded` или `member_spend_limit_exceeded` — исчерпан лимит трат ключа или участника, повтор не поможет; `400` с кодом `capability_mismatch` или `invalid_request` — запрос не подходит модели, в `error.detail[]` — поле (`path`), причина (`reason`) и что подойдёт (`allowed`); `503 model_unavailable` — модель сейчас недоступна, повторите после `Retry-After`.
- Руководство по API целиком: https://souz.ai/docs, спецификация OpenAPI: https://api.souz.ai/openapi.json.

## Параметры запроса

Отправляются поля из этой таблицы. Кроме них — общие поля задач `routing`, `routing_options`, `max_price_multiplier`, `store`, `callback_url` и `user`. Незнакомое поле — `400 invalid_request` с `detail[].reason: unsupported_field`; значение, которое у модели ничего не меняет, принимается молча. Вся схема тела машинно — `input_schema` в карточке `GET /v1/models/wan-3.0-prime` (JSON Schema).

| Поле | Тип | Обязательное | Значения | По умолчанию | Описание |
| --- | --- | --- | --- | --- | --- |
| `prompt` | строка | да | текст, до 20 000 символов | — | Описание. Сцена, камера, речь и звук. Референсы зовите Image 1, Video 1, Audio 1 — по порядку загрузки. |
| `resolution` | перечисление | нет | 480p, 720p, 1080p | `720p` | Разрешение |
| `duration_seconds` | целое | да | целое, от 2 до 30, шаг 1 | `5` | Длительность. От 2 до 30 секунд. С видео-референсом — до 15. |
| `aspect_ratio` | перечисление | нет | 16:9, 9:16, 1:1, 4:3, 3:4, auto | `16:9` | Соотношение сторон. «Авто» — формат по кадру или референсам. С первым кадром — только «Авто». |
| `audio` | флаг | нет | да или нет | `false` | Со звуком. Звук и речь вместе с роликом. Цена та же. |
| `first_frame` | изображение | нет | изображение | — | Первый кадр. Начало ролика. Не смешивается с референсами. |
| `last_frame` | изображение | нет | изображение | — | Последний кадр. Конец ролика. Только вместе с первым кадром. |
| `references` | изображение | нет | изображения, до 10 | — | Изображения. Герои, предметы и стиль: до десяти изображений. |
| `reference_videos` | видео | нет | ссылки https на видео, до 5 | — | Видео. MP4/MOV по HTTPS: до пяти клипов, вместе до 15 с. Чтобы изменить или продолжить ролик, скажите это в описании. |
| `reference_audio` | звук | нет | ссылки https на звук, до 5 | — | Звук. Голос или музыка WAV/MP3 по HTTPS: до пяти, вместе до 15 с. |

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

### cURL

```bash
curl https://api.souz.ai/v1/videos \
  -H "Authorization: Bearer $SOUZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-3.0-prime",
    "prompt": "волны у маяка на закате",
    "resolution": "720p",
    "duration_seconds": 5,
    "aspect_ratio": "16:9",
    "audio": false
  }'
```

### Python

```python
import os
import requests

SOUZ_API_KEY = os.environ["SOUZ_API_KEY"]

response = requests.post(
    "https://api.souz.ai/v1/videos",
    headers={"Authorization": f"Bearer {SOUZ_API_KEY}"},
    json={
      "model": "wan-3.0-prime",
      "prompt": "волны у маяка на закате",
      "resolution": "720p",
      "duration_seconds": 5,
      "aspect_ratio": "16:9",
      "audio": false
    },
)
print(response.json())
```

### TypeScript

```typescript
const response = await fetch("https://api.souz.ai/v1/videos", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOUZ_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "wan-3.0-prime",
    "prompt": "волны у маяка на закате",
    "resolution": "720p",
    "duration_seconds": 5,
    "aspect_ratio": "16:9",
    "audio": false
  }),
});
console.log(await response.json());
```

### Канал

```bash
curl https://api.souz.ai/v1/videos \
  -H "Authorization: Bearer $SOUZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-3.0-prime",
    "prompt": "волны у маяка на закате",
    "resolution": "720p",
    "duration_seconds": 5,
    "aspect_ratio": "16:9",
    "audio": false,
    "routing_options": {
      "only": [
        "blue"
      ]
    }
  }'
```

## Примеры ответа

### 202 — задача принята

```json
{
  "id": "job_01k9m2",
  "object": "job",
  "created": 1774170000,
  "created_at": "2026-03-22T09:00:00Z",
  "completed_at": null,
  "model": "wan-3.0-prime",
  "modality": "video",
  "status": "queued",
  "routing": "cheap",
  "max_price_multiplier": null,
  "routing_options": null,
  "attempt_count": 0,
  "channel": null,
  "price": null,
  "currency": "RUB",
  "usage": null,
  "data": [],
  "error": null
}
```

### GET /v1/jobs/{id}

```json
{
  "id": "job_01k9m2",
  "object": "job",
  "created": 1774170000,
  "created_at": "2026-03-22T09:00:00Z",
  "completed_at": "2026-03-22T09:00:09Z",
  "model": "wan-3.0-prime",
  "modality": "video",
  "status": "completed",
  "routing": "cheap",
  "max_price_multiplier": null,
  "routing_options": null,
  "attempt_count": 1,
  "channel": "blue",
  "price": 18130150,
  "currency": "RUB",
  "usage": null,
  "data": [
    {
      "id": "file_566d5b76c1e0d83de3b6d2e154241a68",
      "object": "file",
      "kind": "result",
      "type": "video",
      "role": "result",
      "url": "https://media.souz.ai/v1/files/file_566d5b76c1e0d83de3b6d2e154241a68/video.mp4?exp=4102444800&sig=example",
      "content_type": "video/mp4",
      "bytes": 2232240,
      "filename": "video.mp4",
      "created_at": "2026-03-22T09:00:09Z",
      "expires_at": "2026-03-29T09:00:09Z",
      "expired": false
    }
  ],
  "error": null
}
```

## Статистика за 7 дней

По запросам всех клиентов: запросов — 1, успешных — 100%, медиана времени ответа — 56 с, 95% запросов быстрее 56 с.

Время ответа — по успешным запросам; медиана и p95 округлены (±10 %), поэтому у разных моделей числа могут совпадать. По часам и без ключа: `GET https://api.souz.ai/v1/models/wan-3.0-prime/stats`.

## Вопросы и ответы

**Что такое Wan 3.0 Prime?**

Wan 3.0 Prime — быстрее обычной версии: 30 секунд со звуком, герои и голос из фото, видео и записей. Для черновиков. Доступна в СОЮЗе по единому API и в плейграунде на этой странице.

**Сколько стоит Wan 3.0 Prime?**

Wan 3.0 Prime стоит: разрешение 480p, 2 с — от 9,065075 ₽ за секунду, разрешение 720p, 2 с — от 18,663389 ₽ за секунду, разрешение 1080p, 2 с — от 37,326778 ₽ за секунду. Ставки за секунду ролика; с видео-референсом оплачиваются и секунды входного клипа. Цена «от» — у самого дешёвого канала; цены и скорость каждого — в блоке «Каналы». При авто-роутинге цена может меняться. Списывается только успешный запрос, неудачный не стоит ничего.

**Что Wan 3.0 Prime принимает на вход и что отдаёт?**

Wan 3.0 Prime принимает текст, изображения, видео и звук и отдаёт видео. В одном запросе: первый кадр — одно изображение; последний кадр — одно изображение; изображения — до 10 изображений; видео — до 5 ссылок https на видео; звук — до 5 ссылок https на звук.

**Какие форматы поддерживает Wan 3.0 Prime?**

Wan 3.0 Prime поддерживает: разрешение — 480p, 720p или 1080p, по умолчанию 720p; длительность — от 2 до 30, по умолчанию 5; соотношение сторон — 16:9, 9:16, 1:1, 4:3, 3:4 или Авто, по умолчанию 16:9.

**Как вызвать Wan 3.0 Prime через API?**

Запросом POST https://api.souz.ai/v1/videos с полем model: "wan-3.0-prime" и ключом СОЮЗа в заголовке Authorization: Bearer. Ответ — 202 с объектом задачи; готовый ролик забирается из GET /v1/jobs/{id}, потока событий или по вебхуку. Примеры на cURL, Python и TypeScript — в разделе «Подключение по API».

**Что такое каналы Wan 3.0 Prime и как выбрать конкретный?**

Wan 3.0 Prime выполняется через 6 каналов: «Синий» (blue), «Салатовый» (lime), «Розовый» (pink), «Голубой» (cyan), «Зелёный» (green) и «Фиолетовый» (violet). У каждого канала свои ставки, задержка, скорость и стабильность за 7 дней — они в блоке «Каналы» на этой странице и в GET https://api.souz.ai/v1/models/wan-3.0-prime/channels. Цвет не означает «дешёвый» или «быстрый», а одинаковый цвет у другой модели — другой канал. По умолчанию канал выбирает Авто-роутинг по пресету «Дешевле», «Баланс» или «Быстрее». Конкретный канал задаёт поле routing_options: {"only": ["blue"]} — только этот канал, {"order": ["blue"]} — сначала он, затем остальные. Чтобы закрепить канал для всех запросов к модели, сохраните ту же настройку в аккаунте: PATCH https://api.souz.ai/v1/settings ключом управления или в кабинете. Каким каналом выполнен запрос, видно в поле channel ответа и в истории.

**Как быстро и стабильно работает Wan 3.0 Prime?**

За последние 7 дней медиана времени ответа Wan 3.0 Prime — 56 с, 95% запросов укладываются в 56 с, доля успешных — 100% при 1 запросе. Считается по запросам всех клиентов СОЮЗа.

**Можно ли попробовать Wan 3.0 Prime без кода?**

Да: плейграунд на этой странице запускает Wan 3.0 Prime с теми же параметрами, что и API. Нужен аккаунт СОЮЗа. Цена выбранного пресета видна на кнопке запуска, когда объём известен до запуска; у ролика с клипом-референсом — ставка за секунду под выбором пресета. Пока запрос выполняется, в истории вместо цены стоит прочерк; итог появляется только после завершения.

**Когда вышла Wan 3.0 Prime?**

Wan 3.0 Prime выпущена Alibaba Qwen 24 августа 2026.

## Ссылки

- Страница модели: https://souz.ai/models/wan-3.0-prime
- Каталог моделей: https://souz.ai/models
- Все модели одним файлом: https://souz.ai/llms.txt
- Кабинет (ключи, баланс, история запросов): https://souz.ai/overview
