Línea de comandos
Genera imágenes y video desde tu terminal
El comando spicyapi te permite explorar modelos, consultar un precio exacto, lanzar una generación y descargar el resultado sin escribir código. Los comandos de pago siempre se detienen y piden confirmación.
Para qué sirve la CLI
Es la forma más rápida de probar un modelo: escribes un comando, ves el precio exacto, aceptas y recibes el archivo. Sin proyecto y sin código.
- Escribes un comandoTerminal o PowerShell
- spicyapiMuestra el precio exacto y pregunta antes
- Tu resultadoUn enlace de descarga, o JSON para scripts
Ideal para
- Probar modelos rápidoCompara modelos y precios antes de escribir una línea de código.
- Scripts de shellPasa la salida de --json a jq, a trabajos programados o a pasos de CI.
- Agentes de programaciónLos agentes pueden ejecutar comandos y leer el resultado en JSON.
Configúralo en dos minutos
- Paso 1
Instala Node.js 22.13 o posterior
Ejecuta node -v. Si muestra una versión anterior, instala la versión LTS desde nodejs.org y vuelve a abrir el terminal.
terminal node -v - Paso 2
Guarda tu clave en SPICY_API_KEY
La CLI lee la clave solo del entorno. Nunca la acepta como argumento ni la imprime, así que no puede filtrarse por el historial del shell.
export SPICY_API_KEY="sk-spicy-..." # paste your own key$env:SPICY_API_KEY = "sk-spicy-..." - Paso 3
Ejecútala con npx o instálala una vez
npx ejecuta la última versión sin instalar nada. Instálala de forma global si la usas a diario.
npx @spicyapi/cli statusnpm install -g @spicyapi/cli spicyapi status
Tu primera imagen desde la terminal
Busca un modelo que puedas llamar, consulta el precio exacto y luego crea la tarea y espera el resultado. Pon la entrada en un archivo para evitar problemas con las comillas de la shell.
- Paso 1
Busca un modelo
Lista los modelos de imagen que puedes llamar, con sus precios.
models list spicyapi models list --modality image --json - Paso 2
Consulta el precio
Pon tu prompt en un archivo y obtén el costo exacto. No se cobra nada.
tasks quote echo '{ "prompt": "A cinematic night portrait" }' > input.json spicyapi tasks quote --model MODEL_ID_FROM_CATALOG --input-file input.json - Paso 3
Crea y espera
La CLI muestra el precio, pide tu confirmación y espera el resultado.
tasks create spicyapi tasks create \ --model MODEL_ID_FROM_CATALOG \ --input-file input.json \ --wait - Paso 4
Descárgalo
Guarda el archivo desde el enlace del resultado antes de que caduque.
download curl -L -o result.png "PASTE_THE_URL_HERE"
Qué puedes hacer
Solo dos comandos gastan dinero, y ambos muestran el precio y esperan tu confirmación.
Explorar
01spicyapi statusComprobar que SpicyAPI responde
Gratisspicyapi models listListar los modelos disponibles, con precios
Gratisspicyapi models get <model>Ver los ajustes exactos que acepta un modelo
Gratisspicyapi balanceConsultar tu saldo
Gratis
Precio
02spicyapi tasks quoteObtener el precio exacto antes de empezar
Gratis
Generar
03spicyapi tasks createIniciar una generación de imagen o video
Pide confirmación antes de cobrarspicyapi tasks wait <task-id>Esperar a que termine una generación
Gratisspicyapi tasks get <task-id>Ver una generación y los enlaces de su resultado
Gratis
Archivos
04spicyapi files upload <path>Subir una imagen, un video o un audio como entrada
Gratisspicyapi files download-url <task-id>Obtener un enlace de descarga nuevo para un resultado
Gratis
Pensada también para scripts y agentes de IA
Añade --json a cualquier comando para obtener el resultado completo en JSON; los errores salen como una línea JSON en stderr y, si algo falla, el código de salida es distinto de cero. Los agentes de programación pueden ejecutar la CLI directamente o usar el servidor MCP para una integración más completa.
spicyapi --json tasks get <task-id> > task.jsonSoluciona errores comunes
Casi todos los problemas del principio son uno de estos tres. Cada tarjeta muestra lo que ves y lo único que debes cambiar.
- $
command not found: spicyapi
La instalación global no está en tu PATH. Ejecuta npx @spicyapi/cli, o reinstala con npm install -g @spicyapi/cli.
- clave
Clave sin definir
SPICY_API_KEY solo dura en la ventana donde la definiste. Vuelve a definirla o añádela al perfil de tu shell.
- node
Node.js es demasiado antiguo
La CLI necesita Node.js 22.13 o posterior. Compruébalo con node -v e instala la versión LTS actual.