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 по умолчанию	Международный

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

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

openclaw plugins install @openclaw/pixverse-provider
openclaw gateway restart

Задайте ключ API

openclaw onboard --auth-choice pixverse-api-key

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

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

openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"

Создайте видео

Попросите агента создать видео. 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`

Генерация по шаблонам изображений 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

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

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "pixverse/v6",
      },
    },
  },
}

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

Регион 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, чтобы выбрать регион в мастере настройки:

{
  models: {
    providers: {
      pixverse: {
        region: "cn", // "international" or "cn"
        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
        models: [],
      },
    },
  },
}

Пользовательский базовый URL

Задавайте models.providers.pixverse.baseUrl только при маршрутизации через доверенный совместимый прокси-сервер. baseUrl имеет приоритет над region.

{
  models: {
    providers: {
      pixverse: {
        baseUrl: "https://app-api.pixverse.ai/openapi/v2",
      },
    },
  },
}

Опрос состояния задачи

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

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

Генерация видео

Общие параметры инструмента, выбор провайдера и асинхронное поведение.

Справочник по конфигурации

Настройки агента по умолчанию, включая модель генерации видео.

Overview

Concepts and configuration

Providers

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

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

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

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

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

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

Генерация видео

Справочник по конфигурации

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

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

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

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

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

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

Генерация видео

Справочник по конфигурации

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

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

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

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

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

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