En esta página
En esta página
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
Establecer la clave de API
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)
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
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:
URL base personalizada
Establezca models.providers.pixverse.baseUrl únicamente cuando se enrute mediante un proxy compatible de confianza.
baseUrl tiene prioridad sobre region.
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).
