Перейти до основного вмісту
OpenClaw надає pixverse як офіційний зовнішній Plugin для розміщеної генерації відео PixVerse. Plugin реєструє провайдера pixverse відповідно до контракту videoGenerationProviders.
ВластивістьЗначення
Ідентифікатор провайдераpixverse
Пакет Plugin@openclaw/pixverse-provider
Змінна середовища автентифікаціїPIXVERSE_API_KEY
Прапорець онбордингу--auth-choice pixverse-api-key
Прямий прапорець CLI--pixverse-api-key <key>
APIPixVerse Platform API v2 (надсилання video_id і опитування результату)
Модель за замовчуваннямpixverse/v6
Регіон API за замовчуваннямInternational

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

1

Install the plugin

openclaw plugins install clawhub:@openclaw/pixverse-provider
openclaw gateway restart
2

Set the API key

openclaw onboard --auth-choice pixverse-api-key
Майстер запитує, чи використовувати міжнародну кінцеву точку (https://app-api.pixverse.ai/openapi/v2) або кінцеву точку CN (https://app-api.pixverseai.cn/openapi/v2) перед записом region і baseUrl у конфігурацію провайдера.
3

Set PixVerse as the default video provider

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

Generate a video

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

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

Провайдер надає моделі генерації PixVerse через спільний відеоінструмент OpenClaw.
РежимМоделіВхідні дані посилання
Текст у відеоv6 (за замовчуванням), c1Немає
Зображення у відеоv6 (за замовчуванням), c11 локальне або віддалене зображення
Локальні посилання на зображення завантажуються в PixVerse перед запитом зображення у відео. URL-адреси віддалених зображень передаються через кінцеву точку завантаження зображень PixVerse як image_url.
ПараметрПідтримувані значення
Тривалість1-15 секунд
Роздільна здатність360P, 540P, 720P, 1080P
Співвідношення сторін16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9 для тексту у відео
Згенероване аудіоaudio: true
Генерація шаблонів зображень PixVerse ще не доступна через image_generate. Цей API керується ідентифікатором шаблону, тоді як спільний контракт генерації зображень OpenClaw наразі не має типізованого набору параметрів, специфічного для PixVerse.

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

Відеопровайдер приймає такі необов’язкові ключі, специфічні для провайдера:
ПараметрТипЕфект
seednumberДетермінований seed, якщо підтримується
negativePrompt / negative_promptstringНегативний prompt
qualitystringЯкість PixVerse, наприклад 720p
motionMode / motion_modestringРежим руху для зображення у відео
cameraMovement / camera_movementstringПресет руху камери PixVerse
templateId / template_idnumberАктивований ідентифікатор шаблону PixVerse

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

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

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

OpenClaw за замовчуванням використовує міжнародний PixVerse API. Установіть models.providers.pixverse.region вручну, коли ваш ключ належить до конкретного регіону платформи PixVerse, або використайте openclaw onboard --auth-choice pixverse-api-key, щоб вибрати його в майстрі налаштування:
Значення регіонуБазова URL-адреса PixVerse API
internationalhttps://app-api.pixverse.ai/openapi/v2
cnhttps://app-api.pixverseai.cn/openapi/v2
{
  models: {
    providers: {
      pixverse: {
        region: "cn", // "international" or "cn"
        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
        models: [],
      },
    },
  },
}
Установлюйте 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}, доки завдання не завершиться успішно, не завершиться з помилкою або не перевищить час очікування.

​
Пов’язане

Video generation

Спільні параметри інструмента, вибір провайдера та асинхронна поведінка.

Configuration reference

Стандартні налаштування агента, зокрема модель генерації відео.