Higgsfield CLI bringt KI-Bild- und Videogenerierung ins Terminal

Higgsfield hat eine Anleitung zu seinem quelloffenen Kommandozeilen-Client Higgsfield CLI veröffentlicht. Damit lassen sich Bilder und Videos aus dem Terminal, per Skript oder über einen Coding-Agenten erzeugen, ohne die Web-App zu öffnen. Laut Higgsfield laufen dieselben Modelle wie in der Web-App, mit demselben Konto und demselben Credit-Guthaben.
- Die Higgsfield CLI ist ein Open-Source-Client, der Bilder und Videos aus dem Terminal, per Skript oder Coding-Agent erzeugt.
- Die Anmeldung erfolgt im Browser ohne API-Schlüssel, abgerechnet werden Plan-Credits zu Standardpreisen.
- Unbegrenzter Modellzugriff und kostenlose Generierungen gelten für CLI-Generierungen nicht.
- Installiert wird per curl, Homebrew oder npm, ein kostenpflichtiges Higgsfield-Abo ist erforderlich.
- Die API ist separat, mit eigenem Schlüssel und einem vorab aufgeladenen US-Dollar-Guthaben.
Was die CLI kann und wie die Anmeldung funktioniert
Die Higgsfield CLI ist ein Kommandozeilen-Client für Higgsfield, das das Unternehmen als KI-native Kreativsuite für Video- und Bildgenerierung beschreibt. Code und Releases liegen auf GitHub. Der Befehl lautet higgsfield, als kürzerer Alias steht higgs zur Verfügung.
Higgsfield nennt drei Eckpunkte. Es gibt keinen API-Schlüssel: Nutzer melden sich im Browser mit einem regulären Higgsfield-Konto an. Jede Generierung wird den Plan-Credits dieses Kontos zu Standardpreisen belastet. Und Angebote, die nur im Web gelten, bleiben auf das Web beschränkt, sodass unbegrenzter Modellzugriff und kostenlose Generierungen für CLI-Generierungen nicht gelten.
Laut Anleitung deckt die CLI mehr als 35 Modelle und Tools für Bild, Video, 3D und Audio ab, dazu Analysen wie den Virality Predictor. Hinzu kommen das Trainieren und Wiederverwenden von Soul-Charakteren, Workflows wie Reframe, Dubbing, Stimmwechsel und Draw-to-Video sowie Kontoaufgaben wie Guthaben, Transaktionen und Abrechnungs-Workspaces. Auch Marketing-Studio-Assets, Produktfotoshootings sowie das Deployment von Websites und Spielen gehören zum selben Werkzeug, die Anleitung konzentriert sich aber auf Bild und Video.
Von der Installation zum ersten Video
Die Anleitung beschreibt einen Weg mit sechs Befehlen. Die Installation funktioniert unter macOS und Linux per curl, über Homebrew oder auf jeder Plattform einschließlich Windows per npm, wo das Paket @higgsfield/cli heißt. Ein kostenpflichtiges Higgsfield-Abo ist erforderlich. Ein Coding-Agent ist optional: Higgsfield zufolge können Agenten wie Claude Code, Codex, OpenClaw oder Hermes die Installation selbst übernehmen.
Nach der Versionsprüfung und der Anmeldung mit higgsfield auth login erzeugen Nutzer mit higgsfield generate create und einer Modell-ID ein Bild. Im Beispiel kommt nano_banana_2 für ein 16:9-Standbild zum Einsatz. Die Job-ID des Bildes wird anschließend als Startbild an ein Videomodell, seedance_2_5, übergeben, mit der Einstellung 5 Sekunden und 1080p.
Zwei Flags sind von Anfang an wichtig. --wait hält das Terminal offen, bis der Job fertig ist, und gibt den Link zum Ergebnis aus. --json liefert maschinenlesbare Ausgaben. Ohne --wait gibt der Create-Befehl eine Liste von Job-IDs zurück, und generate wait <job_id> --json liefert den Datensatz später. Ein eigener Befehl, generate cost, zeigt den Preis an, bevor Nutzer Credits einsetzen.
Für Stapelverarbeitung zeigt die Anleitung eine Shell-Schleife, die eine Prompt-Datei einliest, pro Zeile einen Job startet und die zurückgegebenen Job-IDs in einer Textdatei speichert.
CLI, MCP und API im Vergleich
Higgsfield bietet drei programmatische Zugänge, und laut Anleitung steht die Wahl vor der Installation. Die CLI ist für Terminals, Skripte und Coding-Agenten gedacht. MCP richtet sich an Chat-Agenten wie Claude und andere MCP-kompatible Clients. Die Higgsfield API ist für die eigene Anwendung eines Nutzers gedacht.
- CLI und MCP melden sich beide ohne Schlüssel über den Browser an und rechnen Plan-Credits zu Standardpreisen ab.
- Die API nutzt einen Schlüssel von open.higgsfield.ai und ein separates, vorab aufgeladenes Guthaben in US-Dollar, das keine Plan-Credits von higgsfield.ai verwendet.
- Keiner der drei Zugänge enthält unbegrenzten Modellzugriff.
CLI und MCP teilen sich ein Konto und ein Credit-Guthaben. Beim Wechsel zwischen beiden ändert sich also nur die Schnittstelle, während Konto, Credits und Assets gleich bleiben.
Details zur Anmeldung und eine Versionsfalle
Bei der Anmeldung gibt das Terminal "Opening browser for authentication" aus und wartet. Eine Zustimmungsseite listet die Zugriffe auf, die die CLI anfordert: E-Mail, Basisprofil, Organisationsmitgliedschaft und die Erlaubnis, die Anmeldung zu speichern. Das Token ist kurzlebig und wird in einer lokalen Zugangsdatendatei abgelegt. Higgsfield rät, es als Geheimnis zu behandeln und nicht in Prompts, Logs, Screenshots oder Versionsverwaltung einzufügen. Die Meldung "Session expired" bedeutet, dass auth login erneut ausgeführt werden muss.
Die Anleitung schildert außerdem einen Problemfall aus ihrem macOS-Test. Das curl-Installationsskript meldete Version 1.1.26, doch higgsfield version gab eine ältere Version 1.0.1 aus, die von einer früheren Homebrew-Installation übrig war. which -a higgsfield zeigte beide Kopien an, und brew upgrade higgsfield behob die Abweichung.
Was das für Nutzer bedeutet
Für bestehende Higgsfield-Abonnenten bietet die CLI die Möglichkeit, die Generierung mit dem bereits vorhandenen Plan zu automatisieren, ohne separaten Schlüssel oder eigenes Guthaben. Entwickler und Teams, die Skripte oder Coding-Agenten einsetzen, können Jobs bündeln und Ergebnisse als JSON auslesen.
Higgsfield weist darauf hin, dass die Befehle am 16. Oktober 2026 mit Higgsfield CLI 1.1.26 unter macOS geprüft wurden und sich Modell-IDs, Parameter und Credit-Preise ändern können. Für aktuelle Werte empfiehlt das Unternehmen model list, model get und generate cost.
Higgsfield: How to Generate AI Video From Your Terminal With Higgsfield CLI


