Le CLI Flatkey apporte la génération de médias à votre terminal sur un solde unique. Chaque commande accepte --json, ce qui permet de l’appeler en toute sécurité depuis un script, un job CI ou un agent IA qui analyse la sortie stdout.
Installation et authentification
Nécessite Node.js 18 ou une version plus récente. Pour l’intégration continue, définissez une variable d’environnement plutôt que de vous connecter :
Vérifiez ce que le CLI utilise :
Générez votre premier fichier
Passez toujours --model. Le modèle d’image par défaut intégré n’est pas actuellement routable et retourne No available channel.
Commandes
Options globales
Placez -o avant --json. La forme courte est rejetée comme argument inattendu lorsqu’elle apparaît après --json. --output fonctionne quelle que soit sa position.
Options vidéo
--ratio accepte 16:9, 9:16, 4:3, 3:4, 21:9 et 1:1. --resolution accepte 480p, 720p et 1080p, mais chaque modèle ne prend en charge qu’une partie de cette plage — voir Génération vidéo.
Options audio
Exécutez flatkey audio voices --json et passez un voice_id listé à --voice-id.
Piloter depuis un agent
En mode --json, stdout contient exactement un objet JSON et stderr contient une erreur JSON. Exécutez flatkey help --ai pour afficher une description compacte du protocole qu’un agent peut lire à l’exécution.
Listez d’abord les modèles, puis générez. Un identifiant de modèle codé en dur est la cause la plus fréquente d’échec d’exécution.
Récupération après erreur
Ne réessayez qu’après avoir modifié la requête. Ces erreurs sont déterministes : répéter des arguments identiques fait perdre du temps sans changer le résultat.