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

Майстер пропонує вибрати міжнародну або китайську кінцеву точку (див. розділ про регіон API нижче), перш ніж записати region і baseUrl у конфігурацію провайдера. Для неінтерактивних запусків (ключ із --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`	число	Детерміноване початкове значення від 0 до 2147483647
`negativePrompt` / `negative_prompt`	рядок	Негативний промпт
`quality`	рядок	Якість PixVerse, наприклад `720p`
`motionMode` / `motion_mode`	рядок	Режим руху для перетворення зображення у відео (за замовчуванням `normal`)
`cameraMovement` / `camera_movement`	рядок	Попередньо заданий рух камери PixVerse
`templateId` / `template_id`	число	Ідентифікатор активованого шаблону 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" або "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

Початок роботи

Підтримувані режими та моделі

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

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

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

Пов’язані матеріали

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

Довідник із конфігурації

​Початок роботи

​Підтримувані режими та моделі

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

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

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

​Пов’язані матеріали

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

Довідник із конфігурації

Початок роботи

Підтримувані режими та моделі

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

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

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

Пов’язані матеріали