OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

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 по умолчанию Международный

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

  • Установите плагин

    bash
    openclaw plugins install @openclaw/pixverse-provideropenclaw gateway restart

  • Задайте ключ API

    bash
    openclaw onboard --auth-choice pixverse-api-key

    Перед записью region и baseUrl в конфигурацию провайдера мастер предлагает выбрать международную или китайскую конечную точку (см. раздел «Регион API» ниже). При неинтерактивном запуске (ключ из --pixverse-api-key или PIXVERSE_API_KEY) по умолчанию используется международная конечная точка.

    Первоначальная настройка также задаёт agents.defaults.videoGenerationModel.primary значение pixverse/v6, если модель генерации видео по умолчанию ещё не настроена.

  • Смените существующего провайдера генерации видео по умолчанию (необязательно)

    bash
    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

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

    Видеопровайдер принимает следующие необязательные ключи, специфичные для провайдера:

    Параметр Тип Назначение
    seed number Детерминированное начальное значение от 0 до 2147483647
    negativePrompt / negative_prompt string Негативный промпт
    quality string Качество PixVerse, например 720p
    motionMode / motion_mode string Режим движения для преобразования изображения в видео (по умолчанию normal)
    cameraMovement / camera_movement string Предустановка движения камеры PixVerse
    templateId / template_id number Идентификатор активированного шаблона PixVerse

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

    json5
    {  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, чтобы выбрать регион в мастере настройки:

    json5
    {  models: {    providers: {      pixverse: {        region: "cn", // "international" or "cn"        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",        models: [],      },    },  },}
    Пользовательский базовый URL

    Задавайте models.providers.pixverse.baseUrl только при маршрутизации через доверенный совместимый прокси-сервер. baseUrl имеет приоритет над region.

    json5
    {  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).

    Связанные материалы

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

    Общие параметры инструмента, выбор провайдера и асинхронное поведение.
    Справочник по конфигурации

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

    On this page