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

Providers

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

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

  • Defina a chave da API

    bash
    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)

    bash
    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

    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

    json5
    {  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:

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

    json5
    {  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.
    Was this useful?
    On this page

    On this page