Skip to main content
Die Flatkey CLI bringt Mediengenerierung in Ihr Terminal – über ein einziges Guthaben. Jeder Befehl akzeptiert --json, was sichere Aufrufe aus einem Skript, einem CI-Job oder einem KI-Agenten ermöglicht, der stdout verarbeitet.

Installieren und authentifizieren

Erfordert Node.js 18 oder neuer. Für CI setzen Sie statt des Einloggens eine Umgebungsvariable:
Prüfen Sie, was die CLI verwendet:

Erste Datei generieren

Übergeben Sie immer --model. Das integrierte Standard-Bildmodell ist derzeit nicht routebar und gibt No available channel zurück.

Befehle

Globale Optionen

Platzieren Sie -o vor --json. Die Kurzform wird als unerwartetes Argument abgelehnt, wenn sie nach --json erscheint. --output funktioniert an jeder Position.

Video-Optionen

--ratio akzeptiert 16:9, 9:16, 4:3, 3:4, 21:9 und 1:1. --resolution akzeptiert 480p, 720p und 1080p, aber jedes Modell unterstützt nur einen Teil dieses Bereichs – siehe Videogenerierung.

Audio-Optionen

Führen Sie flatkey audio voices --json aus und übergeben Sie eine aufgelistete voice_id an --voice-id.

Vom Agenten steuern

Im --json-Modus enthält stdout genau ein JSON-Objekt und stderr einen JSON-Fehler. Führen Sie flatkey help --ai aus, um eine kompakte Protokollbeschreibung auszugeben, die ein Agent zur Laufzeit lesen kann.
Listen Sie zuerst die Modelle auf, dann generieren Sie. Eine fest kodierte Modell-ID ist die häufigste Ursache für einen fehlgeschlagenen Lauf.

Fehlerbehebung

Wiederholen Sie den Versuch nur nach einer Änderung der Anfrage. Diese Fehler sind deterministisch, sodass das Wiederholen identischer Argumente Zeit verschwendet, ohne das Ergebnis zu ändern.