pixverse como Plugin externo oficial para la generación de video alojada de PixVerse. El Plugin registra el proveedor pixverse contra el contrato videoGenerationProviders.
| Propiedad | Valor |
|---|---|
| Id. de proveedor | pixverse |
| Paquete del Plugin | @openclaw/pixverse-provider |
| Variable de entorno de auth | PIXVERSE_API_KEY |
| Marca de onboarding | --auth-choice pixverse-api-key |
| Marca directa de CLI | --pixverse-api-key <key> |
| API | PixVerse Platform API v2 (envío de video_id más sondeo de resultados) |
| Modelo predeterminado | pixverse/v6 |
| Región de API predeterminada | Internacional |
Primeros pasos
Configurar la clave de API
https://app-api.pixverse.ai/openapi/v2) o el endpoint de CN
(https://app-api.pixverseai.cn/openapi/v2) antes de escribir region y
baseUrl en la configuración del proveedor.Modos y modelos compatibles
El proveedor expone modelos de generación de PixVerse mediante la herramienta de video compartida de OpenClaw.| Modo | Modelos | Entrada de referencia |
|---|---|---|
| Texto a video | v6 (predeterminado), c1 | Ninguna |
| Imagen a video | v6 (predeterminado), c1 | 1 imagen local o remota |
image_url.
| Opción | Valores compatibles |
|---|---|
| Duración | 1-15 segundos |
| Resolución | 360P, 540P, 720P, 1080P |
| Relación de aspecto | 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9 para texto a video |
| Audio generado | audio: true |
La generación de plantillas de imagen de PixVerse aún no se expone mediante
image_generate. Esa API está controlada por id. de plantilla, mientras que el contrato compartido de generación de imágenes de OpenClaw actualmente no tiene un conjunto de opciones tipadas específico de PixVerse.Opciones del proveedor
El proveedor de video acepta estas claves opcionales específicas del proveedor:| Opción | Tipo | Efecto |
|---|---|---|
seed | number | Semilla determinista cuando sea compatible |
negativePrompt / negative_prompt | string | Prompt negativo |
quality | string | Calidad de PixVerse como 720p |
motionMode / motion_mode | string | Modo de movimiento de imagen a video |
cameraMovement / camera_movement | string | Preajuste de movimiento de cámara de PixVerse |
templateId / template_id | number | Id. de plantilla activada de PixVerse |
Configuración
Configuración avanzada
Región de API
Región de API
OpenClaw usa de forma predeterminada la API internacional de PixVerse. Configura
models.providers.pixverse.region
manualmente cuando tu clave pertenezca a una región específica de la plataforma PixVerse, o usa
openclaw onboard --auth-choice pixverse-api-key para elegir una en el asistente de configuración:| Valor de 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 |
URL base personalizada
URL base personalizada
Configura
models.providers.pixverse.baseUrl solo al enrutar a través de un proxy compatible de confianza.
baseUrl tiene prioridad sobre region.Sondeo de tareas
Sondeo de tareas
PixVerse devuelve un
video_id desde la solicitud de generación. OpenClaw sondea
/openapi/v2/video/result/{video_id} hasta que la tarea se realiza correctamente, falla
o agota el tiempo de espera.Relacionado
Generación de video
Parámetros de herramienta compartida, selección de proveedor y comportamiento asíncrono.
Referencia de configuración
Configuración predeterminada del agente, incluido el modelo de generación de video.