На цій сторінці
На цій сторінці
Providers
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 за замовчуванням | Міжнародний |
Початок роботи
Установіть плагін
Установіть ключ API
Майстер пропонує вибрати міжнародну або китайську кінцеву точку (див. розділ про регіон API
нижче), перш ніж записати region і baseUrl у конфігурацію провайдера.
Для неінтерактивних запусків (ключ із --pixverse-api-key або PIXVERSE_API_KEY)
за замовчуванням використовується міжнародний регіон.
Початкове налаштування також задає для 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 |
Параметри провайдера
Провайдер відео приймає такі необов’язкові специфічні для нього ключі:
| Параметр | Тип | Ефект |
|---|---|---|
seed |
число | Детерміноване початкове значення від 0 до 2147483647 |
negativePrompt / negative_prompt |
рядок | Негативний промпт |
quality |
рядок | Якість PixVerse, наприклад 720p |
motionMode / motion_mode |
рядок | Режим руху для перетворення зображення у відео (за замовчуванням normal) |
cameraMovement / camera_movement |
рядок | Попередньо заданий рух камери PixVerse |
templateId / template_id |
число | Ідентифікатор активованого шаблону PixVerse |
Конфігурація
Розширена конфігурація
Регіон 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, щоб вибрати його в
майстрі налаштування:
Власна базова URL-адреса
Задавайте models.providers.pixverse.baseUrl лише під час маршрутизації через надійний сумісний проксі-сервер.
baseUrl має пріоритет над region.
Опитування завдання
PixVerse повертає video_id у відповідь на запит генерації. OpenClaw опитує
/openapi/v2/video/result/{video_id} кожні 5 секунд, доки завдання не
завершиться успішно, не завершиться помилкою або не сплине час очікування (за замовчуванням 5 хвилин; змінити можна за допомогою
agents.defaults.videoGenerationModel.timeoutMs).
