> ## 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.

# Генерация видео Wan (Alibaba Cloud Tongyi Wanxiang)

> Полное руководство по генерации видео Alibaba Cloud Tongyi Wanxiang Wan2.7: text-to-video / image-to-video (с управлением по аудио) / reference-to-video / редактирование видео. Единый асинхронный эндпоинт DashScope, 720P / 1080P, длительность 2–15 секунд.

## Обзор

**Wan (Tongyi Wanxiang)** — это серия моделей генерации видео от Alibaba Cloud. APIYI напрямую подключается к Alibaba Cloud Model Studio через **сквозной канал DashScope**, поэтому один ключ APIYI (начинающийся с `sk-`) открывает доступ ко всем возможностям видео Wan без отдельного аккаунта Alibaba Cloud. Текущий флагман — **Wan2.7**, охватывающий четыре основных сценария использования:

| Сценарий использования   | ID модели          | Ваш ввод                                                           | Результат                                                                                         |
| ------------------------ | ------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
| **Текст-в-видео**        | `wan2.7-t2v`       | Текстовый prompt                                                   | Короткое видео длительностью 5-15 секунд                                                          |
| **Изображение-в-видео**  | `wan2.7-i2v`       | Первый кадр + prompt (необязательное управляющее аудио)            | Оживляет статичное изображение; добавляет аудио для синхронизации губ / рэпа                      |
| **Референс-в-видео**     | `wan2.7-r2v`       | 1-5 референсных изображений/видео + prompt                         | Видео с одним или несколькими персонажами, сохраняющее объекты референсов, с голосовым референсом |
| **Редактирование видео** | `wan2.7-videoedit` | Видео + 1-5 референсных изображений + инструкция по редактированию | Отредактированное видео: замена одежды, замена фона и т. д.                                       |

<Note>
  **🎬 Ключевая особенность**: все четыре возможности используют один и тот же асинхронный эндпоинт и одну и ту же структуру запроса. **Переключайте сценарии использования, изменяя только поле `model`.** Нативная поддержка разрешений 720P / 1080P и целочисленной длительности от 2 до 15 секунд; `wan2.7-i2v` также поддерживает управляющее аудио для синхронизации губ. Идеально подходит для производства коротких видео, материалов для e-commerce, озвучивания цифровых аватаров и креативного маркетинга.
</Note>

<CardGroup cols={2}>
  <Card title="API текст-в-видео" icon="wand-sparkles" href="/ru/api-capabilities/wan/text-to-video">
    `wan2.7-t2v` генерирует видео из чистого text prompt — самый простой способ начать.
  </Card>

  <Card title="API изображения-в-видео" icon="image" href="/ru/api-capabilities/wan/image-to-video">
    `wan2.7-i2v` использует первый кадр + необязательное управляющее аудио для синхронизации губ / рэпа.
  </Card>

  <Card title="API референса-в-видео" icon="users" href="/ru/api-capabilities/wan/reference-to-video">
    `wan2.7-r2v` сохраняет характеристики объекта из reference images/videos, с голосовым референсом.
  </Card>

  <Card title="API редактирования видео" icon="scissors" href="/ru/api-capabilities/wan/video-edit">
    `wan2.7-videoedit` редактирует видео с помощью референсных изображений: замена одежды, замена фона и т. д.
  </Card>

  <Card title="Визуальное тестирование API" icon="flask-conical" href="https://icover.ai/wan-official">
    Отлаживайте этот эндпоинт напрямую в визуальном инструменте тестирования iCover — код не требуется.
  </Card>

  <Card title="Поиск / загрузка асинхронных задач" icon="list-checks" href="https://api.apiyi.com/task">
    Просматривайте отправленные задачи на видео и скачивайте ссылки на видео в консоли APIYI — запись для поиска вне API.
  </Card>
</CardGroup>

## Почему использовать Wan в APIYI

<CardGroup cols={2}>
  <Card title="Один ключ APIYI для всех возможностей" icon="key">
    Не требуется регистрация в Alibaba Cloud, настройка региона или переменных окружения. Один ключ APIYI вызывает все четыре возможности Wan2.7, а также [серию HappyHorse](/ru/api-capabilities/happyhorse/overview).
  </Card>

  <Card title="Прямой доступ, без VPN" icon="globe">
    Подключайтесь напрямую к `api.apiyi.com`, доступно как из дата-центров материкового Китая, так и из домашних сетей, без необходимости настраивать региональный endpoint Alibaba Cloud.
  </Card>

  <Card title="Нет списания при сбое" icon="circle-check">
    Задачи, завершающиеся `failed` (недоступный media URL, чувствительный prompt, нехватка upstream-мощностей и т. д.), **не тарифицируются**, так что повторяйте попытки свободно.
  </Card>

  <Card title="Сквозная передача протокола DashScope" icon="plug">
    Тело запроса сопоставляется один к одному с нативным протоколом DashScope Alibaba Cloud, поэтому вы можете мигрировать, следуя официальной документации; ответы нормализуются для удобного периодического опроса.
  </Card>
</CardGroup>

## Основные возможности

<CardGroup cols={2}>
  <Card title="Асинхронный эндпоинт 4-в-1" icon="list-check">
    t2v / i2v / r2v / video-edit используют общий `POST /wan/api/v1/...video-synthesis`. Отправьте задачу, получите `task_id`, опрашивайте и скачивайте. Простое управление пакетными задачами.
  </Card>

  <Card title="Синхронизация губ по аудио" icon="volume-2">
    `wan2.7-i2v` поддерживает `driving_audio`, благодаря чему статичный портрет повторяет движения рта и ритм аудио. Отлично подходит для рэпа / озвучки / цифровых людей.
  </Card>

  <Card title="Референс нескольких объектов" icon="users">
    `wan2.7-r2v` объединяет референсные изображения + референсные видео (максимум 5 в сумме), которые указываются в prompt как «image 1 / video 1», с поддержкой голосового референса.
  </Card>

  <Card title="Несколько разрешений и длительностей" icon="expand">
    Разрешения 720P / 1080P, длительность 2-15 секунд целыми числами. `prompt_extend` умное переписывание дополнительно повышает качество для коротких prompt.
  </Card>
</CardGroup>

## Поддерживаемые модели

| ID модели          | Возможность            | Требуемый медиа-ввод                                     | Примечания                                               |
| ------------------ | ---------------------- | -------------------------------------------------------- | -------------------------------------------------------- |
| `wan2.7-t2v`       | Из текста в видео      | Нет                                                      | Чистая генерация текста                                  |
| `wan2.7-i2v`       | Из изображения в видео | `first_frame` (+ необязательно `driving_audio`)          | Единственная возможность, поддерживающая аудиоуправление |
| `wan2.7-r2v`       | Из референса в видео   | `reference_image` / `reference_video` (всего не более 5) | Поддерживает `reference_voice` голосовой референс        |
| `wan2.7-videoedit` | Редактирование видео   | `video` + `reference_image` (1-5)                        | Название модели для редактирования **без дефиса**        |

<Warning>
  `wan2.7-videoedit` предназначен для редактирования видео с помощью изображений. Отдельный `wan2.7-image-pro` — это модель **для изображений** (использует `/v1/images/generations`) и выходит за рамки этого video endpoint, так что не путайте их. Для устаревшей серии Wan2.6 см. [Исторические версии](/ru/api-capabilities/wan/historical-versions).
</Warning>

## ⚠️ Выбор эндпоинта (самое важное)

APIYI монтирует два пути, но **только endpoint с проксированием DashScope полностью поддерживает все возможности Wan**:

| Path                                                         | Protocol style                   | i2v / r2v availability     | Verdict                    |
| ------------------------------------------------------------ | -------------------------------- | -------------------------- | -------------------------- |
| `/v1/videos`                                                 | OpenAI flat style                | ❌ Поля media отбрасываются | **Не используйте**         |
| `/wan/api/v1/services/aigc/video-generation/video-synthesis` | Нативное проксирование DashScope | ✅ Полностью поддерживается | **Всегда используйте это** |

<Warning>
  Если в какой-либо документации или примере вам предлагают отправлять задачи видео Wan через `/v1/videos`, **игнорируйте это**. Адаптация этого пути для полей i2v / r2v `media` неполная и вызывает upstream-ошибку `[InvalidParameter] Field required: input.media`. Все запросы на создание видео Wan отправляются в `/wan/api/v1/...video-synthesis`.
</Warning>

## Поток асинхронных вызовов

Весь процесс состоит из трёх асинхронных шагов: **создание задачи → опрос статуса → скачивание видео**.

<Steps>
  <Step title="Создайте задачу">
    `POST /wan/api/v1/services/aigc/video-generation/video-synthesis` с заголовком `X-DashScope-Async: enable`. Он сразу возвращает `task_id`.
  </Step>

  <Step title="Опросите статус">
    `GET /v1/tasks/{task_id}` (с `Authorization`) каждые 5-10 секунд (**не реже чем раз в 3 секунды**), пока `status` не станет `completed`.
  </Step>

  <Step title="Скачайте видео">
    Получите mp4 напрямую из `result_url` ответа. **Не отправляйте заголовок `Authorization`** (это подписанная OSS прямая ссылка; добавление Auth приводит к 403).
  </Step>
</Steps>

### Справка по статусам задачи

Верхнеуровневое поле `status` ответа `GET /v1/tasks/{task_id}` (уже нормализовано APIYI):

| Статус        | Значение              | Следующий шаг                                                                                       |
| ------------- | --------------------- | --------------------------------------------------------------------------------------------------- |
| `submitted`   | Отправлено, в очереди | Продолжайте опрос                                                                                   |
| `in_progress` | Генерация             | Продолжайте опрос (прогресс часто замирает на 30%; это грубое отображение upstream, а не зависание) |
| `completed`   | Успешно               | Скачайте по `result_url`                                                                            |
| `failed`      | Сбой                  | Проверьте `error.message` / `fail_reason`                                                           |

### Полный 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 use cases by changing only model and media)
r = post("/wan/api/v1/services/aigc/video-generation/video-synthesis", {
    "model": "wan2.7-t2v",
    "input": {"prompt": "A lighthouse on the seashore at dusk, the camera slowly pushing in, waves gently lapping the rocks, seabirds calling"},
    "parameters": {"resolution": "720P", "duration": 5, "prompt_extend": True, "watermark": 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 (do not send Authorization! result_url is an OSS signed direct link)
urllib.request.urlretrieve(url, "out.mp4")
print("saved out.mp4")
```

## Объяснение ключевых параметров

При отправке тело запроса использует вложенную структуру DashScope: `{ model, input: { prompt, media[] }, parameters: {...} }`.

### Поля `input`

| Поле              | Тип    | Обязательность               | Примечания                                                                                              |
| ----------------- | ------ | ---------------------------- | ------------------------------------------------------------------------------------------------------- |
| `prompt`          | string | ✓                            | Описание на естественном языке; wan2.7-r2v поддерживает маркеры "image 1 / video 1" для ссылки на медиа |
| `negative_prompt` | string |                              | Negative prompt, ≤500 символов                                                                          |
| `media`           | array  | Обязательно для i2v/r2v/edit | Массив медиа-объектов, см. ниже                                                                         |

### Типы `media[]`

| `type`            | Назначение                                                  | Применимые модели |
| ----------------- | ----------------------------------------------------------- | ----------------- |
| `first_frame`     | Изображение первого кадра (≤1)                              | i2v, r2v          |
| `reference_image` | Референсное изображение (сохранение объекта/сцены)          | r2v, videoedit    |
| `reference_video` | Референсное видео (референс объекта/голоса)                 | r2v               |
| `driving_audio`   | Управляющее аудио (синхронизация губ)                       | **только i2v**    |
| `video`           | Входное видео                                               | videoedit         |
| `reference_voice` | Голосовой референс (прикрепляется к reference\_image/video) | r2v               |

Каждому медиа-объекту нужны как минимум `type` + `url`. `url` должен быть общедоступной ссылкой https, которую можно напрямую получить через GET (сначала загрузите локальные файлы в OSS / CDN).

### Поля `parameters`

| Поле            | Тип    | Значения                                | Примечания                                                                      |
| --------------- | ------ | --------------------------------------- | ------------------------------------------------------------------------------- |
| `resolution`    | string | `720P` / `1080P`                        | В верхнем регистре; рекомендуется задавать явно                                 |
| `ratio`         | string | `16:9` / `9:16` / `1:1` / `4:3` / `3:4` | Соотношение сторон; автоматически игнорируется при указании первого кадра       |
| `duration`      | int    | 2-15                                    | Секунды (целое число), обычно 5 / 10; ограничено 10 при наличии reference video |
| `prompt_extend` | bool   | `true` / `false`                        | Умная переработка prompt, **настоятельно рекомендуется `true`**                 |
| `watermark`     | bool   | `true` / `false`                        | Водяной знак «сгенерировано ИИ» в правом нижнем углу                            |
| `seed`          | int    | 0-2147483647                            | Фиксация этого значения улучшает воспроизводимость                              |

<Tip>
  `duration` должен быть **целым числом** `5`, а не строкой `"5"`, иначе вы получите `cannot unmarshal string into Go struct field ... of type int`. Запись `resolution` в **верхнем регистре** (`720P`) надежнее.
</Tip>

## Выбор между Wan и HappyHorse

Wan и [HappyHorse](/ru/api-capabilities/happyhorse/overview) — это обе видеомодели Alibaba, и они используют один и тот же эндпоинт и схему (переключайтесь между ними, меняя только имя `model`), но их сильные стороны различаются:

| Dimension                                 | Wan2.7                                                  | HappyHorse-1.1                                                                                |
| ----------------------------------------- | ------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Синхронизация губ под аудио (i2v)         | ✅ `wan2.7-i2v` поддерживает `driving_audio`             | ❌ Не поддерживается, i2v принимает только первый кадр                                         |
| Лимит изображений для reference-to-video  | reference image + reference video, максимум 5 всего     | до 9 reference images                                                                         |
| Reference images для редактирования видео | ≤5                                                      | ≤5                                                                                            |
| Стиль согласованности объекта             | Взаимодействие нескольких объектов, голосовой reference | Склоняется к «точному воспроизведению динамичного материала», сохраняет стабильность объектов |

<Tip>
  **Нужны lip-sync / rap / озвучка digital-human** → выберите `wan2.7-i2v` (единственный вариант с audio drive).
  **Нужно много reference images, чтобы сохранить согласованность объекта** → рассмотрите [HappyHorse r2v (до 9 изображений)](/ru/api-capabilities/happyhorse/reference-to-video).
</Tip>

## Лучшие практики

<Steps>
  <Step title="Сначала тестируйте на 720P / 5 секунд">
    В процессе разработки быстро проверяйте prompt и направление камеры на коротких клипах низкого разрешения, а после завершения переходите к 720P / 1080P и более длительным роликам, чтобы сократить затраты и время ожидания.
  </Step>

  <Step title="Всегда включайте prompt_extend">
    `prompt_extend: true` заметно улучшает качество для коротких prompt, ценой лишь нескольких дополнительных секунд генерации.
  </Step>

  <Step title="Опрос каждые 5-10 секунд">
    Никогда не делайте интервал меньше 3 секунд (иначе вы упретесь в лимит запросов) и не блокируйте выполнение на длительных задачах бесконечно. 720P / 5 секунд обычно занимает 70-140 секунд; 1080P / более длинные клипы могут превышать 5 минут.
  </Step>

  <Step title="Установите клиентский timeout на 20 минут как запасной предел">
    1080P или клипы длиннее 10 секунд заметно медленнее; задайте для цикла опроса запасной timeout на 20 минут.
  </Step>

  <Step title="Скачивайте сразу после получения result_url">
    `result_url` по умолчанию **истекает через 24 часа** и представляет собой подписанную прямую ссылку OSS, поэтому при скачивании **не отправляйте заголовок Authorization**. В production всегда пересохраняйте его в своем OSS / CDN.
  </Step>

  <Step title="Делайте отправки идемпотентными">
    Неудачные задачи не тарифицируются, но повторная отправка той же задачи тарифицируется снова. Поддерживайте сопоставление «ID бизнеса → task\_id» на уровне приложения, чтобы избежать случайных списаний.
  </Step>
</Steps>

## Коды ошибок и повторные попытки

Ошибки возникают на двух этапах и обрабатываются по-разному:

| Источник                                               | Сигнатура                                                                                                                        | Обработка                                                                                                  |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Этап создания (отклонено APIYI)**                    | HTTP 4xx/5xx, `type` — это `task_error` / `parse_request_failed` / `build_request_failed`                                        | Исправьте body и повторите попытку (обычно неверный тип поля, отсутствует media или неправильный endpoint) |
| **Этап выполнения (отклонено upstream Alibaba Cloud)** | Задача завершается как `status=failed`, `error.message` с префиксом `[InvalidParameter]` / `[InvalidImageUrl]` и т. д. в скобках | Прочитайте подсказку в скобках; обычно это недоступный media URL или чувствительный prompt                 |

<Info>
  **Рекомендуемое поведение клиента**: повтор с экспоненциальным backoff при HTTP 5xx / network errors (1s / 4s / 16s); сразу показывайте HTTP 4xx без повтора; задачу `failed` с `[InvalidImageUrl]` можно повторить (возможно, временная проблема сети), а `[InvalidParameter]` / чувствительные слова не следует повторять.
</Info>

## FAQ

<AccordionGroup>
  <Accordion title="Почему я не могу использовать /v1/videos для отправки задач Wan?">
    `/v1/videos` — это эндпоинт OpenAI плоского формата с неполной поддержкой i2v / r2v для Wan: поля media, например `media`, отбрасываются, а upstream Alibaba Cloud возвращает `[InvalidParameter] Field required: input.media`. **Все запросы на создание видео Wan отправляются в `/wan/api/v1/services/aigc/video-generation/video-synthesis`**, а запросы на получение всегда идут в `/v1/tasks/{task_id}`.
  </Accordion>

  <Accordion title="Что делает заголовок X-DashScope-Async: enable? Он обязателен?">
    Он сообщает endpoint, что «это асинхронная задача, сразу верните task\_id и не блокируйте выполнение». **Он обязателен для каждого запроса на создание**; если его опустить, возвращается `current user api does not support synchronous calls`. Запрос на получение (GET) этот заголовок не требует.
  </Accordion>

  <Accordion title="Почему опрос идет через /v1/tasks/{id}, а не через /wan/api/v1/tasks/{id}?">
    APIYI нормализует все запросы на опрос видео-задач к `/v1/tasks/{task_id}`. Независимо от того, какой путь вы использовали для создания задачи, вы опрашиваете ее через этот единственный endpoint, а поля верхнего уровня ответа `status` / `progress` / `result_url` / `error` остаются согласованными.
  </Accordion>

  <Accordion title="загрузка result_url возвращает 403 / SignatureDoesNotMatch, что делать?">
    Уберите заголовок `Authorization`. `result_url` уже является предварительно подписанной прямой ссылкой Alibaba Cloud OSS; если добавить APIYI Key, OSS отклонит ее:

    ```bash theme={null}
    curl -L -o out.mp4 "$RESULT_URL"          # ✅ correct
    curl -L -H "Authorization: Bearer $KEY" -o out.mp4 "$RESULT_URL"   # ❌ wrong
    ```
  </Accordion>

  <Accordion title="Что если срок действия result_url истек?">
    По умолчанию ссылка действительна **24 часа**. После истечения срока снова выполните GET `/v1/tasks/{task_id}`, и обычно вы получите свежую `result_url`, но срок действия опроса по самому task\_id тоже составляет 24 часа (после этого возвращается `UNKNOWN`). Для долгосрочного хранения как можно скорее загрузите файл в свое хранилище.
  </Accordion>

  <Accordion title="прогресс завис на 30% — он завис?">
    Нет. Прогресс, который сообщает upstream Alibaba Cloud, имеет грубую градацию (только уровни 0% / 10% / 30% / 100%). **Пока `status` все еще `in_progress`, продолжайте ждать**; обычно он сразу прыгает с 30% до 100%.
  </Accordion>

  <Accordion title="Сколько задач один Key может выполнять параллельно?">
    На практике вы можете отправить 4-8 задач одновременно без упора в лимит запросов. В production держите одновременно активные задачи ≤10; все, что выше, уходит в очередь. У query API довольно высокий RPS по умолчанию, но интервал опроса в 5-10 секунд все равно рекомендуется.
  </Accordion>

  <Accordion title="Тарифицируются ли неудачные задачи?">
    `status=failed` не тарифицируется. Но учтите: повторная отправка той же задачи тарифицируется снова, поэтому сделайте ее идемпотентной. Во время тестирования можно отключить `prompt_extend` и использовать 720P / 5 seconds / short prompts, чтобы снизить стоимость за единицу.
  </Accordion>

  <Accordion title="Wan2.6 по-прежнему можно использовать?">
    Да. Серия Wan2.6 (включая `wan2.6-r2v-flash`) по-прежнему есть в списке доступных вызовов, с тем же протоколом, что и Wan2.7; достаточно изменить имя `model`. См. [Исторические версии](/ru/api-capabilities/wan/historical-versions).
  </Accordion>
</AccordionGroup>

## Настройка группы

Серии Wan и [HappyHorse](/ru/api-capabilities/happyhorse/overview) **используют одну группу `Wan&HappyHorse`** — один Token может вызывать обе серии. Видео-модели тарифицируются **за секунду**, поэтому Token должен соответствовать двум условиям, чтобы маршрутизация прошла успешно:

1. **Модель тарификации**: выберите **Pay-as-you-go Priority** или **Pay-as-you-go** — видео тарифицируется за секунду, поэтому **Token с Pay-per-request не может маршрутизироваться**
2. **Группа**: выберите группу, которая включает `Wan&HappyHorse`

<Frame caption="Create Token: set billing model to Pay-as-you-go Priority and group to Wan&HappyHorse (0.14x) to call every Wan2.7 and HappyHorse video model (the screenshot shows the group's former name Wan, since renamed to Wan&HappyHorse)">
  <img src="https://mintcdn.com/apiyillc/5-SttsT0c5VQwgVz/images/wan-token-group-setup-20260523.png?fit=max&auto=format&n=5-SttsT0c5VQwgVz&q=85&s=f46887cb88777eb34d70837983f1fc49" alt="Create Token dialog: billing model set to Pay-as-you-go Priority, group dropdown showing Wan&HappyHorse (rate 0.14x), one Token usable for both Wan2.7 and HappyHorse" width="1286" height="988" data-path="images/wan-token-group-setup-20260523.png" />
</Frame>

## Тарификация

### Цена по умолчанию = 98％ от официальной цены Alibaba (легко вычислить)

В консоли группа `Wan&HappyHorse` показывает коэффициент **0.14x**, который выражается во встроенной единице тарификации **RMB**. Поскольку APIYI ведет тарификацию в **USD** по фиксированному курсу 1:7, фактический пересчет такой:

```
0.14 (RMB pricing unit) × 7 (fixed exchange rate) = 0.98
```

Иными словами, **цена по умолчанию = 98% от официальной цены Alibaba** — дешевле, чем покупать напрямую у Alibaba, и без необходимости самостоятельно выстраивать зарубежный канал.

> Пересчет: **цена в USD за секунду = официальная цена в RMB × 0.14** (то есть `× 0.98 ÷ 7`). Например, официальная цена 1080P в ¥1.0/s → \$0.14/s, то есть ровно `0.14x`, который отображается в консоли.

### Подробности цены (цена по умолчанию, тарификация по секундам)

Wan2.7 text-to-video / image-to-video / reference-to-video тарифицируются одинаково, с двумя уровнями — `720P` / `1080P` (480P не поддерживается):

| Разрешение | Официальная цена | Наша цена по умолчанию /s | 5 s    | 10 s   | 12 s   |
| ---------- | ---------------- | ------------------------- | ------ | ------ | ------ |
| `720P`     | ¥0.6/s           | \$0.084/s                 | \$0.42 | \$0.84 | \$1.01 |
| `1080P`    | ¥1.0/s           | \$0.14/s                  | \$0.70 | \$1.40 | \$1.68 |

<Info>
  * `wan2.7-r2v` по умолчанию равен `1080P`, а длительность ограничена 10 секундами, если в reference media есть видео.
  * `wan2.7-videoedit` (редактирование видео) формирует выходную длительность по исходному видео и тарифицируется по фактическим секундам результата, а не по `duration`.
  * Указанные цены — это **цена по умолчанию (98% от официальной)**; с максимальным бонусом за пополнение эффективная цена примерно равна значению из таблицы **÷ 1.2** (например, 1080P 5 s \$0.70 → примерно \$0.58).
</Info>

### Ступенчатые бонусы за пополнение для еще более низкой эффективной цены

После подключения к [программе бонусов за пополнение](/ru/faq/recharge-promotions) зачисленный баланс можно увеличить примерно до \~1.2x, еще сильнее снижая эффективную цену:

```
0.98 ÷ 1.2 ≈ 0.816
```

Таким образом, крупные клиенты могут снизить цену вплоть до **\~81.6% от официальной цены**.

| Уровень                                                       | Эффективная цена (по сравнению с официальной ценой Alibaba) | Формула                                                |
| ------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------ |
| По умолчанию                                                  | **98%**                                                     | коэффициент тарифа 0.14x × фиксированный курс обмена 7 |
| С бонусами за пополнение (макс. уровень для крупных клиентов) | **\~81.6%**                                                 | 0.98 ÷ 1.2                                             |

<Info>
  * Единица тарификации = **уровень разрешения × длительность (секунды)**; неудачные задачи не тарифицируются.
  * 1:7 — это **фиксированный расчетный курс обмена** (не льготный); он единообразно применяется ко всем пополнениям в USD.
  * Для самых высоких уровней бонусов и подходящих каналов см. [бонусы за пополнение](/ru/faq/recharge-promotions). Актуальный курс является приоритетным в [консоли](https://api.apiyi.com/token).
</Info>

## Связанные документы

<CardGroup cols={2}>
  <Card title="Песочница Text-to-Video" icon="wand-sparkles" href="/ru/api-capabilities/wan/text-to-video">
    `wan2.7-t2v` отладка в реальном времени + примеры кода
  </Card>

  <Card title="Песочница Image-to-Video" icon="image" href="/ru/api-capabilities/wan/image-to-video">
    `wan2.7-i2v` первый кадр + управляющее аудио
  </Card>

  <Card title="Песочница Reference-to-Video" icon="users" href="/ru/api-capabilities/wan/reference-to-video">
    `wan2.7-r2v` многообъектный референс + голос
  </Card>

  <Card title="Песочница Video Edit" icon="scissors" href="/ru/api-capabilities/wan/video-edit">
    `wan2.7-videoedit` замена одежды / фона
  </Card>

  <Card title="Исторические версии (Wan2.6)" icon="history" href="/ru/api-capabilities/wan/historical-versions">
    серия Wan2.6 и заметки по миграции
  </Card>

  <Card title="Серия HappyHorse" icon="monitor-play" href="/ru/api-capabilities/happyhorse/overview">
    Также на базе Alibaba, руководство по сравнению и выбору
  </Card>
</CardGroup>

<Info>
  Официальная документация Alibaba Cloud (справка): `help.aliyun.com/zh/model-studio/text-to-video-api-reference`. По вопросам или предложениям, пожалуйста, откройте обращение в [консоли APIYI](https://api.apiyi.com).
</Info>