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

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

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Детерминированное зерно, если поддерживается
negativePrompt / negative_promptstringНегативный промпт
qualitystringКачество PixVerse, например 720p
motionMode / motion_modestringРежим движения для изображения в видео
cameraMovement / camera_movementstringПресет движения камеры PixVerse
templateId / template_idnumberАктивированный идентификатор шаблона PixVerse

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

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

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

OpenClaw по умолчанию использует международный API PixVerse. Задайте models.providers.pixverse.region вручную, если ваш ключ относится к определенному региону платформы PixVerse, или используйте openclaw onboard --auth-choice pixverse-api-key, чтобы выбрать регион в мастере настройки:
Значение регионаБазовый URL API PixVerse
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

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