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

# PixVerse

OpenClaw предоставляет `pixverse` как официальный внешний плагин для генерации видео PixVerse в облаке. Плагин регистрирует провайдера `pixverse` в соответствии с контрактом `videoGenerationProviders`.

| Свойство | Значение |
| - | - |
| Идентификатор провайдера | `pixverse` |
| Пакет плагина | `@openclaw/pixverse-provider` |
| Переменная окружения для аутентификации | `PIXVERSE_API_KEY` |
| Флаг первоначальной настройки | `--auth-choice pixverse-api-key` |
| Прямой флаг CLI | `--pixverse-api-key <key>` |
| API | PixVerse Platform API v2 (отправка через `video_id` с последующим опросом результата) |
| Модель по умолчанию | `pixverse/v6` |
| Регион API по умолчанию | Международный |

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

**1. Установите плагин**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/pixverse-provider
openclaw gateway restart
```

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

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

Перед записью `region` и `baseUrl` в конфигурацию провайдера
мастер предлагает выбрать международную или китайскую конечную точку (см. раздел
«Регион API» ниже). При неинтерактивном запуске (ключ из `--pixverse-api-key`
или `PIXVERSE_API_KEY`) по умолчанию используется международная конечная точка.

Первоначальная настройка также задаёт `agents.defaults.videoGenerationModel.primary` значение
`pixverse/v6`, если модель генерации видео по умолчанию ещё не настроена.

**3. Смените существующего провайдера генерации видео по умолчанию (необязательно)**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"
```

**4. Создайте видео**

Попросите агента создать видео. PixVerse будет использован автоматически.

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

Провайдер предоставляет модели генерации PixVerse через общий видеоинструмент OpenClaw.

| Режим | Модели | Входные референсы |
| - | - | - |
| Текст в видео | `v6` (по умолчанию), `c1` | Нет |
| Изображение в видео | `v6` (по умолчанию), `c1` | 1 локальное или удалённое изображение |

Перед запросом преобразования изображения в видео локальные изображения загружаются в PixVerse. URL удалённых изображений передаются конечной точке загрузки изображений PixVerse как `image_url`.

| Параметр | Поддерживаемые значения |
| - | - |
| Длительность | 1–15 секунд (по умолчанию 5) |
| Разрешение | `360P`, `540P`, `720P`, `1080P` (по умолчанию `540P`; запросы `480P` преобразуются в `540P`) |
| Соотношение сторон | `16:9` (по умолчанию), `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9`; только для преобразования текста в видео, при преобразовании изображения в видео используется соотношение сторон исходного изображения |
| Генерируемый звук | `audio: true` |

> [!NOTE]
>
> Генерация по шаблонам изображений PixVerse пока не предоставляется через `image_generate`. Этот API управляется идентификаторами шаблонов, тогда как общий контракт генерации изображений OpenClaw в настоящее время не содержит типизированного набора параметров, специфичного для PixVerse.

## Параметры провайдера

Видеопровайдер принимает следующие необязательные ключи, специфичные для провайдера:

| Параметр | Тип | Назначение |
| - | - | - |
| `seed` | number | Детерминированное начальное значение от 0 до 2147483647 |
| `negativePrompt` / `negative_prompt` | string | Негативный промпт |
| `quality` | string | Качество PixVerse, например `720p` |
| `motionMode` / `motion_mode` | string | Режим движения для преобразования изображения в видео (по умолчанию `normal`) |
| `cameraMovement` / `camera_movement` | string | Предустановка движения камеры PixVerse |
| `templateId` / `template_id` | number | Идентификатор активированного шаблона PixVerse |

## Конфигурация

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "pixverse/v6",
      },
    },
  },
}
```

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

> [accordion] Регион API
>
> | Значение региона | Базовый URL API PixVerse |
> | - | - |
> | `international` | `https://app-api.pixverse.ai/openapi/v2` |
> | `cn` | `https://app-api.pixverseai.cn/openapi/v2` |
>
> Задайте `models.providers.pixverse.region` вручную, если ваш ключ относится к
> определённому региону платформы PixVerse, либо выполните
> `openclaw onboard --auth-choice pixverse-api-key`, чтобы выбрать регион в
> мастере настройки:
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   models: {
>     providers: {
>       pixverse: {
>         region: "cn", // "international" or "cn"
>         baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
>         models: [],
>       },
>     },
>   },
> }
> ```

> [accordion] Пользовательский базовый URL
>
> Задавайте `models.providers.pixverse.baseUrl` только при маршрутизации через доверенный совместимый прокси-сервер.
> `baseUrl` имеет приоритет над `region`.
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   models: {
>     providers: {
>       pixverse: {
>         baseUrl: "https://app-api.pixverse.ai/openapi/v2",
>       },
>     },
>   },
> }
> ```

> [accordion] Опрос состояния задачи
>
> PixVerse возвращает `video_id` в ответ на запрос генерации. OpenClaw опрашивает
> `/openapi/v2/video/result/{video_id}` каждые 5 секунд, пока задача
> не завершится успешно, не завершится с ошибкой или не истечёт время ожидания (по умолчанию 5 минут; можно переопределить с помощью
> `agents.defaults.videoGenerationModel.timeoutMs`).

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

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

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