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

# Alibaba Model Studio

Встроенный плагин `alibaba` регистрирует провайдера генерации видео для моделей Wan в Alibaba Model Studio (международное название DashScope). Он включён по умолчанию; требуется только ключ API.

| Свойство | Значение |
| - | - |
| Идентификатор провайдера | `alibaba` |
| Плагин | встроенный, `enabledByDefault: true` |
| Переменные среды для аутентификации | `MODELSTUDIO_API_KEY` → `DASHSCOPE_API_KEY` → `QWEN_API_KEY` (используется первое совпадение) |
| Флаг первоначальной настройки | `--auth-choice alibaba-model-studio-api-key` |
| Прямой флаг CLI | `--alibaba-model-studio-api-key <key>` |
| Модель по умолчанию | `alibaba/wan2.6-t2v` |
| Базовый URL по умолчанию | `https://dashscope-intl.aliyuncs.com` |

## Начало работы

**1. Задайте ключ API**

Сохраните ключ для провайдера `alibaba` в процессе первоначальной настройки:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice alibaba-model-studio-api-key
```

Или передайте ключ напрямую:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --alibaba-model-studio-api-key <your-key>
```

Либо экспортируйте одну из поддерживаемых переменных среды перед запуском Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export MODELSTUDIO_API_KEY=sk-...
# или DASHSCOPE_API_KEY=...
# или QWEN_API_KEY=...
```

**2. Задайте модель видео по умолчанию**

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "alibaba/wan2.6-t2v",
      },
    },
  },
}
```

**3. Убедитесь, что провайдер настроен**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider alibaba
```

Список включает все пять встроенных моделей Wan. Если не удаётся разрешить `MODELSTUDIO_API_KEY`, `openclaw models status --json` сообщает об отсутствующих учётных данных в разделе `auth.unusableProfiles`.

> [!NOTE]
>
> Плагин Alibaba и [плагин Qwen](https://docs2.openclaw.ai/ru/providers/qwen.md) выполняют аутентификацию через DashScope и принимают частично совпадающие переменные среды. Используйте идентификаторы моделей `alibaba/...` для специализированного интерфейса генерации видео Wan; идентификаторы `qwen/...` — для чата Qwen, векторных представлений и анализа медиаданных.

## Встроенные модели Wan

| Ссылка на модель | Режим |
| - | - |
| `alibaba/wan2.6-t2v` | Текст в видео (по умолчанию) |
| `alibaba/wan2.6-i2v` | Изображение в видео |
| `alibaba/wan2.6-r2v` | Референс в видео |
| `alibaba/wan2.6-r2v-flash` | Референс в видео (быстро) |
| `alibaba/wan2.7-r2v` | Референс в видео |

## Возможности и ограничения

Для всех трёх режимов действуют одинаковые ограничения на количество и длительность видео в одном запросе; различается только формат входных данных.

| Режим | Макс. выходных видео | Макс. входных изображений | Макс. входных видео | Макс. длительность | Поддерживаемые параметры управления |
| - | - | - | - | - | - |
| Текст в видео | 1 | неприменимо | неприменимо | 10 с | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |
| Изображение в видео | 1 | 1 | неприменимо | 10 с | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |
| Референс в видео | 1 | неприменимо | 4 | 10 с | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |

Если в запросе не указан `durationSeconds`, используется принимаемое DashScope значение по умолчанию — **5 секунд**. Явно задайте `durationSeconds` в [инструменте генерации видео](https://docs2.openclaw.ai/ru/tools/video-generation.md), чтобы увеличить длительность до 10 с.

> [!WARNING]
>
> Входные референсные изображения и видео должны быть доступны по удалённым URL-адресам `http(s)`; режимы работы с референсами в DashScope отклоняют локальные пути к файлам. Сначала загрузите файлы в объектное хранилище или используйте процесс [инструмента для работы с медиаданными](https://docs2.openclaw.ai/ru/tools/media-overview.md), который уже создаёт общедоступный URL.

## Расширенная конфигурация

> [accordion] Переопределение базового URL DashScope
>
> По умолчанию провайдер использует международную конечную точку DashScope. Чтобы использовать конечную точку региона Китая:
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   models: {
>     providers: {
>       alibaba: {
>         baseUrl: "https://dashscope.aliyuncs.com",
>       },
>     },
>   },
> }
> ```
>
> Провайдер удаляет завершающие косые черты перед формированием URL-адресов задач AIGC.

> [accordion] Приоритет переменных среды для аутентификации
>
> OpenClaw получает ключ API Alibaba из переменных среды в следующем порядке, выбирая первое непустое значение:
>
> 1. `MODELSTUDIO_API_KEY`
> 2. `DASHSCOPE_API_KEY`
> 3. `QWEN_API_KEY`
>
> Настроенные записи `auth.profiles` (заданные через `openclaw models auth login`) имеют приоритет над разрешением переменных среды. Сведения о ротации профилей, периоде ожидания и механизме переопределения см. в разделе [«Профили аутентификации» в FAQ по моделям](https://docs2.openclaw.ai/ru/help/faq-models.md#auth-profiles-what-they-are-and-how-to-manage-them).

> [accordion] Связь с плагином Qwen
>
> Оба встроенных плагина взаимодействуют с DashScope и принимают частично совпадающие ключи API. Используйте:
>
> * `alibaba/wan*.*` — идентификаторы специализированного провайдера видео Wan, описанного на этой странице.
> * `qwen/*` — идентификаторы чата Qwen, векторных представлений и анализа медиаданных (см. [Qwen](https://docs2.openclaw.ai/ru/providers/qwen.md)).
>
> Однократная настройка `MODELSTUDIO_API_KEY` обеспечивает аутентификацию для обоих плагинов, поскольку списки переменных среды для аутентификации намеренно пересекаются; выполнять первоначальную настройку каждого плагина отдельно не требуется.

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

> [card] [Генерация видео](https://docs2.openclaw.ai/ru/tools/video-generation.md)
>
> Общие параметры инструмента для работы с видео и выбор провайдера.

> [card] [Qwen](https://docs2.openclaw.ai/ru/providers/qwen.md)
>
> Настройка чата Qwen, векторных представлений и анализа медиаданных с использованием той же аутентификации DashScope.

> [card] [Справочник по конфигурации](https://docs2.openclaw.ai/ru/gateway/config-agents.md#agent-defaults)
>
> Значения агентов по умолчанию и конфигурация моделей.

> [card] [FAQ по моделям](https://docs2.openclaw.ai/ru/help/faq-models.md)
>
> Профили аутентификации, переключение моделей и устранение ошибок «нет профиля».