> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Генерация видео Wan3.0 (Alibaba Tongyi Wanxiang)
> Полное руководство по генерации видео Alibaba Tongyi Wanxiang Wan3.0: один ID модели охватывает текст в видео, изображение в видео, видео по референсу и редактирование видео, длительность до 30 секунд, 480P–1080P, нативная звуковая дорожка, раздельная тарификация для Standard и Prime; по умолчанию 98% от официальной стоимости, от 81,7% с бонусами за пополнение ($0.0245/сек для 480P).
## Обзор
**Wan3.0 — это универсальная модель для генерации видео от Tongyi Wanxiang.** В отличие от Wan2.7, где требовалось переключаться между четырьмя ID моделей (`t2v` / `i2v` / `r2v` / `videoedit`), Wan3.0 поддерживает **все режимы через один ID модели** — выполняемая задача определяется тем, какие медиафайлы вы передаете. Генерация видео по тексту, по изображению, по референсу и редактирование видео используют единое тело запроса.
Две версии с одинаковыми возможностями, но разной скоростью и стоимостью:
| ID модели | Позиционирование | Относительная скорость | Цена APIYI при 720P | **С бонусом 20% на пополнение — от** |
| - | - | - | - | - |
| `wan3.0-video` | Стандартная | Базовая | \$0.0588/сек | **\$0.049/сек** (≈ ¥0.34/сек) |
| `wan3.0-video-prime` | **Prime (быстрее)** | Повышенная скорость | \$0.126/сек | **\$0.105/сек** (≈ ¥0.74/сек) |
Обе версии используют **абсолютно одинаковые параметры, эндпоинт и правила обработки медиа** — различаются только скорость и цена за единицу. Сначала выполните интеграцию с `wan3.0-video`, а затем переведите чувствительный к задержкам продакшн-трафик на `wan3.0-video-prime`.
## Что изменилось по сравнению с Wan2.7
| Параметр | Wan2.7 | **Wan3.0** |
| - | - | - |
| ID моделей | 4 (t2v / i2v / r2v / videoedit) | **1** (режим определяется медиафайлом) |
| Макс. длительность | 15 сек (10 сек с референсным видео) | **30 сек** (суммарно для входа и выхода) |
| Разрешение | 720P / 1080P | **480P** / 720P / 1080P |
| Аудио | Требуется `driving_audio` для синхронизации губ | **Нативная аудиодорожка по умолчанию** |
| Цена 720P | \$0.084/сек | **\$0.0588/сек** (\~на 30% дешевле) |
| Цена 1080P | \$0.14/сек | **\$0.1176/сек** (\~на 16% дешевле) |
Wan2.7 по-прежнему полностью доступна — см. [Генерация видео Wan2.7](/ru/api-capabilities/wan/overview).
## Ключевые особенности
Режимы «текст в видео» (text-to-video), «изображение в видео» (image-to-video, первый/последний кадр), «референс в видео» (изображение, видео, аудио) и редактирование видео используют один и тот же ID модели и единый эндпоинт, различаясь параметром `type` в `input.media[]`.
До 30 секунд на один запрос (входное референсное видео + итоговый результат суммарно) — вдвое больше 15 секунд у Wan2.7, чего достаточно для полноценного фрагмента с закадровым голосом или сцены короткометражной драмы.
Результат по умолчанию содержит дорожку `soun`, управляющее аудио не требуется. Используйте `reference_audio`, когда необходим конкретный тембр голоса.
Новый уровень 480P стоит вчетверо дешевле 1080P — создавайте черновые варианты с минимальными затратами, а затем выполняйте апскейл для финального рендеринга.
## Настройка группы
Wan3.0 использует общую **группу `Wan&HappyHorse`** с Wan2.7 и [HappyHorse](/ru/api-capabilities/happyhorse/overview) — один ключ вызывает их все. Видео тарифицируется **посекундно**, поэтому для успешной маршрутизации ваш ключ должен соответствовать двум условиям:
1. **Режим тарификации**: выберите «Pay-as-you-go priority» или «Pay-as-you-go» — видео с посекундной тарификацией **не может маршрутизироваться через ключ с оплатой за вызов**
2. **Группа**: включите `Wan&HappyHorse`
## Тарифы
**По умолчанию 98% от официальной цены Alibaba — вплоть до 81,7% с максимальным бонусом за пополнение.**
Это дает **\$0.0245/сек** (≈ ¥0,17/сек) для 480P и **\$0.049/сек** (≈ ¥0,34/сек) для 720P в `wan3.0-video`.
### Как формируется тариф: 0.98x по умолчанию, вплоть до 0.817x с бонусами
В консоли для группы `Wan&HappyHorse` отображается коэффициент тарифа **0.14x** с номиналом в **CNY**. APIYI производит расчеты в **USD по фиксированному курсу 1:7**:
```
0.14 (CNY-denominated unit) × 7 (fixed rate) = 0.98
```
Таким образом, **цена за секунду в APIYI (USD) = официальная цена Alibaba в CNY за секунду × 0.14**, что составляет 98% от официального тарифа.
### Таблица 1: Подробные тарифы APIYI (посекундная тарификация)
| Модель | Разрешение | По умолчанию | С бонусом 10% | **С бонусом 20%** | Цена в CNY с бонусом 20% |
| - | - | - | - | - | - |
| `wan3.0-video` | 480P | \$0.0294/сек | \$0.0267/сек | **\$0.0245/сек** | ¥0.1715/сек |
| `wan3.0-video` | 720P | \$0.0588/сек | \$0.0535/сек | **\$0.049/сек** | ¥0.343/сек |
| `wan3.0-video` | 1080P | \$0.1176/сек | \$0.1069/сек | **\$0.098/сек** | ¥0.686/сек |
| `wan3.0-video-prime` | 480P | \$0.063/сек | \$0.0573/сек | **\$0.0525/сек** | ¥0.3675/сек |
| `wan3.0-video-prime` | 720P | \$0.126/сек | \$0.1145/сек | **\$0.105/сек** | ¥0.735/сек |
| `wan3.0-video-prime` | 1080P | \$0.252/сек | \$0.2291/сек | **\$0.21/сек** | ¥1.47/сек |
| Уровень | Доля от официальной цены Alibaba | Формула |
| - | - | - |
| По умолчанию | **98%** | коэффициент 0.14x × фиксированный курс 7 |
| Бонус за пополнение 10% (стандартный) | **\~89,1%** | 0.98 ÷ 1.1 |
| Бонус за пополнение 20% (крупные аккаунты) | **\~81,7%** | 0.98 ÷ 1.2 |
«С бонусом 10% / 20%» — это **эффективная цена за единицу** с учетом того, что [бонус за пополнение](/ru/faq/recharge-promotions) увеличивает зачисляемый баланс; при этом за каждый вызов списывается цена по умолчанию.
### Таблица 2: Сравнение уровней с официальными ценами Alibaba
| Модель | Разрешение | Официальная базовая | Официальная текущая | APIYI по умолчанию (CNY) | К официальной цене | **С бонусом 20%** |
| - | - | - | - | - | - | - |
| `wan3.0-video` | 480P | ¥0.30/сек | **¥0.21/сек** | ¥0.2058/сек | 98% | **¥0.1715/сек · 81.7%** |
| `wan3.0-video` | 720P | ¥0.60/сек | **¥0.42/сек** | ¥0.4116/сек | 98% | **¥0.343/сек · 81.7%** |
| `wan3.0-video` | 1080P | ¥1.20/сек | **¥0.84/сек** | ¥0.8232/сек | 98% | **¥0.686/сек · 81.7%** |
| `wan3.0-video-prime` | 480P | ¥0.45/сек | ¥0.45/сек | ¥0.441/сек | 98% | **¥0.3675/сек · 81.7%** |
| `wan3.0-video-prime` | 720P | ¥0.90/сек | ¥0.90/сек | ¥0.882/сек | 98% | **¥0.735/сек · 81.7%** |
| `wan3.0-video-prime` | 1080P | ¥1.80/сек | ¥1.80/сек | ¥1.764/сек | 98% | **¥1.47/сек · 81.7%** |
Для `wan3.0-video` в настоящее время действует официальная **временная скидка 30%** (применяется ко всем пользователям по умолчанию), и цены APIYI рассчитываются с учетом этой скидки. Для `wan3.0-video-prime` скидка не предусмотрена. Цены APIYI будут скорректированы после окончания акции.
### Таблица 3: Итоговая стоимость для популярной продолжительности
| Модель | Разрешение | 5 сек | 10 сек | 30 сек (макс.) |
| - | - | - | - | - |
| `wan3.0-video` | 480P | \$0.147 | \$0.294 | \$0.882 |
| `wan3.0-video` | 720P | \$0.294 | \$0.588 | \$1.764 |
| `wan3.0-video` | 1080P | \$0.588 | \$1.176 | \$3.528 |
| `wan3.0-video-prime` | 480P | \$0.315 | \$0.63 | \$1.89 |
| `wan3.0-video-prime` | 720P | \$0.63 | \$1.26 | \$3.78 |
| `wan3.0-video-prime` | 1080P | \$1.26 | \$2.52 | \$7.56 |
### Суммирование бонусов за пополнение
Благодаря [бонусу за пополнение](/ru/faq/recharge-promotions) зачисляемый баланс увеличивается до \~1.2x, что делает эффективную ставку еще ниже:
```
0.98 ÷ 1.2 ≈ 0.816
```
| Уровень | Эффективная цена (к официальной Alibaba) | Формула |
| - | - | - |
| По умолчанию | **98%** | коэффициент 0.14x × фиксированный курс 7 |
| Бонус за пополнение 10% (стандартный) | **\~89,1%** | 0.98 ÷ 1.1 |
| Бонус за пополнение 20% (крупные аккаунты, максимальный уровень) | **\~81,7%** | 0.98 ÷ 1.2 |
1:7 — это **фиксированный расчетный курс** (а не промо-курс), который действует для всех пополнений в USD.
Цены соответствуют официальным тарифам провайдера и могут изменяться вслед за ними; таблица выше приведена исключительно для справки, а актуальные данные представлены на вкладке **Цены на модели** в верхнем меню навигации: [Цены на модели](/en/models/index).
## ⚠️ Правила тарификации (отличаются от других видеомоделей)
**Оплачиваемые секунды = длительность входного референсного видео + длительность выходного видео.** Согласно Alibaba: «Как входное, так и выходное видео тарифицируются по длительности; цена за единицу определяется разрешением выходного видео».
| Правило | Подробности |
| - | - |
| Секунды референсного **видео** оплачиваются | 10-секундный `reference_video` с 2-секундным выводом тарифицируется как **12 секунд** |
| Референсные **изображения / аудио / файлы** бесплатны | В оплачиваемую длительность засчитываются только видеоматериалы |
| Цена за единицу зависит от разрешения **вывода** | Входное видео 720P с выводом 1080P тарифицируется полностью по тарифу 1080P |
| Общий лимит в 30 секунд | Вход + вывод более 30 секунд отклоняются вышестоящим сервисом |
| `duration` не передан | По умолчанию вывод составляет 5 секунд, тарифицируется как 5 секунд |
| Неудачные задачи | **Полный возврат средств**, обращение в поддержку не требуется |
Чтобы снизить затраты, **обрежьте референсное видео** — уменьшение `duration` никак не влияет на секунды входного видео. Пример: 10-секундный референс плюс 2-секундный вывод тарифицируются как 12 секунд; обрезка референса до 3 секунд тарифицируется всего как 5 секунд.
### Преавторизация и расчет
* **Без референсного видео**: запрашиваемый `duration` списывается сразу, и это окончательная сумма — отдельной записи расчета нет.
* **С референсным видео**: в момент отправки шлюз еще не знает длительность вашего входного видео, поэтому выполняет преавторизацию по **лимиту в 30 секунд**, затем пересчитывает стоимость по фактически оплаченным секундам и возвращает разницу (отдельная отрицательная запись в вашем счете).
Удержание по максимальному лимиту временно замораживает большую сумму: \$0.147 для 480P, \$0.294 для 720P, \$0.588 для 1080P (`wan3.0-video`, 30 секунд). Поддерживайте достаточный баланс; возврат поступает в течение нескольких секунд после завершения задачи.
## ⚠️ Выбор эндпоинта (самое важное)
APIYI предоставляет два пути, но **полноценно с Wan3.0 работает только сквозной эндпоинт DashScope**:
| Путь | Стиль протокола | Доступность | Вердикт |
| - | - | - | - |
| `/v1/videos` | Плоский стиль OpenAI | ❌ Медиаполя отбрасываются, **а тарификация некорректна** | **Не использовать** |
| `/wan/api/v1/services/aigc/video-generation/video-synthesis` | Нативный DashScope passthrough | ✅ Полностью поддерживается | **Всегда используйте его** |
Игнорируйте любые инструкции и примеры, в которых задачи генерации видео Wan отправляются на `/v1/videos`. Этот путь отбрасывает поле `media`, **игнорирует параметры разрешения и длительности, а также приводит к завышенным списаниям**. Всегда отправляйте запросы к Wan3.0 на `/wan/api/v1/...video-synthesis`.
## Асинхронный рабочий процесс
`POST /wan/api/v1/services/aigc/video-generation/video-synthesis` с заголовком `X-DashScope-Async: enable`. Сразу возвращает `task_id`.
`GET /v1/tasks/{task_id}` (с `Authorization`) каждые 5–10 секунд (**ни в коем случае не менее 3**), пока `status` не станет `completed`.
Выполните GET-запрос напрямую по `result_url` из ответа — **без заголовка `Authorization`** (это подписанная ссылка OSS; передача данных аутентификации вернет 403). Ссылка действительна в течение 24 часов.
### Состояния задач
| Статус | Значение | Следующий шаг |
| - | - | - |
| `submitted` | В очереди | Продолжайте опрос |
| `in_progress` | Генерация | Продолжайте опрос (прогресс часто застывает на 30% — это приблизительная оценка апстрима, а не зависание) |
| `completed` | Завершено | Скачайте по ссылке из `result_url` |
| `failed` | Ошибка | Проверьте `error.message` / `fail_reason`; **не тарифицируется** |
Финальными значениями являются **`completed` / `failed`**, а не нативные `SUCCEEDED` / `FAILED` от DashScope. Код, написанный под нативное перечисление, будет выполнять опрос бесконечно.
**Недопустимые параметры также сначала возвращают HTTP 200 и завершаются ошибкой асинхронно** — а не синхронным кодом 400. Недоступный URL медиафайла или суммарная длительность входных и выходных данных более 30 секунд проявятся только тогда, когда при опросе будет достигнуто финальное состояние. Никогда не полагайтесь только на код статуса при отправке.
### Полный клиент на Python
```python theme={null}
import json, time, urllib.request
BASE = "https://api.apiyi.com"
KEY = "sk-your-api-key" # your APIYI key
def post(path, body):
h = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json",
"X-DashScope-Async": "enable"}
req = urllib.request.Request(BASE + path, data=json.dumps(body).encode(), headers=h, method="POST")
return json.loads(urllib.request.urlopen(req).read())
def get(path):
req = urllib.request.Request(BASE + path, headers={"Authorization": f"Bearer {KEY}"})
return json.loads(urllib.request.urlopen(req).read())
# 1. Create the task (switch modes by changing input.media only — model ID stays the same)
r = post("/wan/api/v1/services/aigc/video-generation/video-synthesis", {
"model": "wan3.0-video",
"input": {"prompt": "A lighthouse by the sea at dusk, slow dolly-in, waves on the rocks, seagulls"},
"parameters": {"resolution": "720P", "ratio": "16:9", "duration": 5, "prompt_extend": True}
})
task_id = r["output"]["task_id"]
print("task_id:", task_id)
# 2. Poll every 5–10 seconds
while True:
info = get(f"/v1/tasks/{task_id}")
status = info["status"]
print("status:", status, "progress:", info.get("progress"))
if status == "completed":
url = info["result_url"]
break
if status == "failed":
raise RuntimeError(info.get("error") or info.get("fail_reason"))
time.sleep(10)
# 3. Download (no Authorization header! result_url is a signed OSS link)
urllib.request.urlretrieve(url, "out.mp4")
print("saved out.mp4")
```
## Справочник параметров
Тело запроса использует вложенную структуру DashScope: `{ model, input: { prompt, media[] }, parameters: {...} }`.
### Поля `input`
| Поле | Тип | Обязательное | Описание |
| - | - | - | - |
| `prompt` | string | ✓ | Описание на естественном языке. При наличии нескольких ассетов ссылайтесь на них как «image 1 / video 1» в prompt |
| `negative_prompt` | string | | Отрицательный prompt |
| `media` | array | Обязательно для режимов, отличных от генерации видео по тексту | Массив медиа-ассетов, см. ниже |
### Типы `media[]` и выбираемый ими режим
| `type` | Режим | Примечания |
| - | - | - |
| без `media` | **Генерация видео по тексту** | Только prompt |
| `first_frame` | **Генерация видео по изображению** | Использует это изображение в качестве первого кадра |
| `last_frame` | Видео по первому/последнему кадру | Используется в паре с `first_frame` |
| `reference_image` | **Генерация видео по референсу** | Сохраняет согласованность объекта / одежды / сцены |
| `reference_video` | Генерация видео по референсу / редактирование | **Длительность этого видео тарифицируется** |
| `reference_audio` | Референс голоса / ритма | Не тарифицируется |
| `file` / `link` | Генерация видео по документу или веб-странице | Не тарифицируется |
**`first_frame` / `last_frame` нельзя совмещать с `reference_*` / `file` / `link`** — эти два семейства ассетов взаимоисключающие, их совмещение отклоняется на стороне апстрима.
Каждый медиаобъект должен содержать как минимум `type` и `url`. Параметр `url` должен быть общедоступной https-ссылкой (предварительно загрузите локальные файлы в OSS / CDN и **сохраняйте к ним доступ до завершения задачи**).
### Поля `parameters`
| Поле | Тип | Значения | Описание |
| - | - | - | - |
| `resolution` | string | `480P` / `720P` / `1080P` | В верхнем регистре. **Задавайте явно** — это определяет стоимость за единицу |
| `ratio` | string | `16:9` / `9:16` / `1:1` / `4:3` / `3:4` / `adaptive` | Соотношение сторон; игнорируется при передаче первого кадра |
| `duration` | int | Целое число секунд | Длительность результата; по умолчанию 5. **Сумма входной и выходной длительности должна быть ≤ 30** |
| `prompt_extend` | bool | `true` / `false` | Переписывание prompt, по умолчанию `true` — **рекомендуется оставить включенным** |
| `audio` | bool | `true` / `false` | Выводить ли аудиодорожку, по умолчанию `true` |
| `watermark` | bool | `true` / `false` | Водяной знак «AI generated» в правом нижнем углу |
| `seed` | int | 0–2147483647 | Фиксация значения повышает воспроизводимость |
`duration` должно быть **целым числом** (`5`, а не `"5"`), а `resolution` надежнее указывать в **верхнем регистре** (`720P`).
## Выбор: Wan3.0 / Wan2.7 / HappyHorse
| Сценарий | Выбор |
| - | - |
| Требуются 30-секундные ролики, недорогой тариф 480P или нативное аудио | **Wan3.0** |
| Требуется синхронизация губ по аудио (`driving_audio`) | [Wan2.7 `i2v`](/ru/api-capabilities/wan/overview) |
| Продакшн-трафик, чувствительный к задержке | **`wan3.0-video-prime`** |
| Нужна более низкая цена за единицу при аналогичных возможностях | [HappyHorse](/ru/api-capabilities/happyhorse/overview) |
## Лучшие практики
480P стоит вчетверо дешевле, чем 1080P. Отработайте prompt и движение камеры с минимальными затратами: по цене одного 5-секундного рендера в 1080P можно получить четыре черновых варианта.
Секунды входящего видео тарифицируются. Если вам нужны только 3 секунды клипа, не загружайте 30-секундный оригинал — это самая распространенная ловушка лишних расходов в Wan3.0.
Видеомодели лучше всего реагируют на формулу «кто что делает и как движется камера». Описание «Рыжий кот потягивается на подоконнике, медленный наезд камеры» сработает гораздо лучше, чем «милый рыжий кот, солнечный свет, высокое разрешение».
Фактическое время генерации 5-секундного ролика: \~100 с для 480P, \~120 с для 720P, \~170 с для 1080P. Опроса раз в 5–10 секунд более чем достаточно.
За неудачные задачи средства возвращаются в полном объеме, но повторная отправка **тарифицируется заново**. При ошибках модерации измените prompt; при ошибках с ресурсами сначала проверьте доступность URL.
## Часто задаваемые вопросы
Тарифицируемые секунды = **длительность входного референсного видео + длительность выходного видео**. Референс длительностью 10 секунд с выходным видео в 2 секунды тарифицируется как 12 секунд. Референсные изображения, аудио и файлы бесплатны.
Для задач с референсным видео выполняется предварительное холдирование средств с расчетом на максимальный лимит в 30 секунд, затем происходит расчет по фактически тарифицируемым секундам и возврат разницы. В детализации счета вы увидите запись с отрицательной корректировкой.
Это приблизительная оценка от вышестоящего сервиса, а не зависание. Обработка видео в 1080P или длинных роликов может занимать 3–5 минут. Продолжайте опрос.
**Не** передавайте заголовок `Authorization` — это подписанная ссылка OSS. Срок действия ссылок истекает через 24 часа, поэтому своевременно переносите файлы к себе.
Ошибки параметров и файлов ресурсов приводят к асинхронному сбою, а не к синхронной ошибке 400. Распространенные причины: недоступный URL медиафайла (включая истекшие подписанные ссылки), суммарная длительность входа и выхода более 30 секунд, модерация контента. Задачи с ошибкой возвращаются в полном объеме.
Убедитесь, что для вашего ключа выбран **режим тарификации** pay-as-you-go (ключи с тарификацией за вызов не могут маршрутизировать видеомодели), а его **группа** включает `Wan&HappyHorse`.
## Связанная документация
Интерактивный Playground и примеры для cURL / Python / Node
Предыдущее поколение из четырех моделей с синхронизацией губ по аудио
Другая серия видео в той же группе
Официальная сводная таблица цен по всему сайту
Официальные источники: `help.aliyun.com/zh/model-studio/wan3-video-generation-guide`, `help.aliyun.com/zh/model-studio/wan3-video-generation-api-reference`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.