PixVerse CLI: generación de video e imágenes con IA para desarrollo

Introducción

Todo flujo de trabajo creativo tiene un cuello de botella: el momento en que necesita salir de su editor de código, abrir un navegador y recorrer manualmente una interfaz web para generar una pieza de contenido. Para desarrolladores, agentes de IA y cualquier equipo que construya pipelines de contenido automatizados, ese cambio de contexto es una fricción que se acumula rápidamente.

PixVerse CLI elimina ese cuello de botella. Es la interfaz oficial de línea de comandos de PixVerse y le da acceso a cada modelo, cada función y cada capacidad de la plataforma PixVerse directamente desde su terminal. Texto a video, imagen a video, texto a imagen, sincronización labial, efectos de sonido, upscaling: todo es scriptable, encadenable y utilizable sin tocar el navegador.

Lo que hace especialmente potente a PixVerse CLI es su filosofía de diseño: fue creado pensando en agentes de IA. Cada comando devuelve JSON estructurado, cada código de salida es determinista y cada paso del pipeline es componible. Eso significa que puede enseñar a Claude Code, Cursor, Codex o cualquier otro agente a generar imágenes y videos por usted, y lo hará correctamente cada vez.

Esta guía le acompaña en todo el recorrido: desde la instalación hasta su primera generación, y después hacia pipelines de automatización de varios pasos y flujos de trabajo nativos para agentes.

Requisitos previos

Antes de empezar, necesita:

• Node.js 20 o superior — compruébelo con node --version
• Una cuenta de PixVerse — regístrese en pixverse.ai
• Una suscripción activa a PixVerse — la CLI usa el mismo sistema de créditos del sitio web; solo usuarios suscritos pueden generar contenido

PixVerse CLI no requiere copiar claves API manualmente. La autenticación se gestiona mediante un flujo OAuth en navegador que guarda su token en local.

Paso 1: Instalar la CLI

Instálela globalmente con npm:

npm install -g pixverse

Verifique la instalación:

pixverse --version

Si prefiere no instalarla de forma global, también puede ejecutar comandos con npx:

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

Paso 2: Autenticarse

Ejecute el comando de inicio de sesión:

pixverse auth login

La CLI abre un navegador para la autorización OAuth por dispositivo. También puede copiar la URL y completar la autorización desde cualquier navegador y dispositivo, algo útil en entornos SSH o headless. Su token se guarda automáticamente en ~/.pixverse/ y tiene validez de 30 días.

Para verificar que inició sesión y consultar sus créditos disponibles:

pixverse auth status
pixverse account info

El comando account info muestra su nivel de suscripción, créditos restantes y la programación del reinicio diario de créditos. Revise siempre su saldo antes de ejecutar lotes.

Paso 3: Generar su primera imagen

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

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

La bandera --json devuelve salida estructurada:

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

Para resultados de mayor resolución, especifique un modelo compatible:

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

PixVerse admite varios modelos de imagen, cada uno con distintos límites de resolución y fortalezas:

Para descargar la imagen generada:

pixverse asset download 789012

Paso 4: Generar su primer video

Texto a video funciona igual. Genere 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 sonido ambiental generado por IA que coincide con su contenido de video. La bandera --json devuelve video_url al finalizar, que puede pasar directamente a un comando de descarga o al siguiente paso del pipeline.

PixVerse ofrece múltiples modelos de video con capacidades diferentes:

Animar una imagen estática

Para convertir una foto o imagen generada en video, utilice la bandera --image:

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

Puede pasar una ruta local o una URL. Los archivos locales se cargan automáticamente, sin paso manual de subida.

Paso 5: Ejecutar el asistente interactivo

Si está explorando por primera vez y todavía no conoce todas las banderas disponibles, ejecute cualquier comando de creación sin argumentos para abrir el asistente guiado:

pixverse create video
pixverse create image

El asistente le guía paso a paso por prompt, selección de modelo, calidad, relación de aspecto, duración y otras opciones, útil para descubrir parámetros antes de llevarlos a scripts.

Más allá de generar: gestionar assets y workspace

La versión más reciente de PixVerse CLI también incluye comandos de gestión para construir flujos terminal end-to-end:

• pixverse task status <id> y pixverse task wait <id> para sondeo de tareas
• pixverse asset list|upload|info|download|delete para operaciones de ciclo de vida de assets
• pixverse saved list|items|new|rename|add|remove|delete para carpetas guardadas
• pixverse workspace list|status|switch|manage para operaciones con múltiples workspaces

Esto facilita automatizar no solo la generación, sino también la organización, descarga y entrega en un único script.

Enseñar a su agente de IA a generar contenido multimedia

Aquí es donde PixVerse CLI se vuelve realmente transformador. Como cada comando devuelve JSON estructurado y usa códigos de salida deterministas, cualquier agente de IA capaz de ejecutar comandos shell puede aprender a generar imágenes y videos bajo demanda.

Instalar PixVerse Skills

PixVerse Skills es una biblioteca de skills estructurada que enseña a los agentes a usar la CLI correctamente: banderas de comandos, límites de modelos, pipelines de varios pasos y manejo robusto de errores.

Para Claude Code y otros agentes compatibles con formato de skills, agregue las skills de 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 skill mejora la confiabilidad porque da restricciones explícitas al agente en vez de forzarlo a inferirlas desde cero.

Una vez que su agente cargue PixVerse Skills, puede darle instrucciones en lenguaje natural como:

• “Generate a 10-second product demo video from this screenshot”
• “Create four variations of this blog cover image in 16:9 format”
• “Animate this diagram into a 5-second explainer clip with ambient sound”
• “Generate three 8-second 16:9 promo clips with different camera motions”

El agente traducirá esas instrucciones en comandos CLI correctos, analizará la salida JSON y gestionará sondeo y descargas sin intervención manual.

Claude Code

En Claude Code, PixVerse CLI se convierte en una herramienta nativa que el agente usa de forma autónoma. Tras cargar PixVerse Skills, puede incluir generación de contenido multimedia directamente en cualquier tarea:

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

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

Un flujo típico en 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 1800p \
  --aspect-ratio 16:9 \
  --json | jq -r '.image_url')
 
# Then animates it
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 archivo de contexto de proyecto. Coloque los archivos de skill relevantes en su directorio .cursor/ o añádalos a las reglas de su workspace. Una vez cargados, Cursor conoce todos los comandos de PixVerse CLI y puede generar contenido multimedia como parte de cualquier tarea de desarrollo.

Un flujo común en Cursor: pedir al agente que genere una imagen mockup basada en un diseño que está construyendo y usarla como referencia directamente en su sesión del IDE, sin salir del editor.

Codex y otros agentes

PixVerse CLI es compatible con cualquier agente que pueda ejecutar comandos shell y analizar JSON. El formato de salida estructurado, con nombres de campo consistentes, códigos de error predecibles y mensajes de error separados por stderr, garantiza que incluso agentes de scripting simples integren la generación con confiabilidad.

El contrato de códigos de salida simplifica el manejo de errores:

Pipelines de automatización

Una vez que comprende los comandos individuales, PixVerse CLI habilita potentes flujos de varios pasos que se ejecutan por completo sin interacción del usuario.

Texto a imagen a video

Uno de los pipelines más útiles: generar una imagen en alta resolución desde un prompt de texto y luego animarla en 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')
 
# Step 2: Animate it into a video
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')
 
# Step 3: Download the final video
pixverse asset download "$VIDEO_ID" --json

Pipeline completo de producción de video

Para obtener resultados pulidos, encadene la creación con pasos de postprocesado:

# Step 1: Create the base video
RESULT=$(pixverse create video \
  --prompt "A product being assembled in slow motion" \
  --model v6 \
  --quality 720p \
  --duration 5 \
  --json)
 
VID=$(echo "$RESULT" | jq -r '.video_id')
 
# Step 2: Extend duration
EXTENDED=$(pixverse create extend \
  --video "$VID" \
  --prompt "Continue the assembly sequence" \
  --duration 5 \
  --json | jq -r '.video_id')
 
pixverse task wait "$EXTENDED" --json
 
# Step 3: Add ambient sound
WITH_SOUND=$(pixverse create sound \
  --video "$EXTENDED" \
  --prompt "Industrial workshop ambience, soft mechanical sounds" \
  --json | jq -r '.video_id')
 
pixverse task wait "$WITH_SOUND" --json
 
# Step 4: Upscale to 1080p
FINAL=$(pixverse create upscale \
  --video "$WITH_SOUND" \
  --quality 1080p \
  --json | jq -r '.video_id')
 
pixverse task wait "$FINAL" --json
 
# Step 5: Download
pixverse asset download "$FINAL" --json

Generación por lotes

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

# Check credits first
CREDITS=$(pixverse account info --json | jq -r '.credits.total')
echo "Available credits: $CREDITS"
 
# Submit four parallel generations
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
 
# Wait for each and download
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

La bandera --no-wait envía el trabajo y devuelve de inmediato un ID de tarea, lo que permite enviar varios trabajos antes del sondeo. El comando pixverse task wait gestiona el sondeo adaptativo por usted, sin bucles manuales de sleep.

Configurar valores predeterminados

Si usa siempre el mismo modelo, calidad o relación de aspecto, defínalos como predeterminados para evitar repetir banderas:

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

Las banderas de línea de comandos siempre prevalecen sobre los valores predeterminados configurados, de modo que conserva flexibilidad total mientras reduce repetición.

Qué puede construir

Con PixVerse CLI integrado en su flujo de trabajo con agentes, el rango de tareas automatizables se amplía de forma considerable:

• Documentación — generar automáticamente videos de demo de producto y capturas de pantalla dentro de su build de documentación
• Marketing — ejecutar lotes nocturnos que producen variaciones para redes sociales desde una sola biblioteca de prompts
• Desarrollo de apps — permitir que su agente de código genere visuales placeholder, animaciones mockup o videos de carga mientras desarrolla la UI
• Pipelines de contenido — encadenar llamadas CLI con otras herramientas (ffmpeg, ImageMagick, cloud storage) para crear producción multimedia totalmente automatizada
• Prototipado — generar conceptos de movimiento en segundos para validar ideas antes de comprometer producción completa

La CLI está diseñada para integrarse de forma natural en cualquier flujo basado en shell. Si su automatización actual se ejecuta en bash, Python, Node o un pipeline CI/CD, PixVerse CLI se integra sin sobrecarga adicional.

Lista de inicio rápido

• Instalar Node.js 20 o superior
• Ejecutar npm install -g pixverse
• Ejecutar pixverse auth login y autorizar en navegador
• Ejecutar pixverse account info para verificar créditos
• Generar su primera imagen: pixverse create image --prompt "..." --json
• Generar su primer video: pixverse create video --prompt "..." --json
• Instalar PixVerse Skills para su agente (Claude Code, Cursor o Codex)
• Configurar sus predeterminados con pixverse config defaults set
• Construir su primer pipeline de automatización

Mantener la CLI actualizada

Utilice npm para mantener su CLI local actualizada:

npm update -g pixverse

Para cambios por release y nuevos modelos compatibles, revise el changelog oficial de la CLI:

• PixVerse CLI Changelog

Próximos pasos

PixVerse CLI en npm (npm install -g pixverse) le da acceso inmediato a generación, sondeo de tareas, gestión de assets, carpetas guardadas y control de workspaces desde una única interfaz. El repositorio PixVerse Skills añade guía preparada para agentes para que Claude Code, Cursor, Codex y otras herramientas ejecuten estos flujos con mayor confiabilidad.

La combinación de una CLI confiable y una biblioteca de skills preparada para agentes permite que la generación de imagen y video viva en el mismo flujo que su código: gestionada por el mismo agente, en el mismo terminal y sin cambiar de herramienta.

Empiece con un solo comando. Escale desde ahí.