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

Providers

PixVerse

OpenClaw proporciona pixverse como Plugin externo oficial para la generación alojada de vídeos de PixVerse. El Plugin registra el proveedor pixverse con el contrato videoGenerationProviders.

Propiedad Valor
Id. del proveedor pixverse
Paquete del Plugin @openclaw/pixverse-provider
Variable de entorno de autenticación PIXVERSE_API_KEY
Indicador de incorporación --auth-choice pixverse-api-key
Indicador directo de la CLI --pixverse-api-key <key>
API API v2 de la plataforma PixVerse (envío mediante video_id y consulta periódica del resultado)
Modelo predeterminado pixverse/v6
Región predeterminada de la API Internacional

Primeros pasos

  • Instalar el Plugin

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

  • Establecer la clave de API

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

    El asistente solicita el endpoint Internacional o CN (consulte la región de la API más adelante) antes de escribir region y baseUrl en la configuración del proveedor. Las ejecuciones no interactivas (clave procedente de --pixverse-api-key o PIXVERSE_API_KEY) usan Internacional de forma predeterminada.

    La incorporación también establece agents.defaults.mediaModels.video.primary en pixverse/v6 cuando todavía no se ha configurado ningún modelo de vídeo predeterminado.

  • Cambiar un proveedor de vídeo predeterminado existente (opcional)

    bash
    openclaw config set agents.defaults.mediaModels.video.primary "pixverse/v6"

  • Generar un vídeo

    Solicite al agente que genere un vídeo. PixVerse se utilizará automáticamente.

    • Modos y modelos compatibles

    El proveedor expone los modelos de generación de PixVerse mediante la herramienta de vídeo compartida de OpenClaw.

    Modo Modelos Entrada de referencia
    Texto a vídeo v6 (predeterminado), c1 Ninguna
    Imagen a vídeo v6 (predeterminado), c1 1 imagen local o remota

    Las referencias a imágenes locales se cargan en PixVerse antes de la solicitud de imagen a vídeo. Las URL de imágenes remotas se transfieren al endpoint de carga de imágenes de PixVerse como image_url.

    Opción Valores compatibles
    Duración 1-15 segundos (valor predeterminado: 5)
    Resolución 360P, 540P, 720P, 1080P (valor predeterminado: 540P; las solicitudes 480P se asignan a 540P)
    Relación de aspecto 16:9 (predeterminada), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9; solo para texto a vídeo; imagen a vídeo utiliza la imagen de origen
    Audio generado audio: true

    Opciones del proveedor

    El proveedor de vídeo acepta estas claves opcionales específicas del proveedor:

    Opción Tipo Efecto
    seed number Semilla determinista, de 0 a 2147483647
    negativePrompt / negative_prompt string Prompt negativo
    quality string Calidad de PixVerse, como 720p
    motionMode / motion_mode string Modo de movimiento de imagen a vídeo (valor predeterminado: normal)
    cameraMovement / camera_movement string Preajuste de movimiento de cámara de PixVerse
    templateId / template_id number Id. de la plantilla de PixVerse activada

    Configuración

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

    Configuración avanzada

    Región de la API
    Valor de la región URL base de la API de PixVerse
    international https://app-api.pixverse.ai/openapi/v2
    cn https://app-api.pixverseai.cn/openapi/v2

    Establezca models.providers.pixverse.region manualmente cuando la clave pertenezca a una región específica de la plataforma PixVerse, o ejecute openclaw onboard --auth-choice pixverse-api-key para elegir una en el asistente de configuración:

    json5
    {  models: {    providers: {      pixverse: {        region: "cn", // "international" or "cn"        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",        models: [],      },    },  },}
    URL base personalizada

    Establezca models.providers.pixverse.baseUrl únicamente cuando se enrute mediante un proxy compatible de confianza. baseUrl tiene prioridad sobre region.

    json5
    {  models: {    providers: {      pixverse: {        baseUrl: "https://app-api.pixverse.ai/openapi/v2",      },    },  },}
    Consulta periódica de tareas

    PixVerse devuelve un video_id en la solicitud de generación. OpenClaw consulta /openapi/v2/video/result/{video_id} cada 5 segundos hasta que la tarea se completa correctamente, falla o alcanza el tiempo de espera (valor predeterminado: 5 minutos; se puede sustituir mediante agents.defaults.mediaModels.video.timeoutMs).

    Contenido relacionado

    Generación de vídeo

    Parámetros de la herramienta compartida, selección del proveedor y comportamiento asíncrono.
    Referencia de configuración

    Configuración predeterminada del agente, incluido el modelo de generación de vídeo.
    Was this useful?
    On this page

    On this page