PixVerse CLI: crea videos e imágenes IA en terminal

Introducción

Todo flujo de trabajo creativo tiene un cuello de botella: el momento en que tienes que salir de tu editor de código, abrir un navegador y hacer clic manualmente en una interfaz web para generar un contenido multimedia. Para los desarrolladores, los agentes de IA y cualquiera que cree canales de contenido automatizados, ese cambio de contexto es una fricción que se acumula rápidamente.

PixVerse CLIelimina ese cuello de botella. Es la interfaz de línea de comandos oficial para PixVerse, que le brinda acceso a la generación de PixVerse y a los flujos de trabajo del espacio de trabajo directamente desde su terminal. La conversión de texto a video, imagen a video, texto a imagen, imagen a imagen, transiciones, generación de voz, generación de música, video de referencia, control de movimiento, plantillas, ampliación de escala y administración de activos se pueden programar, canalizar y están disponibles sin tocar un navegador. Para la ruta de instalación más corta y una descripción general de configuración para agentes, comience en la página oficial de PixVerse CLI.

Lo que hace que PixVerse CLI sea particularmente útil es su filosofía de diseño: fue construido teniendo en mente a los agentes de IA. Los comandos pueden devolver JSON estructurado con --json o -p, los códigos de salida son deterministas y cada paso de la canalización se puede componer. Esto significa que puede enseñar a Claude Code, Cursor, Codex o cualquier otro agente a generar imágenes, videos, voz y música en su nombre con menos transferencias frágiles.

Esta guía está alineada con el PixVerseAI/cli GitHub README actual, su manifiesto de capacidades público y la página de producto de PixVerse CLI, revisados el 13 de julio de 2026. PixVerse CLI se actualiza continuamente desde el repositorio de GitHub, por lo que los scripts de producción aún deben verificar pixverse --version, pixverse create <mode> --help y pixverse update antes de ejecutar un lote grande.

Requisitos previos

Antes de comenzar, necesitas:

Node.js 20 o superior: consulte con node --version
Una cuenta PixVerse: regístrate en pixverse.ai
Una suscripción activa al PixVerse: el CLI utiliza el mismo sistema de crédito que el sitio web; sólo los usuarios suscritos pueden generar contenido

PixVerse CLI no requiere que se copie manualmente ninguna clave API. La autenticación se maneja a través de un flujo OAuth basado en navegador que almacena su token localmente.

Paso 1: instale el CLI

Instalar globalmente con npm:

npm install -g pixverse

Verifique la instalación:

pixverse --version

Si prefiere no realizar la instalación globalmente, también puede ejecutar comandos a través de npx:

npx pixverse create video --prompt "A cat walking on Mars"

Paso 2: autenticar

Ejecute el comando de inicio de sesión:

pixverse auth login

El CLI abre un navegador para la autorización del dispositivo OAuth. También puede copiar la URL y finalizar la autorización desde cualquier navegador en cualquier dispositivo, lo cual es útil para SSH y entornos sin cabeza. Su token se almacena automáticamente en ~/.pixverse/ y es válido por 30 días.

Para verificar que ha iniciado sesión y verificar sus créditos disponibles:

pixverse auth status pixverse account info pixverse account slots

El comando account info muestra su nivel de suscripción, créditos de espacio de trabajo y contexto de uso. pixverse account usage le ayuda a revisar el consumo de crédito, mientras que pixverse account slots muestra los espacios de generación concurrentes actuales para trabajos de imagen y vídeo. Las sesiones de CLI son independientes de las sesiones web/de aplicaciones de PixVerse y puede eliminar el token CLI almacenado con pixverse auth logout. Siempre verifique su saldo y los espacios disponibles antes de ejecutar trabajos por lotes.

Comandos de inicio rápido

Si solo necesita la ruta más corta desde la instalación hasta un activo generado, comience con esta secuencia:

npm install -g pixverse
pixverse auth login
pixverse create image --prompt "A photorealistic forest path at golden hour" --json
pixverse create video --prompt "A sunset over ocean waves" --model v6 --quality 720p --duration 5 --json

Para flujos de trabajo de agentes y CI, mantenga habilitados --json o -p para que stdout siga siendo legible por máquina mientras el progreso y los errores permanecen en stderr. Para los reintentos de producción, agregue --idempotency-key <key> a los comandos de creación para que los envíos repetidos no creen accidentalmente trabajos cargados duplicados.

Paso 3: genera tu primera imagen

La generación de texto a imagen es la forma más rápida de probar su configuración. Correr:

pixverse create image --prompt "A photorealistic forest path at golden hour" --json

El GitHub README actual incluye GPT Image 2 como modelo de imagen predeterminado. Para automatizaciones reproducibles, configure --model explícitamente y consulte la ayuda en vivo de CLI o capabilities.json antes del trabajo por lotes. El indicador --json devuelve una salida estructurada:

{ "image_id": 789012, "status": "completed", "image_url": "https://...", "prompt": "A photorealistic forest path at golden hour", "model": "gpt-image-2.0", "width": 1440, "height": 1440 }

Para obtener resultados de mayor resolución, especifique un modelo que lo admita:

pixverse create image \ --prompt "A photorealistic forest path at golden hour" \ --model seedream-5.0-lite \ --quality 2160p \ --aspect-ratio 16:9 \ --json

PixVerse admite varios modelos de imagen, cada uno con diferentes límites de resolución y soporte de relación de aspecto:

Modelo	`--model` value	Calidad	Notas
GPT Image 2	`gpt-image-2.0`	1080p, 1440p, 2160p	Modelo de imagen predeterminado; admite relaciones de aspecto anchas y altas
Nano Banana 2	`gemini-3.1-flash`	512p, 1080p, 1440p, 2160p	`auto` flexible y relaciones de aspecto estándar
Nano Banana 2 Lite	`gemini-3.1-flash-lite`	1080p	Opción ligera de Nano Banana 2 para flujos de imágenes rápidos
Qwen Image	`qwen-image`	720p, 1080p	Generación rápida para tareas creativas comunes
Nano Banana Pro	`gemini-3.0`	1080p, 1440p, 2160p	Creación de imágenes de alta calidad en tamaños más grandes
Nano Banana	`gemini-2.5-flash`	1080p	Generación de imágenes ligera con respuesta rápida
Seedream 5.0 Pro	`seedream-5.0-pro`	1080p, 1440p	Admite relaciones de aspecto estándar y flujos con múltiples imágenes de referencia
Seedream 5.0 Lite	`seedream-5.0-lite`	1440p, 1800p, 2160p	Imágenes creativas con mucho detalle
Seedream 4.5	`seedream-4.5`	1440p, 2160p	Generación de imágenes de alta resolución
Seedream 4.0	`seedream-4.0`	1080p, 1440p, 2160p	Opción adicional de Seedream para flujos de trabajo de imágenes
Kling Image O3	`kling-image-o3`	1080p, 1440p, 2160p	Resultados visuales estilizados con encuadres flexibles
Kling Image V3	`kling-image-v3`	1080p, 1440p	Calidad y velocidad equilibradas

También puedes transformar una imagen existente con imagen a imagen:

pixverse create image \ --prompt "Turn this product photo into a clean watercolor illustration" \ --image ./product-photo.png \ --model gpt-image-2.0 \ --json

Para descargar la imagen generada:

pixverse asset download 789012

Paso 4: genera tu primer video

La conversión de texto a vídeo funciona de la misma manera. Genera un clip de 5 segundos:

pixverse create video --prompt "A sunset over ocean waves" --json

Para una generación totalmente personalizada:

pixverse create video \ --prompt "A cinematic drone shot over a misty mountain valley at dawn" \ --model v6 \ --quality 1080p \ --aspect-ratio 16:9 \ --duration 8 \ --audio \ --json

La bandera --audio habilita un sonido ambiental generado por IA que coincide con su contenido de video. El indicador --json devuelve un video_url al finalizar que puede pasar directamente a un comando de descarga o al siguiente paso de una canalización.

PixVerse proporciona múltiples modelos de video con diferente calidad, duración y modo de soporte:

Modelo	`--model` value	Calidad máxima	Duración	Notas
PixVerse V6	`v6`	1080p	1–15 segundos	Modelo de vídeo predeterminado; amplio soporte de relación de aspecto
PixVerse C1	`pixverse-c1`	1080p	1–15 segundos	Fuerte soporte en flujos de trabajo de video, referencia y transición
Seedance 2.0 Standard	`seedance-2.0-standard`	2160p	4-15 segundos	Admite modos de vídeo, referencia y transición
Seedance 2.0 Fast	`seedance-2.0-fast`	720p	4-15 segundos	Opción Seedance más rápida para modos de vídeo, referencia y transición
Seedance 2.0 Mini	`seedance-2.0-mini`	720p	4-15 segundos	Opción Seedance ligera para modos de vídeo, referencia y transición.
Google Gemini Omni	`gemini-omni-flash`	720p	3-10 segundos	Admite flujos de vídeo y referencia en 16:9 o 9:16
Happy Horse 1.0	`happyhorse-1.0`	1080p	3-15 segundos	Opción de vídeo con reconocimiento de audio disponible para `create video`
Kling O3 Pro	`kling-o3-pro`	720p	3-15 segundos	Admite flujos de trabajo de vídeo, referencia y transición
Kling O3 Standard	`kling-o3-standard`	720p	3-15 segundos	Opción estándar Kling O3
Kling 3.0 Pro	`kling-3.0-pro`	720p	3-15 segundos	Admite flujos de trabajo de transición y vídeo
Kling 3.0 Standard	`kling-3.0-standard`	720p	3-15 segundos	Opción estándar Kling 3.0
Grok Imagine 1.5	`grok-imagine-1.5`	720p	1–15 segundos	Sólo imagen a vídeo; requiere `--image` y sigue la relación de aspecto de la imagen de entrada
Grok Imagine	`grok-imagine`	720p	1–15 segundos	Opción anterior de Grok; admite flujos de trabajo de vídeo, ampliación y referencia
Veo 3.1 Lite	`veo-3.1-lite`	1080p	4, 6 u 8 segundos	Admite flujos de trabajo de transición de vídeo y de 2 cuadros
Veo 3.1 Standard	`veo-3.1-standard`	2160p	4, 6 u 8 segundos	Opción Veo de mayor resolución
Veo 3.1 Fast	`veo-3.1-fast`	2160p	4, 6 u 8 segundos	Opción Veo más rápida
Sora 2 Pro	`sora-2-pro`	1080p	4, 8 o 12 segundos	Opción Sora de duración fija
Sora 2	`sora-2`	720p	4, 8 o 12 segundos	Opción estándar de Sora
PixVerse v5.6	`v5.6`	1080p	1 a 10 segundos	Todavía se utiliza para control de movimiento y flujos de trabajo de generación seleccionada.
PixVerse v5.5	`v5.5`	1080p	1 a 10 segundos	Utilizado para flujos de trabajo `create modify`
PixVerse v5	`v5`	1080p	1 a 10 segundos	Se utiliza para flujos de trabajo de transición de más de 3 cuadros

Animar una imagen estática

Para convertir una foto o imagen generada en un video, proporcione la marca --image:

pixverse create video \ --prompt "Gentle wind moves through the scene" \ --image ./product-photo.jpg \ --model v6 \ --quality 1080p \ --json

Puede pasar una ruta de archivo local o una URL. Los archivos locales se cargan automáticamente; no se requiere ningún paso de carga manual. Las entradas de imágenes locales mayores que 1920x1920 o 5MB se redimensionan o comprimen automáticamente antes de cargarlas; Las URL de imágenes remotas son validadas por el backend tal como están.

Para Grok Imagine 1.5, se requiere una imagen y la relación de aspecto de salida sigue esa imagen:

pixverse create video \ --prompt "Slow camera push-in, subtle fabric motion, clean native ambience" \ --image ./campaign-poster.png \ --model grok-imagine-1.5 \ --quality 720p \ --duration 6 \ --json

Utilice referencia, transición, control de movimiento y plantillas

El CLI actual admite más que la simple conversión de texto a video e imagen a video. Estos modos de creación son útiles cuando necesitas más control sobre personajes, fotogramas clave, ediciones o efectos:

# Create a transition between keyframes pixverse create transition --images ./frame1.png ./frame2.png # Generar audio de voz a partir de texto pixverse create voice --text "Welcome to the launch" --voice-id <preset_voice_id> --output ./voiceover.mp3 # Generar música desde un mensaje pixverse create music --prompt "A cinematic synth-pop intro with bright percussion" --auto-lyrics pixverse create music --prompt "Uplifting piano theme for a product reveal" --instrumental --duration-seconds 60 # Ampliar un vídeo generado pixverse create extend --video <video_id> # Modificar un vídeo existente pixverse create modify --video <video_id> --prompt "Change the background to a beach" # Resolución de vídeo de lujo pixverse create upscale --video <video_id> --quality 1080p # Generar vídeo con imágenes de referencia. pixverse create reference --images ./char1.png ./char2.png --prompt "Two friends walking in a park" # La referencia de Seedance 2.0 puede mezclar entradas de imagen y vídeo pixverse create reference \ --model seedance-2.0-standard \ --images ./character.png \ --videos ./motion.mp4 \ --prompt "@image1 follows the motion in @video1" # Los modelos Seedance 2.0 admiten hasta 9 imágenes de referencia pixverse create reference \ --model seedance-2.0-standard \ --images ./char1.png ./char2.png ./char3.png ./char4.png \ --prompt "@image1 and @image2 walk through the scene together" # Control de movimiento con imagen de personaje y vídeo de referencia de movimiento. pixverse create motion-control --image ./character.png --video ./dance.mp4 # Crear a partir de una plantilla o efecto pixverse create template --template-id 12345 --image ./photo.png

No todos los modelos admiten todos los modos de creación. En la matriz README actual, create video admite v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Google Gemini Omni, Happy Horse 1.0, Kling O3, Kling 3.0, Grok Imagine, Veo 3.1, Sora 2 y v5.6. grok-imagine-1.5 es sólo de imagen a vídeo y requiere --image; create extend admite v6 y grok-imagine; create reference admite v6, pixverse-c1, Seedance 2.0 Standard/Fast/Mini, Google Gemini Omni, Kling O3, grok-imagine y v5.6; Las transiciones de 2 fotogramas admiten las familias de vídeos más nuevas; Más de 3 transiciones de fotogramas utilizan v5; create modify utiliza v5.5; y create motion-control usa v5.6.

Paso 5: generar voz y música

El GitHub README actual documenta audio independiente a través de comandos de creación dedicados. Utilice create voice para conversión de texto a voz y create music para generación de mensajes a música. Las salidas de voz y música se guardan como activos de audio, por lo que puede rastrearlas con task, listarlas con asset list --type audio y descargarlas con asset download --type audio. Para un ambiente de video nativo, use --audio o --no-audio en los comandos de creación de video compatibles.

Generar audio de voz:

pixverse create voice \ --text "Welcome to the launch. Here is what changed this week." \ --model speech-2.8-hd \ --voice-id <preset_voice_id> \ --output ./voiceover.mp3 \ --json

Explorar modelos de voz y voces preestablecidas:

pixverse voice models --json pixverse voice presets --model speech-2.8-hd --json

Generar música:

pixverse create music \ --prompt "A bright cinematic synth-pop track for a 30-second product reveal" \ --auto-lyrics \ --duration-seconds 30 \ --json

Para pistas instrumentales, utilice --instrumental. Para modelos con capacidad para letras, pase las letras como texto literal, una ruta de archivo local o stdin:

pixverse create music \ --prompt "Uplifting electronic pop with a confident chorus" \ --lyrics ./lyrics.txt \ --json

Las familias de modelos de voz actuales incluyen los modelos MiniMax Speech 2.8 y ElevenLabs. Las familias de modelos musicales actuales incluyen MiniMax Music, ElevenLabs Music y Google Lyria 3 Pro. Utilice pixverse voice models y pixverse music models para el catálogo en vivo antes de programar un flujo de trabajo de producción.

Paso 6: ejecute el asistente interactivo

Si está explorando por primera vez y aún no está familiarizado con todos los indicadores disponibles, ejecute cualquier comando de creación sin argumentos para ingresar al asistente guiado:

pixverse create video pixverse create image

El asistente le guiará paso a paso a través de las indicaciones, la selección del modelo, la calidad, la relación de aspecto, la duración y otras opciones, lo que resulta útil para descubrir qué parámetros están disponibles antes de programarlos.

Más allá de la generación: administre sus activos y su espacio de trabajo

El PixVerse CLI actual también incluye comandos de administración que lo ayudan a crear flujos de trabajo de terminal de un extremo a otro:

pixverse task status <id> y pixverse task wait <id> para sondeo de tareas
pixverse task status --ids 123,456,789 --type video --json para verificaciones de estado de lotes
pixverse asset list, asset upload, asset info, asset download y asset delete para operaciones del ciclo de vida de activos de vídeo, imagen y audio.
pixverse saved list, saved items, saved new, saved rename, saved add, saved remove y saved delete para carpetas guardadas
pixverse template categories, template list, template search y template info para descubrir efectos y plantillas
pixverse voice models, voice presets y music models para el descubrimiento de modelos de audio en vivo
pixverse workspace list, workspace status, workspace switch y workspace manage para operaciones en múltiples espacios de trabajo
pixverse account info, account usage y account slots para verificaciones de crédito, uso y simultaneidad
pixverse config set, config list, config path y config defaults para valores predeterminados locales repetibles

Esto hace que sea sencillo automatizar no solo la creación, sino también la organización, el descubrimiento de plantillas, el descubrimiento de audio, la descarga, el enrutamiento del espacio de trabajo y la entrega en un solo script. Si necesita ejecutar un comando en un espacio de trabajo diferente, utilice el indicador global --workspace-id <id>; 0 se dirige a su espacio de trabajo personal.

Banderas compatibles con secuencias de comandos

La mayor parte de la automatización depende de resultados predecibles y de un comportamiento de tiempo de ejecución predecible. Estas marcas son especialmente útiles en scripts y flujos de trabajo de agentes de IA:

Bandera	Úselo para
`--json`	Devolver salida estructurada JSON
`-p`	Alias corto para `--json`
`--count <n>`	Genere de 1 a 4 variaciones a partir de una solicitud
`--seed <number>`	Hacer que una generación sea más fácil de reproducir
`--off-peak`	Utilice precios de temporada baja cuando estén disponibles
`--audio` / `--no-audio`	Habilite o deshabilite la generación de audio en los comandos de creación admitidos
`--multi-shot` / `--no-multi-shot`	Activar o desactivar el modo de toma múltiple para vídeo
`--no-wait`	Envíe el trabajo y regrese inmediatamente
`--timeout <sec>`	Establezca el tiempo de espera del sondeo, por defecto en 300 segundos.
`--workspace-id <id>`	Anular el espacio de trabajo activo para un solo comando
`--trace-id <uuid>`	Adjunte un UUIDv4 proporcionado por la persona que llama a las solicitudes de API para depuración y observabilidad
`--idempotency-key <key>`	Reintente de forma segura las solicitudes de creación sin crear accidentalmente trabajos cargados duplicados

Los indicadores de entrada de texto ahora son más fáciles de automatizar. --prompt, --text y --lyrics pueden aceptar una cadena literal, una ruta de archivo local o - para stdin:

pixverse create video --prompt ./scene.txt --json cat scene.txt | pixverse create image --prompt - --json echo "Hello from the command line" | pixverse create voice --text - --json pixverse create music --prompt "Bright synth-pop" --lyrics ./lyrics.txt --json

Enseñar a su agente de IA a generar medios

Para equipos que prefieren un punto de partida guiado en la aplicación antes de pasar a la automatización por línea de comandos, PixVerse Agent ofrece un flujo de creación orientado a agentes dentro de la aplicación PixVerse.

Aquí es donde PixVerse CLI se vuelve genuinamente transformador. Debido a que los comandos pueden devolver JSON estructurado y usar códigos de salida deterministas, cualquier agente de IA que pueda ejecutar comandos de shell puede aprender a generar imágenes y videos a pedido.

Instalación de PixVerse Skills

PixVerse Skillses una biblioteca de habilidades estructurada que enseña a los agentes cómo usar CLI correctamente: indicadores de comando, restricciones de modelo, canalizaciones de varios pasos y manejo sólido de errores.

Para Claude Code y otros agentes que admiten el formato de habilidades, agregue las habilidades PixVerse directamente:

npx skills add https://github.com/pixverseai/skills --skill pixverse-ai-image-and-video-generator

Para Cursor, Claude Code, Codex y otros marcos de agentes, esta habilidad mejora la confiabilidad al darle al agente restricciones explícitas en lugar de obligarlo a inferirlas desde cero.

PixVerse CLI también incluye un manifiesto de comando compacto legible por máquina en dist/capabilities.json, con la fuente pública disponible como capabilities.json en el repositorio GitHub. Este manifiesto describe comandos, indicadores, códigos de salida, expectativas de salida de JSON y categorías de efectos, para que los agentes puedan inspeccionar el contrato CLI sin tener que extraer el texto de ayuda.

Una vez que su agente tenga cargadas las habilidades PixVerse, puede darle instrucciones en lenguaje natural como:

“Genere un vídeo de demostración del producto de 10 segundos a partir de esta captura de pantalla”
“Crea cuatro variaciones de la imagen de portada de este blog en formato 16:9”
“Anima este diagrama en un clip explicativo de 5 segundos con sonido ambiental”
“Genera tres clips promocionales de 8 segundos en formato 16:9 con diferentes movimientos de cámara”

El agente traducirá esas instrucciones a los comandos CLI correctos, analizará la salida de JSON y manejará el sondeo y las descargas, sin necesidad de intervención manual.

Claude Code

En Claude Code, PixVerse CLI se convierte en una herramienta nativa que el agente utiliza de forma autónoma. Después de cargar las habilidades PixVerse, puede incluir la generación de medios directamente en cualquier tarea:

Generate a cover image for this blog post about machine learning, use the seedream-5.0-lite model at 2160p in 16:9 format, download it to ./assets/cover.webp

Claude Code invocará los comandos CLI correctos, analizará la URL de la imagen de la respuesta JSON y descargará el archivo a la ruta especificada, todo dentro de la misma sesión donde también escribe su código.

Un flujo de trabajo típico de Claude Code:

# Claude Code runs this autonomously based on your instruction IMG=$(pixverse create image \ --prompt "Abstract visualization of neural network layers, dark background, blue and purple tones" \ --model seedream-5.0-lite \ --quality 2160p \ --aspect-ratio 16:9 \ --json | jq -r '.image_url') # Luego lo anima pixverse create video \ --prompt "Slow pan across glowing neural connections" \ --image "$IMG" \ --model v6 \ --quality 1080p \ --duration 6 \ --json

Cursor

Los usuarios de Cursor pueden cargar PixVerse Skills como un archivo de contexto del proyecto. Coloque los archivos de habilidades relevantes en su directorio .cursor/ o agréguelos a las reglas de su espacio de trabajo. Una vez cargado, Cursor tiene pleno conocimiento de cada comando de PixVerse CLI y puede generar medios como parte de cualquier tarea de codificación.

Un flujo de trabajo común de Cursor: solicite al agente que genere una imagen de maqueta basada en un diseño que esté creando y luego utilícela como referencia directamente en su sesión IDE, sin tener que salir del editor.

Codex y otros agentes

PixVerse CLI es compatible con cualquier agente que pueda ejecutar comandos de shell y analizar JSON. El formato de salida estructurado (nombres de campo consistentes, códigos de error predecibles y mensajes de error separados por stderr) garantiza que incluso los agentes de secuencias de comandos simples puedan integrar la generación de manera confiable.

El contrato del código de salida simplifica el manejo de errores:

Código	Significado	Acción del agente
0	Éxito	Analizar la salida JSON
1	error general	Verifique stderr y vuelva a intentarlo con entradas validadas
2	Se acabó el tiempo	Vuelva a intentarlo con un `--timeout` más largo
3	Autenticación caducada	Vuelva a ejecutar `pixverse auth login`
4	Sin créditos	Consultar saldo, notificar al usuario
5	Generación fallida	Pruebe diferentes parámetros
6	Error de validación	Revisar los valores de las banderas

Tuberías de automatización

Una vez que comprenda los comandos individuales, PixVerse CLI desbloquea potentes flujos de trabajo de varios pasos que se ejecutan completamente sin interacción del usuario.

Texto a imagen a vídeo

Uno de los procesos más útiles: generar una imagen de alta resolución a partir de un mensaje de texto y luego animarla en un video.

# Step 1: Generate a base image IMG_RESULT=$(pixverse create image \ --prompt "A cyberpunk cityscape at night, neon lights reflecting on wet pavement" \ --model gemini-3.1-flash \ --quality 2160p \ --aspect-ratio 16:9 \ --json) IMAGE_URL=$(echo "$IMG_RESULT" | jq -r '.image_url') # Paso 2: animarlo a un vídeo VID_RESULT=$(pixverse create video \ --prompt "Camera slowly pans across the neon-lit streets" \ --image "$IMAGE_URL" \ --model v6 \ --quality 1080p \ --duration 8 \ --json) VIDEO_ID=$(echo "$VID_RESULT" | jq -r '.video_id') # Paso 3: descarga el vídeo final pixverse asset download "$VIDEO_ID" --json

Canal completo de producción de video

Para obtener resultados pulidos, cree una cadena con pasos de posprocesamiento. Utilice --audio o --no-audio cuando desee sonido nativo en comandos de creación de vídeo compatibles, luego utilice create voice para audio de texto a voz y create music para recursos musicales independientes que combinará posteriormente:

# Step 1: Create the base video RESULT=$(pixverse create video \ --prompt "A product being assembled in slow motion" \ --model v6 \ --quality 720p \ --duration 5 \ --audio \ --json) VID=$(echo "$RESULT" | jq -r '.video_id') # Paso 2: ampliar la duración EXTENDED=$(pixverse create extend \ --video "$VID" \ --json | jq -r '.video_id') pixverse task wait "$EXTENDED" --json # Paso 3: actualice a 1080p FINAL=$(pixverse create upscale \ --video "$EXTENDED" \ --quality 1080p \ --json | jq -r '.video_id') pixverse task wait "$FINAL" --json # Paso 4: Descargar pixverse asset download "$FINAL" --json # Opcional: cree un recurso de voz en off independiente pixverse create voice \ --text "The final reveal starts now." \ --voice-id <preset_voice_id> \ --output ./voiceover.mp3 \ --json

Generación por lotes

Para canalizaciones de contenido que requieren múltiples variaciones, ejecute trabajos en paralelo:

# Check credits and concurrent generation slots first pixverse account info --json pixverse account slots --json # Presentar cuatro generaciones paralelas. pixverse create video --prompt "Sunrise over mountains" --no-wait --json > /tmp/v1.json & pixverse create video --prompt "Sunset over ocean" --no-wait --json > /tmp/v2.json & pixverse create video --prompt "Stars over a desert" --no-wait --json > /tmp/v3.json & pixverse create video --prompt "Aurora over a frozen lake" --no-wait --json > /tmp/v4.json & wait # Verifique todos los ID de tareas devueltas en una llamada de estado de lote IDS=$(jq -r '.video_id' /tmp/v1.json /tmp/v2.json /tmp/v3.json /tmp/v4.json | paste -sd, -) pixverse task status --ids "$IDS" --type video --json # Espere cada uno y descargue. for f in /tmp/v1.json /tmp/v2.json /tmp/v3.json /tmp/v4.json; do ID=$(jq -r '.video_id' "$f") pixverse task wait "$ID" --json pixverse asset download "$ID" --json done

El indicador --no-wait envía el trabajo y regresa inmediatamente con un ID de tarea, lo que le permite enviar varios trabajos antes del sondeo. Con --no-wait --json, registre los ID de las tareas devueltas y los parámetros de creación resueltos para el registro y la reproducibilidad. Utilice --count <n> cuando desee múltiples variaciones de un mensaje y utilice task status --ids por lotes cuando desee una respuesta de estado para varios trabajos en ejecución. El comando pixverse task wait maneja el sondeo adaptativo por usted.

Configuración de valores predeterminados

Si utiliza constantemente el mismo modelo, calidad o relación de aspecto, configúrelos como predeterminados para no tener que repetir las marcas cada vez:

pixverse config defaults set video model v6 pixverse config defaults set video quality 1080p pixverse config defaults set image model seedream-5.0-lite pixverse config set output-dir ~/Downloads/pixverse pixverse config defaults show pixverse config list pixverse config path

Los indicadores de la línea de comandos siempre anulan los valores predeterminados configurados, por lo que conserva total flexibilidad y reduce la repetición. Para la automatización específica del espacio de trabajo, agregue --workspace-id <id> a un comando cuando desee anular el espacio de trabajo activo para esa única ejecución.

Lo que puedes construir

Con PixVerse CLI integrado en el flujo de trabajo de su agente, la gama de tareas automatizables se amplía considerablemente:

Documentación: genere automáticamente videos de demostración de productos y capturas de pantalla como parte del proceso de creación de documentos.
Marketing: ejecute trabajos por lotes nocturnos que produzcan variaciones de contenido de redes sociales desde una única biblioteca de indicaciones.
Desarrollo de aplicaciones: permita que su agente de codificación genere imágenes de marcador de posición, animaciones de maquetas o videos de pantalla de carga mientras crea la interfaz de usuario.
Flujos de trabajo de audio: genere borradores de voz en off, pistas de música o recursos de audio para editarlos más adelante.
Canalizaciones de contenido: encadene llamadas CLI con otras herramientas (ffmpeg, ImageMagick, almacenamiento en la nube) para crear flujos de trabajo de producción de medios totalmente automatizados.
Creación de prototipos: genere conceptos de movimiento rápido en segundos para validar ideas antes de comprometerse con la producción completa.

El CLI está diseñado para adaptarse de forma natural a cualquier flujo de trabajo basado en shell. Si su automatización existente se ejecuta en bash, Python, Node o una canalización de CI/CD, PixVerse CLI se integra sin ninguna sobrecarga de integración adicional.

Lista de verificación para comenzar

Mantener el CLI actualizado

Utilice el actualizador integrado para mantener actualizado su CLI local:

pixverse update

También puedes usar npm directamente:

npm install -g pixverse@latest

Como PixVerse CLI es una herramienta que se actualiza activamente y no un lanzamiento único, trate este artículo como una guía práctica y las fuentes oficiales como la capa de referencia en vivo. La página oficial de PixVerse CLI es la ruta más corta para instalar y preparar agentes, mientras que GitHub sigue siendo el lugar para seguir cambios de versión y modelos recién compatibles:

Los documentos actuales destacan PixVerse V6 como modelo de video predeterminado, GPT Image 2 como modelo de imagen predeterminado, compatibilidad de video con Google Gemini Omni, compatibilidad de imagen con Nano Banana 2 Lite y Seedream 5.0 Pro, compatibilidad con Seedance 2.0 Mini, flujos de trabajo PixVerse v5 y v5.5 específicos del modo, comandos dedicados create voice y create music, administración de recursos de audio, carpetas guardadas, cambio de espacio de trabajo, config defaults, capabilities.json para agentes, pixverse update, soporte de stdin para entradas de texto, --trace-id y --idempotency-key para reintentos más seguros.

Próximos pasos

La página oficial de PixVerse CLI, PixVerse CLI en GitHub y npm (npm install -g pixverse) le brindan acceso inmediato a generación, sondeo de tareas, administración de activos, plantillas, carpetas guardadas, verificaciones de cuentas, descubrimiento de modelos de audio y controles del espacio de trabajo desde una única interfaz. El repositorio PixVerse Skills agrega orientación lista para el agente para que Claude Code, Cursor, Codex y otras herramientas puedan ejecutar estos flujos de trabajo con mayor confiabilidad.

La combinación de un CLI confiable y una biblioteca de habilidades lista para el agente significa que la generación de imágenes, videos, voz y música puede vivir en el mismo flujo de trabajo que su código, administrado por el mismo agente, en el mismo terminal, sin cambiar de herramienta.

Comience con un solo comando. Construya desde allí.