> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API генерации видео Wan 2.7 и Wan 3.0: цены и подключение

> Как создавать задачи Wan 2.7 и Wan 3.0 — текст в видео, изображение в видео, видео по референсам и редактирование видео, скачивать MP4 и проверять цену за секунду.

Wan 2.7 и Wan 3.0 работают через асинхронные задачи в формате DashScope. Нужен токен из группы `Wan`, оплата идёт за секунды видео.

| Параметр | Значение |
| - | - |
| Модели Wan 3.0 | `wan3.0-video` (стандартная) и `wan3.0-video-prime` (быстрее); каждая выполняет текст, изображение и референсы в видео, а также редактирование видео |
| Модели Wan 2.7 | `wan2.7-t2v` (текст в видео), `wan2.7-i2v` (изображение в видео), `wan2.7-r2v` (видео по референсам), `wan2.7-videoedit` (редактирование видео) |
| Модели Wan 2.6 | Выведены 14 октября 2026 года; используйте Wan 2.7 или Wan 3.0 |
| Создание задачи | `POST /wan/api/v1/services/aigc/video-generation/video-synthesis` |
| Опрос задачи | `GET /v1/tasks/{task_id}`, затем скачивание MP4 по `result_url` |
| Группа токена | `Wan`; см. раздел «Создание токена Wan» |
| Оплата | За секунду видео, около 1.2× от списочной цены Alibaba Cloud; цены по моделям — в разделе «Оплата и цены» |
| Срок хранения результата | Alibaba Cloud хранит `task_id` и ссылку на видео 24 часа, поэтому сохраняйте видео сразу после завершения задачи |
| Правила запросов | Базовый URL, аутентификация, заголовок асинхронного режима, интервал опроса и таймаут — в разделе «Эндпоинты и правила запросов» |

> [!WARNING]
>
> **Не отправляйте запросы Wan на `/v1/videos`.**
>
> * Задачам «изображение в видео», «видео по референсам» и редактированию видео нужно тело DashScope с `input.media[]`.
> * Поэтому создавайте все задачи Wan через эндпоинт из таблицы выше.

## Создание токена Wan

| Настройка | Значение |
| - | - |
| Консоль | [Управление токенами](https://api.laozhang.ai/token) → создать токен |
| Группа | `Wan` |
| Режим оплаты | Сначала по использованию (в консоли — 按量优先, рекомендуется) или оплата по использованию (按量计费) |
| Заголовок запроса | `Authorization: Bearer $LAOZHANG_API_KEY` |

Модели Wan доступны только в группе `Wan`, поэтому токен должен принадлежать ей. Токены других групп, например `default` или `SeeDance2`, эти модели вызвать не могут: запрос завершится ошибкой «нет канала». Отдельный токен для Wan к тому же упрощает проверку журнала и списаний по моделям и задачам.

## Оплата и цены

Видео Wan оплачивается посекундно по списочной цене Alibaba Cloud Model Studio плюс 20%. Надбавка покрывает налоги, конвертацию валют и трансграничные расчёты, эксплуатацию платформы и техническую поддержку. С 14 октября 2026 года цена пересчитывается так:

* цена за секунду в долларах = списочная цена Alibaba Cloud за секунду в юанях × 0.1714 (множитель группы `Wan`)
* при фиксированном курсе 1:7 получается 0.1714 × 7 ≈ 1.2, то есть вы платите около 1.2× от списочной цены

Суммы в журнале вызовов уже учитывают множитель, повторно его применять не нужно. Цены за секунду:

| Модель | Разрешение | Списочная цена Alibaba Cloud | За секунду |
| - | - | -: | -: |
| `wan3.0-video` | 480P / 720P / 1080P | ¥0.3 / ¥0.6 / ¥1.2 | \$0.0514 / \$0.1028 / \$0.2057 |
| `wan3.0-video-prime` | 480P / 720P / 1080P | ¥0.45 / ¥0.9 / ¥1.8 | \$0.0771 / \$0.1543 / \$0.3085 |
| Все четыре модели Wan 2.7 | 720P / 1080P | ¥0.6 / ¥1.0 | \$0.1028 / \$0.1714 |

Модели Wan 2.7 для текста в видео, изображения в видео, видео по референсам и редактирования видео (`wan2.7-t2v`, `wan2.7-i2v`, `wan2.7-r2v` и `wan2.7-videoedit`) стоят одинаково. Цены Alibaba Cloud указаны для региона China North 2 (Пекин) на странице [цен Model Studio](https://help.aliyun.com/zh/model-studio/model-pricing) (на китайском).

Как считаются оплачиваемые секунды:

* **Только выход** (текст в видео, изображение в видео, только референсные изображения): секунды созданного видео.
* **С входным видео**: секунды входа плюс секунды выхода — то же правило, что у Alibaba Cloud.
  * `wan2.7-videoedit`: исходное видео плюс результат. Если задать `duration` от 2 до 10 секунд, исходное видео обрезается с начала, и учитывается только обрезанная часть.
  * `wan2.7-r2v` с референсным видео: до 5 секунд референсного видео плюс результат.
  * Wan 3.0 с `reference_video` (референсы, редактирование или продление): все секунды входного видео плюс результат.
* **Без `resolution`**: и Wan 2.7, и Wan 3.0 по умолчанию выдают 1080P и оплачиваются по цене 1080P.

Примеры стоимости:

* `wan2.7-i2v`, 720P, 5 секунд: 5 × \$0.1028 ≈ \$0.51
* `wan3.0-video`, 1080P, 10 секунд: 10 × \$0.2057 ≈ \$2.06
* `wan2.7-videoedit` для 5-секундного ролика в 720P: (5 + 5) × \$0.1028 ≈ \$1.03

При создании задачи запрошенная длительность списывается заранее. Когда задача завершается, списание пересчитывается по секундам, которые сообщил Alibaba Cloud, и разница возвращается или доплачивается. Для задач Wan 3.0 с входным видео заранее списываются 30 секунд, а разница возвращается после завершения, поэтому баланса должно хватать на это удержание.

Неудавшиеся задачи не оплачиваются, но одна и та же задача, отправленная дважды, оплачивается дважды. Связывайте собственный ID операции с каждым `task_id` и не делайте безусловных автоматических повторов.

Фактическое списание по каждой задаче видно в [журнале вызовов](https://api.laozhang.ai/log). Если за неудавшуюся задачу всё же есть списание, напишите в [поддержку](mailto:hi@laozhang.ai) и укажите ID задачи.

Стоимость определяют длительность и разрешение результата, поэтому передавайте `duration` и `resolution` явно и оценивайте стоимость по таблице до создания задачи. Модели Wan и их группа перечислены на странице [Цены на API моделей ИИ](https://docs.laozhang.ai/ru/models.md).

> [!TIP]
>
> Для коротких роликов около 720p со звуком [MiniMax H3](https://docs.laozhang.ai/ru/api-capabilities/minimax-h3-video-generation.md) стоит \$0.25 за 5 секунд при 768P, а [Видео Muse](https://docs.laozhang.ai/ru/api-capabilities/muse-video-generation.md) — \$0.30 за 10 секунд; для обеих моделей хватает токена группы `default`. Все модели сравниваются в разделе [Сравнение API видео](https://docs.laozhang.ai/ru/api-capabilities/video-generation-guide.md).

## Как работает задача Wan

**1. Создайте задачу**

Отправьте `POST /wan/api/v1/services/aigc/video-generation/video-synthesis` с телом JSON и заголовком `X-DashScope-Async: enable`. Сохраните `output.task_id` из ответа.

**2. Опрашивайте задачу**

Отправляйте `GET /v1/tasks/{task_id}` каждые 5–10 секунд. Решения принимайте по полю `status` верхнего уровня, а не по вложенным полям исходного ответа модели.

**3. Скачайте видео**

Когда `status` станет `completed`, скачайте MP4 по `result_url` верхнего уровня. Это подписанная ссылка на объектное хранилище, поэтому не передавайте с ней заголовок `Authorization` от LaoZhang API.

Полные правила запросов, статусы задач и описание полей идут после примеров, начиная с раздела «Эндпоинты и правила запросов».

## Подготовка окружения

В примерах для оболочки используются `curl` и `jq` (установить jq можно командой `brew install jq` или `sudo apt-get install jq`). Задайте ключ и базовый URL один раз:

```bash theme={null}
export LAOZHANG_API_KEY="YOUR_API_KEY"   # замените на свой API-ключ LaoZhang API
export BASE_URL="https://api.laozhang.ai"
```

Каждый пример создания ниже сохраняет ответ в `create.json`, который затем читает шаг из раздела «Опрос задачи и скачивание видео».

## Текст в видео

```bash theme={null}
curl -sS -X POST "$BASE_URL/wan/api/v1/services/aigc/video-generation/video-synthesis" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-DashScope-Async: enable" \
  --data-raw '{
    "model": "wan2.7-t2v",
    "input": {
      "prompt": "A lighthouse at sunset, slow cinematic push-in, ocean waves hitting rocks, seabirds in the distance"
    },
    "parameters": {
      "resolution": "720P",
      "duration": 5,
      "prompt_extend": true,
      "watermark": true
    }
  }' | tee create.json
```

В ответе на создание ID задачи находится в `output.task_id`:

```json theme={null}
{
  "output": {
    "task_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "task_status": "PENDING"
  },
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
```

Если в ответе нет `output.task_id`, прочитайте сообщение об ошибке в `create.json` и сверьтесь с таблицей в разделе «Устранение неполадок».

## Изображение в видео

```bash theme={null}
curl -sS -X POST "$BASE_URL/wan/api/v1/services/aigc/video-generation/video-synthesis" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-DashScope-Async: enable" \
  --data-raw '{
    "model": "wan2.7-i2v",
    "input": {
      "prompt": "A graffiti character comes alive and performs energetic rap under a railway bridge at night",
      "media": [
        {
          "type": "first_frame",
          "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
        },
        {
          "type": "driving_audio",
          "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/ozwpvi/rap.mp3"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "duration": 10,
      "prompt_extend": true,
      "watermark": true
    }
  }' | tee create.json
```

`driving_audio` необязателен. Alibaba Cloud использует аудио, чтобы управлять видео, например синхронизировать губы или движения с ритмом, как в примере с рэпом выше. Аудио работает только вместе с изображением `first_frame` и, как и остальные медиафайлы, должно быть доступно по публичному HTTPS-URL.

Допустимые форматы, длительность и размер аудиофайла описаны в [справочнике API Wan 2.7 «изображение в видео»](https://help.aliyun.com/zh/model-studio/image-to-video-general-api-reference) Alibaba Cloud (на китайском).

## Видео по референсам

```bash theme={null}
curl -sS -X POST "$BASE_URL/wan/api/v1/services/aigc/video-generation/video-synthesis" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-DashScope-Async: enable" \
  --data-raw '{
    "model": "wan2.7-r2v",
    "input": {
      "prompt": "A girl wearing the referenced dress walks slowly through a sunset garden with cinematic lighting",
      "media": [
        {
          "type": "reference_image",
          "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/fwjpqf/wan2.7-videoedit-change-clothes.png"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "duration": 5,
      "prompt_extend": true,
      "watermark": true
    }
  }' | tee create.json
```

## Редактирование видео

```bash theme={null}
curl -sS -X POST "$BASE_URL/wan/api/v1/services/aigc/video-generation/video-synthesis" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-DashScope-Async: enable" \
  --data-raw '{
    "model": "wan2.7-videoedit",
    "input": {
      "prompt": "Dress the girl in the video in the outfit shown in the reference image",
      "media": [
        {
          "type": "video",
          "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260403/nlspwm/T2VA_22.mp4"
        },
        {
          "type": "reference_image",
          "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/fwjpqf/wan2.7-videoedit-change-clothes.png"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "prompt_extend": true,
      "watermark": true
    }
  }' | tee create.json
```

## Генерация видео Wan 3.0

Wan 3.0 не делит задачи по разным ID моделей. Одна модель читает элементы `input.media[]` и сама определяет, что нужно: текст в видео, изображение в видео, видео по референсам или редактирование видео. Возможности у двух моделей одинаковые:

* `wan3.0-video` — стандартная модель;
* `wan3.0-video-prime` — более быстрая модель с более высокой ценой за секунду.

Обе используют тот же эндпоинт создания, а опрос и скачивание работают так же, как у Wan 2.7.

| Задача | `input.media[]` |
| - | - |
| Текст в видео | Не передавайте `media` |
| Первый кадр или первый и последний кадры | Один `first_frame` и необязательный `last_frame` |
| Видео по референсам | До 10 элементов `reference_image`; до 5 элементов `reference_video` и до 5 `reference_audio`, каждого типа не больше 15 секунд суммарно |
| Редактирование или продление видео | Один `reference_video`, а правка или продление описываются в `prompt`; при продлении задайте `ratio` равным `adaptive` |

В промптах для видео по референсам можно ссылаться на входные данные как «image 1», «video 1» или «audio 1» (图1, 视频1, 音频1); нумерация идёт по порядку среди входных данных одного типа.

Некоторые поля `parameters` работают иначе, чем в Wan 2.7:

| Поле | Значения |
| - | - |
| `resolution` | `480P`, `720P` или `1080P`; по умолчанию `1080P` |
| `duration` | Целое число секунд от 2 до 30; по умолчанию 5. С входным видео вход и выход вместе не могут превышать 30 секунд |
| `ratio` | `adaptive` (по умолчанию, соотношение выбирается по входным данным), `21:9`, `16:9`, `4:3`, `1:1`, `3:4` или `9:16` |
| `audio` | По умолчанию `true` — видео со звуком; `false` — беззвучное видео по той же цене |

Минимальный запрос «текст в видео»:

```bash theme={null}
curl -sS -X POST "$BASE_URL/wan/api/v1/services/aigc/video-generation/video-synthesis" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-DashScope-Async: enable" \
  --data-raw '{
    "model": "wan3.0-video",
    "input": {
      "prompt": "A kitten runs across moonlit rooftops while neon signs flicker in the distance, cinematic, smooth camera movement"
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5
    }
  }' | tee create.json
```

Чтобы изменить стиль готового ролика, передайте его как `reference_video`. В оплачиваемые секунды входит и входное видео (см. раздел «Оплата и цены»).

```bash theme={null}
curl -sS -X POST "$BASE_URL/wan/api/v1/services/aigc/video-generation/video-synthesis" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-DashScope-Async: enable" \
  --data-raw '{
    "model": "wan3.0-video-prime",
    "input": {
      "prompt": "Turn the whole scene into claymation",
      "media": [
        {
          "type": "reference_video",
          "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "adaptive"
    }
  }' | tee create.json
```

Как и раньше, возьмите `TASK_ID` из `create.json`, затем опросите задачу и скачайте видео, как описано в следующем разделе. Другие типы входных данных, например документ (`file`) или веб-страница (`link`), описаны в [справочнике API генерации видео Wan3.0](https://help.aliyun.com/zh/model-studio/wan3-video-generation-api-reference) Alibaba Cloud (на китайском).

## Опрос задачи и скачивание видео

Возьмите ID задачи из `create.json` и проверьте задачу:

```bash theme={null}
TASK_ID=$(jq -r '.output.task_id' create.json)

curl -sS "$BASE_URL/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" | tee task.json | jq '{status, progress}'
```

Повторяйте запрос каждые 5–10 секунд, пока `status` не перестанет быть `submitted` или `in_progress`.

Завершённая задача выглядит так. Опирайтесь на поля верхнего уровня `status` и `result_url`:

```json theme={null}
{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "task_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "object": "task",
  "platform": "wan",
  "action": "text_to_video",
  "task_type": "text_to_video",
  "status": "completed",
  "progress": "100%",
  "result_url": "https://dashscope-xxx.oss-accelerate.aliyuncs.com/...",
  "result": {
    "data": {
      "model": "wan2.7-t2v",
      "parameters": {
        "resolution": "720P",
        "duration": 5,
        "prompt_extend": true,
        "watermark": true
      }
    }
  }
}
```

Скачивайте видео без заголовка `Authorization`. `result_url` — подписанная ссылка на объектное хранилище, и лишний заголовок аутентификации может привести к ошибке 403.

```bash theme={null}
RESULT_URL=$(jq -r '.result_url' task.json)
curl -L -o wan-output.mp4 "$RESULT_URL"
```

## Клиент на Python

Клиент использует только стандартную библиотеку Python (Python 3.8 и новее). Он создаёт задачу «текст в видео», опрашивает её до 20 минут и сохраняет MP4.

```python theme={null}
import json
import os
import time
import urllib.request
from urllib.error import HTTPError

BASE_URL = "https://api.laozhang.ai"
API_KEY = os.environ["LAOZHANG_API_KEY"]
POLL_INTERVAL = 10   # секунд между проверками статуса
TIMEOUT = 20 * 60    # перестаём ждать через 20 минут


def request(method, path, body=None, extra_headers=None):
    headers = {"Authorization": f"Bearer {API_KEY}"}
    if extra_headers:
        headers.update(extra_headers)
    data = None
    if body is not None:
        headers["Content-Type"] = "application/json"
        data = json.dumps(body).encode("utf-8")
    req = urllib.request.Request(BASE_URL + path, data=data, method=method, headers=headers)
    try:
        with urllib.request.urlopen(req, timeout=60) as resp:
            return json.loads(resp.read().decode("utf-8"))
    except HTTPError as exc:
        error_body = exc.read().decode("utf-8", errors="replace")
        raise RuntimeError(f"HTTP {exc.code}: {error_body}") from exc


created = request(
    "POST",
    "/wan/api/v1/services/aigc/video-generation/video-synthesis",
    {
        "model": "wan2.7-t2v",
        "input": {"prompt": "A lighthouse at sunset, cinematic light, slow push-in"},
        "parameters": {"resolution": "720P", "duration": 5, "prompt_extend": True},
    },
    {"X-DashScope-Async": "enable"},
)
task_id = created["output"]["task_id"]
print("ID задачи:", task_id)

deadline = time.monotonic() + TIMEOUT
while True:
    task = request("GET", f"/v1/tasks/{task_id}")
    status = str(task.get("status", "")).lower()
    print("Статус:", status, task.get("progress", ""))

    if status == "completed":
        # result_url — подписанная ссылка: скачиваем без заголовка Authorization.
        urllib.request.urlretrieve(task["result_url"], "wan-output.mp4")
        print("Сохранено: wan-output.mp4")
        break
    if status not in ("submitted", "in_progress"):
        # failed или любое другое конечное состояние
        detail = task.get("error") or task.get("fail_reason") or task
        raise RuntimeError(f"Задача {task_id} завершилась со статусом {status!r}: {detail}")
    if time.monotonic() > deadline:
        raise TimeoutError(f"Задача {task_id} не завершилась за 20 минут")
    time.sleep(POLL_INTERVAL)
```

## Эндпоинты и правила запросов

```text theme={null}
Создать задачу     POST /wan/api/v1/services/aigc/video-generation/video-synthesis
Статус задачи      GET  /v1/tasks/{task_id}
Скачать MP4        GET  {result_url}   (подписанная ссылка; без заголовка Authorization)
```

| Настройка | Значение |
| - | - |
| Базовый URL | `https://api.laozhang.ai` |
| Аутентификация | `Authorization: Bearer $LAOZHANG_API_KEY` |
| Тело запроса на создание | `application/json` |
| Обязательный заголовок при создании | `X-DashScope-Async: enable` |
| Интервал опроса | 5–10 секунд |
| Таймаут клиента | 20 минут |

## Статусы задачи

Принимайте решения по полю `status` верхнего уровня, которое возвращает `GET /v1/tasks/{task_id}`:

| Статус | Конечный | Что делать |
| - | - | - |
| `submitted` | Нет | Задача принята. Продолжайте опрос. |
| `in_progress` | Нет | Видео генерируется. Продолжайте опрос. |
| `completed` | Да | Скачайте MP4 по `result_url`. |
| `failed` | Да | Прочитайте `error.message` или `fail_reason` и прекратите опрос. |
| Любое другое значение | Да | Прекратите опрос и сохраните ответ целиком. Если видео ещё нужно, создайте новую задачу. |

В ответе на создание есть и `output.task_status` — исходное состояние DashScope, у новой задачи обычно `PENDING`. Используйте его только для того, чтобы убедиться, что задача принята, а дальше ориентируйтесь на `status` верхнего уровня из `GET /v1/tasks/{task_id}`.

Продолжайте опрос, только пока статус равен `submitted` или `in_progress`. Любое другое значение считайте конечным — например, если задача отменена или вы запрашиваете её позже чем через 24 часа. Так неожиданное состояние не заставит клиент опрашивать задачу бесконечно.

Прогресс у Wan грубый: `progress` может долго стоять на `30%`, а затем сразу перескочить на `100%`.

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

| ID модели | Задача | `input.media[]` |
| - | - | - |
| `wan2.7-t2v` | Текст в видео | Не передавайте `media` |
| `wan2.7-i2v` | Изображение в видео, при желании с управляющим аудио | Один `first_frame`; необязательные `last_frame` и `driving_audio` |
| `wan2.7-r2v` | Видео по референсам | Всего 1–5 элементов `reference_image` и `reference_video` |
| `wan2.7-videoedit` | Редактирование видео | Один `video` (2–10 секунд); до 4 необязательных `reference_image` |
| `wan3.0-video`, `wan3.0-video-prime` | Текст, изображение и референсы в видео; редактирование и продление видео | Зависит от задачи; см. раздел «Генерация видео Wan 3.0» выше |

Модели Wan 2.6 (`wan2.6-t2v`, `wan2.6-i2v`, `wan2.6-r2v` и `wan2.6-r2v-flash`) выведены 14 октября 2026 года. Если вы ещё их вызываете, перейдите на соответствующую модель Wan 2.7 или на Wan 3.0.

ID моделей взяты из публичного прайс-листа LaoZhang API на 14 октября 2026 года. `wan2.7-image-pro` — модель изображений, с этим видео-эндпоинтом она не работает.

## Тело запроса

| Поле | Тип | Обязательное | Примечания |
| - | - | - | - |
| `model` | string | Да | ID модели, например `wan2.7-t2v` |
| `input.prompt` | string | Зависит от модели | Промпт на естественном языке; обязателен для текста в видео и видео по референсам, необязателен для изображения в видео и редактирования видео |
| `input.media` | array | Зависит от модели | Для текста в видео не передавайте; для остальных задач обязательно |
| `parameters.resolution` | string | Нет | Wan 2.7: `720P` или `1080P`; Wan 3.0 принимает также `480P`. `P` — заглавная |
| `parameters.duration` | integer | Нет | Целое число секунд; `wan2.7-t2v` принимает 2–15. Передавайте число, а не строку |
| `parameters.prompt_extend` | boolean | Нет | Разрешает модели расширить промпт |
| `parameters.watermark` | boolean | Нет | Добавляет водяной знак «создано ИИ» |
| `parameters.seed` | integer | Нет | Seed для более воспроизводимого результата |

Допустимые значения у моделей разные. Диапазоны выше взяты из [справочника API «текст в видео»](https://help.aliyun.com/zh/model-studio/text-to-video-api-reference) Alibaba Cloud. Для остальных моделей смотрите справочник Alibaba Cloud по нужной модели (на китайском):

* [Wan 2.7: изображение в видео](https://help.aliyun.com/zh/model-studio/image-to-video-general-api-reference)
* [Wan 2.7: видео по референсам](https://help.aliyun.com/zh/model-studio/wan-video-to-video-api-reference)
* [Wan 2.7: редактирование видео](https://help.aliyun.com/zh/model-studio/wan-video-editing-api-reference)
* [Wan 3.0: генерация видео](https://help.aliyun.com/zh/model-studio/wan3-video-generation-api-reference)

### Медиаданные на входе

| `type` | Назначение |
| - | - |
| `first_frame` | Первый кадр для изображения в видео; `wan2.7-r2v` тоже принимает один такой элемент |
| `last_frame` | Последний кадр, если выбранная модель его поддерживает |
| `reference_image` | Референсное изображение для видео по референсам или редактирования видео |
| `reference_video` | Референсное видео: в `wan2.7-r2v` задаёт персонажа и его голос; в Wan 3.0 это ещё и ролик для редактирования или продления |
| `reference_audio` | Референсное аудио для Wan 3.0 |
| `driving_audio` | Аудио, управляющее задачей «изображение в видео» в `wan2.7-i2v` |
| `video` | Исходное видео для редактирования в `wan2.7-videoedit` |
| `file`, `link` | Референсный документ или публичная веб-страница для Wan 3.0; передавайте что-то одно |

Каждый `url` медиафайла должен быть публичной HTTPS-ссылкой, которую Alibaba Cloud может скачать напрямую. Ссылки за входом в аккаунт или cookie, адреса частных сетей и ссылки, которые истекают раньше запуска задачи, могут привести к её сбою.

## Советы для рабочей среды

* **Сначала сохраните ID задачи.** Записывайте `output.task_id` вместе с собственным ID операции сразу после ответа на создание: тогда перезапущенный обработчик продолжит опрос, а не создаст дубликат.
* **Проверяйте, прежде чем повторять создание.** Каждый принятый запрос на создание запускает отдельную задачу. Если запрос на создание завершился таймаутом, сверьтесь со своими записями и журналом вызовов, прежде чем отправлять его снова.
* **Ограничивайте опрос.** Проверяйте каждые 5–10 секунд, останавливайтесь через 20 минут и считайте конечным любой статус, кроме `submitted` и `in_progress`.
* **Скачивайте сразу.** Alibaba Cloud хранит ID задачи и ссылку на видео 24 часа. Копируйте MP4 в своё хранилище и отдавайте пользователям собственную ссылку, а не подписанную.
* **Держите входные данные доступными.** Размещайте медиафайлы по публичным HTTPS-ссылкам, которые работают до завершения задачи.
* **Контролируйте стоимость.** Задавайте `duration` и `resolution` явно и проверяйте списание по каждой задаче в журнале вызовов.
* **Один токен на приложение.** Отдельный токен группы `Wan` для каждого приложения или окружения упрощает проверку журнала и списаний.

## Устранение неполадок

| Симптом | Вероятная причина | Решение |
| - | - | - |
| `未提供令牌` (токен не передан) | Нет заголовка `Authorization` | Передайте `Authorization: Bearer $LAOZHANG_API_KEY` |
| `Current group Wan has no available channels for model ...` | Неверный ID модели, выведенная модель вроде Wan 2.6 или модель не подключена к группе `Wan` | Сверьте ID с таблицей моделей. Если он верный, напишите в [поддержку](mailto:hi@laozhang.ai) и укажите ID модели и время запроса |
| `[InvalidParameter] Field required: input.media` | Нет `media`, или запрос ушёл на `/v1/videos` | Используйте эндпоинт задач Wan и передайте `input.media[]` |
| `任务不存在` (задача не найдена) | Неверный ID задачи, или задаче больше 24 часов | Используйте точный `output.task_id`; если срок истёк, создайте новую задачу |
| Скачивание возвращает 403 | Передан заголовок `Authorization`, или ссылке больше 24 часов | Скачивайте без `Authorization`; если ссылка истекла, создайте новую задачу |

## Частые вопросы

### Сколько стоит 5-секундное видео?

По ценам, действующим с 14 октября 2026 года, для задачи, которая только выводит видео:

* `wan3.0-video`: около \$0.51 при 720P и \$1.03 при 1080P
* `wan3.0-video-prime`: около \$0.77 при 720P и \$1.54 при 1080P
* Wan 2.7: около \$0.51 при 720P и \$0.86 при 1080P

Стоимость растёт вместе с длительностью, так что 10 секунд стоят примерно вдвое больше. Без `resolution` задача оплачивается по цене 1080P, а к задачам с входным видео добавляются входные секунды (см. раздел «Оплата и цены»).

### Обязательно ли передавать `X-DashScope-Async: enable`?

Да, в каждом запросе на создание. HTTP API Wan работает только асинхронно, и `POST` на создание без этого заголовка завершается ошибкой `current user api does not support synchronous calls`.

Для опроса `GET /v1/tasks/{task_id}` и скачивания по `result_url` заголовок не нужен.

### Что получится, если не передать `resolution` и `duration`?

Вы получите видео 1080P. Согласно справочникам API Alibaba Cloud, все четыре модели Wan 2.7 (`wan2.7-t2v`, `wan2.7-i2v`, `wan2.7-r2v` и `wan2.7-videoedit`) и Wan 3.0 по умолчанию выдают 1080P:

* Текст в видео, изображение в видео и видео по референсам по умолчанию длятся 5 секунд.
* Редактирование видео в Wan 2.7 сохраняет длительность исходного видео.

Поэтому задача «текст в видео» без параметров оплачивается как 5 секунд в 1080P:

* Wan 2.7: около \$0.86
* `wan3.0-video`: около \$1.03
* `wan3.0-video-prime`: около \$1.54

Примеры на этой странице явно задают `720P`. Чтобы стоимость была предсказуемой, задавайте `resolution` и `duration` в каждом запросе и оценивайте цену по разделу «Оплата и цены».

### Как сделать вертикальное или квадратное видео?

Для текста в видео и видео по референсам задайте `parameters.ratio`; остальные задачи повторяют форму входных данных:

* **Текст в видео и видео по референсам:** одно из соотношений ниже.
  * `16:9` (по умолчанию)
  * `9:16` (например, при 720P получится видео 720×1280)
  * `1:1`
  * `4:3`
  * `3:4`
* **Изображение в видео:** `ratio` не принимает и повторяет форму первого кадра.
* **Редактирование видео:** сохраняет форму исходного видео, если не задать `ratio`.
* **Wan 3.0:** по умолчанию `adaptive` (соотношение выбирается по входным данным), дополнительно принимает `21:9`.

Цена зависит только от уровня разрешения и секунд результата, поэтому горизонтальное, вертикальное и квадратное видео при одном уровне стоят одинаково. Допустимые значения по моделям — в [справочнике API «текст в видео»](https://help.aliyun.com/zh/model-studio/text-to-video-api-reference) Alibaba Cloud (на китайском).

### Есть ли в видео звук и можно ли озвучить персонажа своим аудио?

Да, и то и другое. По данным Alibaba Cloud, Wan 2.7 по умолчанию выдаёт видео со звуком: модель создаёт фоновую музыку, звуковые эффекты или голоса под картинку.

Чтобы синхронизировать движение губ со своим аудио, используйте `wan2.7-i2v` и добавьте элемент `driving_audio` в `input.media[]`, как в разделе «Изображение в видео». Аудио должно быть в формате WAV или MP3 длиной 2–30 секунд; всё, что длиннее `duration`, обрезается.

Wan 3.0 тоже по умолчанию выдаёт звук. Для беззвучного видео передайте `"audio": false`, цена от этого не меняется.

Видео по референсам может повторно использовать голос из референсного видео, а редактирование видео — сохранить исходный звук. Нужные параметры описаны в справочниках API Wan 2.7 [«видео по референсам»](https://help.aliyun.com/zh/model-studio/wan-video-to-video-api-reference) и [«редактирование видео»](https://help.aliyun.com/zh/model-studio/wan-video-editing-api-reference) (оба на китайском).

### Как убрать водяной знак «AI 生成»?

Передайте `"watermark": false` в `parameters` или вообще не передавайте `watermark`: по умолчанию Alibaba Cloud водяной знак не добавляет. Примеры на этой странице передают `true`, поэтому в их видео водяной знак стоит в правом нижнем углу; перед использованием примеров в рабочей среде измените это значение.

### Можно ли отправить задачу заново после таймаута или ошибки?

Сначала проверьте задачу. Таймаут на стороне клиента не означает, что задача не выполнена: продолжайте опрашивать тот же `task_id` до 24 часов, потому что новый запрос на создание запустит вторую задачу и будет оплачен ещё раз. Создавайте новую задачу только после того, как `status` станет `failed` или другим конечным значением, и сначала исправьте запрос.

Неудавшиеся задачи не оплачиваются, а фактическое списание по каждой задаче видно в [журнале вызовов](https://api.laozhang.ai/log). Подробнее — в разделах «Оплата и цены» и «Статусы задачи».

### Почему у одной задачи две строки списания в журнале вызовов?

Запрошенная длительность списывается при создании задачи, а при завершении проводится расчёт:

* Если Alibaba Cloud сообщает то же число секунд, в журнале одна строка списания.
* Если секунды отличаются, вторая строка («Wan 任务完成，按实际时长调整») возвращает или доплачивает разницу.

Обычно причина — входное видео, секунды которого тоже оплачиваются. Для задач Wan 3.0 с входным видео заранее списываются 30 секунд, а разница возвращается после завершения. Реальная стоимость задачи — сумма двух строк (см. раздел «Оплата и цены»).

### Задача зависла, если `progress` стоит на 30%?

Нет. Сервис модели сообщает прогресс крупными шагами, поэтому остановка на `30%` — это нормально. Продолжайте опрос, пока `status` верхнего уровня равен `in_progress` (см. раздел «Статусы задачи»).

## Связанные материалы

* [API генерации видео Seedance 2.0](https://docs.laozhang.ai/ru/api-capabilities/seedance2-video-generation.md) — второе семейство видеомоделей в LaoZhang API
* [Sora 2 API закрыт: как перейти на Wan или Seedance](https://docs.laozhang.ai/ru/api-capabilities/sora2/official-forward.md)
* [Цены на API моделей ИИ](https://docs.laozhang.ai/ru/models.md)
* [Как проверить доступность модели](https://docs.laozhang.ai/en/faq/model-availability.md)
* [Как просматривать журнал вызовов](https://docs.laozhang.ai/en/faq/call-logs.md)
* [Границы обработки данных и логов](https://docs.laozhang.ai/en/faq/data-security.md)
* Alibaba Cloud (на китайском): [справочник API «текст в видео»](https://help.aliyun.com/zh/model-studio/text-to-video-api-reference), [справочник API Wan 2.7 «изображение в видео»](https://help.aliyun.com/zh/model-studio/image-to-video-general-api-reference) и [цены Model Studio](https://help.aliyun.com/zh/model-studio/model-pricing)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.