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

# Wan2.6 Генерация видео

> Генерация высококачественных видео с помощью модели Alibaba Cloud Wan2.6 — поддержка текст-в-видео, изображение-в-видео и референсного видео

> [!NOTE]
>
> **Для пользователей из материкового Китая:** используйте `https://toapis.cn` в качестве эндпоинта (Base URL). Замените `https://toapis.com` на `https://toapis.cn` во всех примерах этого документа.

* Модель генерации видео Alibaba Cloud Wanxiang
* Поддержка **трёх режимов**: текст-в-видео, изображение-в-видео и референсное видео (r2v)
* Сервер автоматически выбирает нужную модель на основе параметров запроса
* Поддержка разрешений 720p/1080p, длительность 5/10/15 секунд
* Не-Flash версия всегда включает аудио в выходное видео

> [!WARNING]
>
> **Важное изменение**: Для повышения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 напрямую в `image_urls`. Пожалуйста, сначала используйте [API загрузки изображений](https://docs.toapis.com/docs/ru/api-reference/uploads/images.md) для загрузки изображений и получения URL, а затем вызывайте этот эндпоинт.

## Логика маршрутизации

Сервер автоматически выбирает модель на основе параметров запроса:

| Переданные параметры | Режим |
| - | - |
| `metadata.reference_urls` (URL видео) | Референсное видео (r2v) |
| `image_urls` (изображение) | Изображение-в-видео (i2v) |
| Только `prompt` | Текст-в-видео (t2v) |

## Аутентификация

**Authorization** `string` *required*

Все API требуют аутентификации Bearer Token

Получите API Key на [странице управления API ключами](https://toapis.com/console/token)

Добавьте в заголовок запроса:

```
Authorization: Bearer YOUR_API_KEY
```

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

**model** `string` *required*

Название модели генерации видео, фиксированное значение `wan2.6`

**prompt** `string` *required*

Описание содержимого видео

Обязательно для режима текст-в-видео; опционально для изображение-в-видео и референсного видео (описывает желаемое движение или стиль)

Пример: `"Милый котенок потягивается на солнце"`

**image\_urls** `string[]`

Массив URL референсных изображений (режим изображение-в-видео, поддерживает только 1 изображение)

**⚠️ Только формат URL (base64 больше не поддерживается)**

* Публично доступный URL изображения (http\:// или https\://)
* Вы можете использовать [API загрузки изображений](https://docs.toapis.com/docs/ru/api-reference/uploads/images.md) для загрузки локальных изображений и получения URL

Пример: `["https://example.com/image.jpg"]`

**Примечание:** Нельзя использовать вместе с `metadata.reference_urls`

**aspect\_ratio** `string` (default: 16:9)

Соотношение сторон видео (для режимов текст-в-видео и референсного видео)

Доступные значения:

* `16:9` - Горизонтальный (по умолчанию)
* `9:16` - Вертикальный
* `1:1` - Квадрат
* `4:3` - Горизонтальный
* `3:4` - Вертикальный

По умолчанию: `16:9`

**Примечание:** Не поддерживается в режиме изображение-в-видео

**resolution** `string` (default: 1080p)

Разрешение видео

Доступные значения:

* `720p` - Стандартное
* `1080p` - Высокое качество (по умолчанию)

По умолчанию: `1080p`

480p не поддерживается. Тарификация посекундная; разные разрешения имеют разную стоимость.

**duration** `integer` (default: 5)

Длительность видео (секунды)

Поддерживается: `5`, `10`, `15`

По умолчанию: `5`

**negative\_prompt** `string`

Негативный промпт — описывает нежелательное содержимое

Пример: `"размытый, низкое качество, деформированный"`

**seed** `integer`

Случайное зерно для воспроизводимости результатов

Пример: `12345`

**prompt\_extend** `boolean` (default: true)

Автоматическое расширение промпта

При включении система автоматически оптимизирует и обогащает ваш промпт. **Включено по умолчанию** — установите `false` для отключения.

**audio** `boolean`

Включить аудио в видео

Не-Flash модели Wan2.6 по умолчанию генерируют видео со звуком. Установите `true` для явного включения.

**shot\_type** `string`

Тип съёмки (для режимов текст-в-видео и референсного видео)

Доступные значения:

* `single` - Один непрерывный план
* `multi` - Несколько планов (кинематографический монтаж)

**watermark** `boolean`

Добавить водяной знак Alibaba Cloud на видео

**metadata** `object`

Расширенные параметры

**Показать поля metadata**

**reference\_urls** `string[]`

**Режим референсного видео (r2v)** — массив URL референсных видео

При наличии этого поля сервер направляет запрос к модели референсного видео (wan2.6-r2v). Модель использует эти видео для генерации нового контента с согласованными персонажами или сценами.

* Каждый элемент должен быть публично доступным URL видео (http\:// или https\://)

Пример: `["https://cdn.example.com/ref-character.mp4"]`

**Примечание:** Нельзя использовать вместе с `image_urls`

## Комбинации разрешений и соотношений сторон

| Соотношение сторон | Описание | Размер 720p | Размер 1080p |
| - | - | - | - |
| 16:9 | Горизонтальный (по умолчанию) | 1280×720 | 1920×1080 |
| 9:16 | Вертикальный | 720×1280 | 1080×1920 |
| 1:1 | Квадрат | 960×960 | 1440×1440 |
| 4:3 | Горизонтальный | 1088×832 | 1632×1248 |
| 3:4 | Вертикальный | 832×1088 | 1248×1632 |

## Ответ

**id** `string`

Уникальный идентификатор задачи для последующих запросов

**object** `string`

Тип объекта, всегда `generation.task`

**model** `string`

Использованное название модели

**status** `string`

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

* `queued` - В очереди
* `in_progress` - Обрабатывается
* `completed` - Успешно завершена
* `failed` - Ошибка

**progress** `integer`

Прогресс задачи в процентах (0-100)

**created\_at** `integer`

Временная метка создания задачи (Unix timestamp)

**metadata** `object`

Метаданные задачи

## Сценарии использования

### Сценарий 1: Текст-в-видео

```json theme={null}
{
  "model": "wan2.6",
  "prompt": "Милый котенок бежит по траве, солнечный день",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 5
}
```

### Сценарий 2: Изображение-в-видео

```json theme={null}
{
  "model": "wan2.6",
  "prompt": "Кот начинает радостно бегать",
  "image_urls": ["https://example.com/cat.jpg"],
  "resolution": "1080p",
  "duration": 10
}
```

### Сценарий 3: Референсное видео (r2v)

```json theme={null}
{
  "model": "wan2.6",
  "prompt": "Персонаж машет рукой и улыбается камере",
  "metadata": {
    "reference_urls": ["https://cdn.example.com/ref-character.mp4"]
  },
  "shot_type": "single",
  "resolution": "1080p",
  "duration": 5
}
```

### Сценарий 4: Текст-в-видео (полные параметры)

```json theme={null}
{
  "model": "wan2.6",
  "prompt": "Золотистый ретривер бежит через поле подсолнухов",
  "negative_prompt": "размытый, низкое качество, деформированный",
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": 10,
  "seed": 12345,
  "prompt_extend": true,
  "shot_type": "multi",
  "watermark": false
}
```

> [!NOTE]
>
> **Получение результатов задачи**
>
> Генерация видео — асинхронная задача. После отправки возвращается `task_id`. Используйте интерфейс [Получить статус видео](https://docs.toapis.com/docs/ru/api-reference/tasks/video-status.md) для запроса прогресса и результатов.

```bash cURL (Текст-в-видео) theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.6",
    "prompt": "Милый котенок бежит по траве",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": 5
  }'
```

```bash cURL (Изображение-в-видео) theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.6",
    "prompt": "Кот начинает радостно бегать",
    "image_urls": ["https://example.com/cat.jpg"],
    "resolution": "1080p",
    "duration": 10
  }'
```

```bash cURL (Референсное видео) theme={null}
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.6",
    "prompt": "Персонаж машет рукой и улыбается камере",
    "metadata": {
      "reference_urls": ["https://cdn.example.com/ref-character.mp4"]
    },
    "resolution": "1080p",
    "duration": 5
  }'
```

```python Python theme={null}
import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "wan2.6",
        "prompt": "Милый котенок бежит по траве",
        "aspect_ratio": "16:9",
        "resolution": "1080p",
        "duration": 5
    }
)

task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")
```

```javascript JavaScript theme={null}
const response = await fetch('https://toapis.com/v1/videos/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'wan2.6',
    prompt: 'Милый котенок бежит по траве',
    aspect_ratio: '16:9',
    resolution: '1080p',
    duration: 5
  })
});

const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);
```

```json 200 theme={null}
{
  "id": "video_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "wan2.6",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {
    "aspect_ratio": "16:9"
  }
}
```


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