PiAPI CLI Quick Start: genera imágenes y videos con IA desde tu terminal
PiAPI CLI es la interfaz oficial de línea de comandos para PiAPI. Te permite llamar modelos de IA multimodal para imágenes, videos, audio, 3D y LLM directamente desde la terminal.
Este quick start cubre instalación, autenticación con API key, tu primera imagen, una tarea de video async y cómo explorar modelos disponibles.
¿Qué es PiAPI CLI?
Definición rápida
PiAPI CLI es una herramienta de línea de comandos en Node.js para ejecutar modelos PiAPI sin abrir el dashboard web.
Un AI CLI sirve cuando el flujo empieza en la terminal: puedes guardar comandos, repetirlos, cambiar parámetros e integrarlos en scripts o agentes de IA.
- Generar assets desde prompts repetibles
- Probar rápido mientras construyes una app
- Subir archivos locales desde un proyecto
- Guardar outputs en una carpeta predecible
- Devolver JSON para scripts, CI o agentes
PiAPI CLI de un vistazo
| Paquete | piapi-cli |
|---|---|
| Comando | piapi |
| Runtime | Node.js 18+ |
| Uso principal | Generación de IA multimodal en terminal |
| Útil para | Desarrolladores, automatización y agentes de IA |
Requisitos previos
- Node.js 18 o superior
- Una API key de PiAPI
- Una app de terminal
Instalar PiAPI CLI
Instala el paquete piapi-cli con tu gestor JavaScript preferido.
npm install -g piapi-clipnpm add -g piapi-clibun add -g piapi-cliyarn global add piapi-clinpx piapi-cli@latest --helpAutenticarte con tu API key de PiAPI
Después de instalar, conecta el CLI con tu cuenta de PiAPI.
piapi auth login --api-key sk-xxxxxpiapi auth statusexport PIAPI_API_KEY=sk-...Generar tu primera imagen con IA desde la terminal
Una vez autenticado, genera una imagen con IA desde la terminal con piapi run.
piapi run flux-dev prompt="a corgi in space"piapi run gpt-image-2 prompt="a corgi in space" size=1024x1024Generar tu primer video con IA desde la terminal
La generación de video suele tardar más que la de imagen, así que conviene iniciar modelos de video como tareas async.
piapi run sora2-pro prompt="ocean waves" --asyncpiapi task get <id>Subir archivos locales y descargar resultados
PiAPI CLI puede subir archivos locales cuando un valor empieza por @ y descargar los resultados en la carpeta elegida.
piapi run remove-bg image=@./photo.png --download --out-dir ./outExplorar modelos y revisar cuota
Usa los comandos model para ver modelos, inspeccionar schemas y revisar cuota.
piapi model listpiapi model list --type videopiapi model schema flux-devpiapi quotaFlags útiles de PiAPI CLI
Flags útiles para automatización:
--async | Opción de workflow CLI |
--download | Opción de workflow CLI |
--out-dir <path> | Opción de workflow CLI |
--stream | Opción de workflow CLI |
--dry-run | Opción de workflow CLI |
--output json | JSON output for scripts and automation |
--webhook <url> | Opción de workflow CLI |
--quiet | Opción de workflow CLI |
--non-interactive | Opción de workflow CLI |
Usar PiAPI CLI con agentes de IA y automatización
PiAPI CLI también funciona dentro de agentes de IA, scripts de shell, jobs CI y workflows de automatización.
npx skills add PiAPI-1/piapi-clipiapi run flux-dev prompt="a product photo on a white background" --output jsonMidjourney n8n integration guide
Solución de problemas comunes de PiAPI CLI
Si tu primer comando falla, revisa estos problemas comunes antes de cambiar el prompt o el modelo.
Comando piapi no encontrado
npx piapi-cli@latest --help
API key inválida o faltante
piapi auth status
El comando de video devuelve un task ID en lugar de un archivo
piapi task get <id>
¿Cuándo usar PiAPI CLI en lugar de la Web UI?
Usa PiAPI CLI cuando quieras un workflow repetible, scriptable o apto para agentes de IA. La Web UI sirve para exploración visual; el CLI sirve mejor para automatización.
FAQ
¿Qué es PiAPI CLI?
PiAPI CLI es una herramienta de línea de comandos en Node.js para ejecutar modelos PiAPI sin abrir el dashboard web.
¿Cómo instalo PiAPI CLI?
npm install -g piapi-cli / npx piapi-cli@latest --help
¿Puedo generar imágenes y videos con IA desde la terminal?
piapi run flux-dev prompt="a corgi in space" / piapi run sora2-pro prompt="ocean waves" --async
Empieza a construir con PiAPI CLI
PiAPI CLI da a desarrolladores y agentes de IA una forma práctica de generar imágenes, videos, audio, assets 3D y respuestas LLM desde la línea de comandos.
