Providers
PixVerse
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> |
| API | PixVerse Platform API v2 (надсилання video_id і опитування результату) |
| Модель за замовчуванням | pixverse/v6 |
| Регіон API за замовчуванням | International |
Початок роботи
Install the plugin
openclaw plugins install clawhub:@openclaw/pixverse-provideropenclaw gateway restartSet 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 у конфігурацію провайдера.
Set PixVerse as the default video provider
openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"Generate a video
Попросіть агента згенерувати відео. PixVerse буде використано автоматично.
Підтримувані режими та моделі
Провайдер надає моделі генерації PixVerse через спільний відеоінструмент OpenClaw.
| Режим | Моделі | Вхідні дані посилання |
|---|---|---|
| Текст у відео | v6 (за замовчуванням), c1 |
Немає |
| Зображення у відео | v6 (за замовчуванням), c1 |
1 локальне або віддалене зображення |
Локальні посилання на зображення завантажуються в 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 |
Параметри провайдера
Відеопровайдер приймає такі необов’язкові ключі, специфічні для провайдера:
| Параметр | Тип | Ефект |
|---|---|---|
seed |
number | Детермінований seed, якщо підтримується |
negativePrompt / negative_prompt |
string | Негативний prompt |
quality |
string | Якість PixVerse, наприклад 720p |
motionMode / motion_mode |
string | Режим руху для зображення у відео |
cameraMovement / camera_movement |
string | Пресет руху камери PixVerse |
templateId / template_id |
number | Активований ідентифікатор шаблону PixVerse |
Конфігурація
{ agents: { defaults: { videoGenerationModel: { primary: "pixverse/v6", }, }, },}Розширена конфігурація
API region
OpenClaw за замовчуванням використовує міжнародний PixVerse API. Установіть models.providers.pixverse.region
вручну, коли ваш ключ належить до конкретного регіону платформи PixVerse, або використайте
openclaw onboard --auth-choice pixverse-api-key, щоб вибрати його в майстрі налаштування:
| Значення регіону | Базова URL-адреса PixVerse API |
|---|---|
international |
https://app-api.pixverse.ai/openapi/v2 |
cn |
https://app-api.pixverseai.cn/openapi/v2 |
{ models: { providers: { pixverse: { region: "cn", // "international" or "cn" baseUrl: "https://app-api.pixverseai.cn/openapi/v2", models: [], }, }, },}Custom base URL
Установлюйте models.providers.pixverse.baseUrl лише під час маршрутизації через довірений сумісний проксі.
baseUrl має пріоритет над region.
{ models: { providers: { pixverse: { baseUrl: "https://app-api.pixverse.ai/openapi/v2", }, }, },}Task polling
PixVerse повертає video_id із запиту генерації. OpenClaw опитує
/openapi/v2/video/result/{video_id}, доки завдання не завершиться успішно, не завершиться з помилкою
або не перевищить час очікування.
