PixVerse

OpenClaw fornece o pixverse como um plugin externo oficial para geração de vídeos hospedada do PixVerse. O plugin registra o provedor pixverse no contrato videoGenerationProviders.

Propriedade	Valor
ID do provedor	`pixverse`
Pacote do plugin	`@openclaw/pixverse-provider`
Variável de ambiente de autenticação	`PIXVERSE_API_KEY`
Sinalizador de integração inicial	`--auth-choice pixverse-api-key`
Sinalizador direto da CLI	`--pixverse-api-key <key>`
API	PixVerse Platform API v2 (envio de `video_id` seguido de consulta do resultado)
Modelo padrão	`pixverse/v6`
Região padrão da API	Internacional

Primeiros passos

Instale o plugin

openclaw plugins install @openclaw/pixverse-provider
openclaw gateway restart

Defina a chave da API

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

O assistente solicita o endpoint Internacional ou CN (consulte a região da API abaixo) antes de gravar region e baseUrl na configuração do provedor. Execuções não interativas (com a chave de --pixverse-api-key ou PIXVERSE_API_KEY) usam Internacional como padrão.A integração inicial também define agents.defaults.videoGenerationModel.primary como pixverse/v6 quando ainda não há um modelo de vídeo padrão configurado.

Altere um provedor de vídeo padrão existente (opcional)

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

Gere um vídeo

Peça ao agente para gerar um vídeo. O PixVerse será usado automaticamente.

Modos e modelos compatíveis

O provedor disponibiliza os modelos de geração do PixVerse por meio da ferramenta de vídeo compartilhada do OpenClaw.

Modo	Modelos	Entrada de referência
Texto para vídeo	`v6` (padrão), `c1`	Nenhuma
Imagem para vídeo	`v6` (padrão), `c1`	1 imagem local ou remota

As referências a imagens locais são enviadas ao PixVerse antes da solicitação de imagem para vídeo. URLs de imagens remotas são encaminhadas pelo endpoint de envio de imagens do PixVerse como image_url.

Opção	Valores compatíveis
Duração	1 a 15 segundos (padrão: 5)
Resolução	`360P`, `540P`, `720P`, `1080P` (padrão: `540P`; solicitações de `480P` são mapeadas para `540P`)
Proporção	`16:9` (padrão), `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9`; somente texto para vídeo; imagem para vídeo segue a imagem de origem
Áudio gerado	`audio: true`

A geração de modelos de imagem do PixVerse ainda não está disponível por meio de image_generate. Essa API é orientada por ID de modelo, enquanto o contrato compartilhado de geração de imagens do OpenClaw atualmente não possui um conjunto tipado de opções específico do PixVerse.

Opções do provedor

O provedor de vídeo aceita estas chaves opcionais específicas do provedor:

Opção	Tipo	Efeito
`seed`	número	Semente determinística, de 0 a 2147483647
`negativePrompt` / `negative_prompt`	string	Prompt negativo
`quality`	string	Qualidade do PixVerse, como `720p`
`motionMode` / `motion_mode`	string	Modo de movimento de imagem para vídeo (padrão: `normal`)
`cameraMovement` / `camera_movement`	string	Predefinição de movimento de câmera do PixVerse
`templateId` / `template_id`	número	ID de modelo ativado do PixVerse

Configuração

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

Configuração avançada

Região da API

Valor da região	URL base da API do PixVerse
`international`	`https://app-api.pixverse.ai/openapi/v2`
`cn`	`https://app-api.pixverseai.cn/openapi/v2`

Defina models.providers.pixverse.region manualmente quando sua chave pertencer a uma região específica da plataforma PixVerse ou execute openclaw onboard --auth-choice pixverse-api-key para escolher uma no assistente de configuração:

{
  models: {
    providers: {
      pixverse: {
        region: "cn", // "international" ou "cn"
        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
        models: [],
      },
    },
  },
}

URL base personalizada

Defina models.providers.pixverse.baseUrl somente ao rotear por um proxy compatível e confiável. baseUrl tem precedência sobre region.

{
  models: {
    providers: {
      pixverse: {
        baseUrl: "https://app-api.pixverse.ai/openapi/v2",
      },
    },
  },
}

Consulta de tarefas

O PixVerse retorna um video_id na solicitação de geração. O OpenClaw consulta /openapi/v2/video/result/{video_id} a cada 5 segundos até que a tarefa seja concluída com sucesso, falhe ou atinja o tempo limite (padrão: 5 minutos; substitua-o com agents.defaults.videoGenerationModel.timeoutMs).

Relacionado

Geração de vídeos

Parâmetros compartilhados da ferramenta, seleção do provedor e comportamento assíncrono.

Referência de configuração

Configurações padrão do agente, incluindo o modelo de geração de vídeos.

Overview

Concepts and configuration

Providers

Primeiros passos

Modos e modelos compatíveis

Opções do provedor

Configuração

Configuração avançada

Relacionado

Geração de vídeos

Referência de configuração

​Primeiros passos

​Modos e modelos compatíveis

​Opções do provedor

​Configuração

​Configuração avançada

​Relacionado

Geração de vídeos

Referência de configuração

Primeiros passos

Modos e modelos compatíveis

Opções do provedor

Configuração

Configuração avançada

Relacionado