El CLI de Flatkey lleva la generación de contenido multimedia a tu terminal con un único saldo. Todos los comandos aceptan --json, lo que permite llamarlos de forma segura desde un script, un trabajo de CI o un agente de IA que analice la salida estándar.
Instalar y autenticar
Requiere Node.js 18 o superior. Para entornos de CI, define una variable de entorno en lugar de iniciar sesión:
Comprueba qué configuración está usando el CLI:
Genera tu primer archivo
Pasa siempre --model. El modelo de imagen predeterminado integrado no es enrutable en este momento y devuelve No available channel.
Comandos
Opciones globales
Coloca -o antes de --json. La forma abreviada se rechaza como argumento inesperado cuando aparece después de --json. --output funciona en cualquier posición.
Opciones de vídeo
--ratio acepta 16:9, 9:16, 4:3, 3:4, 21:9 y 1:1. --resolution acepta 480p, 720p y 1080p, pero cada modelo solo admite parte de ese rango — consulta Generación de vídeo.
Opciones de audio
Ejecuta flatkey audio voices --json y pasa un voice_id de la lista a --voice-id.
Ejecutarlo desde un agente
En modo --json, la salida estándar contiene exactamente un objeto JSON y stderr contiene un error JSON. Ejecuta flatkey help --ai para imprimir una descripción compacta del protocolo que un agente puede leer en tiempo de ejecución.
Lista primero los modelos y luego genera. Un id de modelo codificado de forma fija es la causa más común de un fallo en la ejecución.
Recuperación
Reintenta solo después de cambiar la solicitud. Estos errores son deterministas, por lo que repetir los mismos argumentos consume tiempo sin cambiar el resultado.