Kurz gesagt
- Die OpenArt CLI ist eine einzelne Binärdatei, um OpenArt-Bilder und -Videos aus einem Terminal, Skript, Batch-Job oder Coding-Agent zu generieren.
- Eine einzige Browser-OAuth-Anmeldung verbindet dein OpenArt-Konto. Du brauchst weder Python noch Node oder einen API-Key.
- Die CLI läuft unter macOS, Linux und Windows. Die Befehle unterstützen maschinenlesbare Ausgabe, Request-Vorschauen und asynchrone Generierung.
- Wähle die CLI für terminalbasierte Automatisierung oder Coding-Agenten wie Claude Code und Codex. Zu CLI vs. MCP: OpenArts MCP eignet sich besser für dialogorientiertes kreatives Arbeiten in Claude, ChatGPT oder Cursor.
Was ist die OpenArt CLI
OpenArt CLI eine einzelne Binary ist, die deinem Terminal Zugriff auf ein OpenArt -Konto unter macOS, Linux und Windows. Du meldest dich einmal über einen Browser an mit openart login. Der OAuth-Flow macht es überflüssig, Python oder Node zu installieren, einen API-Key zu erstellen oder einen langlebigen Key in Skripten zu speichern.
Der Login-Befehl nutzt den standardmäßigen OAuth-Flow mit PKCE – dasselbe Browser-Redirect-Muster, das Desktop-Apps verwenden, um ein Passwort nicht direkt handhaben zu müssen. Das CLI speichert die resultierenden Anmeldedaten unter ~/.openart/cli-credentials.json (Modus 0600, sodass nur dein Benutzerkonto sie lesen kann; Windows speichert sie unter %USERPROFILE%\.openart\cli-credentials.json) und aktualisiert es automatisch. openart logout widerruft die Anmeldedaten und löscht diesen lokalen Zustand.
OpenArt hat die CLI als eigene Produktoberfläche gebaut, nicht als Skript, das für dich in der Web-App herumklickt. Ihre Befehle bieten Bild und Videogenerierung, Modellinformationen, Creation-Status, Uploads, Projekte und Workspaces direkt an Shell-Skripte und Coding-Agenten. Maschinenlesbare Ausgabe, Request-Vorschauen, asynchrone Jobs und begrenztes Polling unterstützen wiederholbare Automatisierung.
Die CLI gibt die Credits deines eigenen OpenArt-Kontos aus, denselben Pool, aus dem auch die Web-App schöpft. Es ist kein separates API-Produkt mit eigenem Key und eigener Abrechnung. Der OpenArt CLI GitHub-Repository enthält die verbindlichen Installationsanweisungen, die Befehlsreferenz und die aktuellen Release-Details.
So installierst du das OpenArt CLI
Die OpenArt CLI unterstützt macOS, Linux und Windows als einzelne vorkompilierte Binary. Führe unter macOS oder Linux den offiziellen Installer aus.
curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh
Unter Windows öffnest du PowerShell und führst den Einzeiler-Installer aus.
irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex
Der Installer wählt den passenden Build für deinen Rechner, prüft ihn gegen die Release-Checksummen und platziert openart in ein Standard-Verzeichnis für ausführbare Dateien. Unter macOS und Linux wird verwendet /usr/local/bin wenn dieser Speicherort beschreibbar ist, oder ~/.local/bin für eine Installation auf Benutzerebene, statt nach sudo unerwartet. Wenn der Installer ~/.local/bin, stelle sicher, dass dieses Verzeichnis im PATH. Unter Windows wird es installiert nach %LOCALAPPDATA%\Programs\openart\bin und fügt diesen Ordner zu deinem User hinzu PATH automatisch, sodass keine Administratorrechte nötig sind.
Beide Installer-Skripte akzeptieren einen eigenen Installationsort oder eine festgelegte Version. Füge unter macOS oder Linux die Flags nach dem Skript hinzu.
curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh -s -- --prefix "$HOME/.local" --version 0.1.0
Ein per Pipe übergebenes PowerShell-Skript kann keine Parameter direkt entgegennehmen, also setze die Version zuerst als Umgebungsvariable.
$env:OPENART_VERSION = '0.1.0'
irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex
Du möchtest kein Skript in deine Shell pipen? Lade das Archiv für deine Plattform herunter über das neuestes Release (macOS Apple Silicon oder Intel, Linux x86-64 oder arm64, Windows x86-64 oder arm64), entpacke es und lege openart auf deinem PATH. Jedes Release liefert ein checksums.txt kannst du überprüfen mit shasum -a 256 -c checksums.txt --ignore-missing.
Um später zu aktualisieren, führe denselben Installer erneut aus. Er überschreibt die vorhandene Binary direkt vor Ort.
Bestätige die Installation in einem neuen Terminal-Fenster.
openart --help
Verbinde dann die CLI mit deinem OpenArt-Konto.
openart login
Der Login-Befehl öffnet einen Browser zur OAuth-Authentifizierung. Nachdem du den Zugriff freigegeben hast, kann das CLI dein Konto ohne API-Key oder eine Sprachumgebung wie Python oder Node nutzen.
Die wichtigsten Befehle auf einen Blick
| Aufgabe | Befehl |
|---|---|
| Anmelden / Abmelden | openart login / openart logout |
| Plan und Credits prüfen | openart account |
| Ein Bild generieren | openart generate image "<prompt>" --model <id> |
| Ein Video generieren | openart generate video "<prompt>" --model <id> |
| Modelle auflisten | openart model list |
| Einen Preis nennen | openart model cost --model <id> --mode <mode> |
| Generierungsstatus prüfen | openart creation get <id> / openart creation wait <id> |
| Referenzdatei hochladen | openart upload add <file> |
Die zentrale Befehlsoberfläche
Authentifizierung und Kontozugriff
OpenArt nutzt Browser-OAuth für den Kontozugriff. Starte eine Sitzung mit openart login, beende es mit openart logoutund prüfe deinen Tarif oder Credit-Stand mit openart account.
openart login
openart account
openart logout
Bild- und Videogenerierung
OpenArt hält den Medientyp in jedem Generierungsbefehl explizit. Getrennt image und video Befehle bedeuten, dass ein Skript eine Anfrage nicht versehentlich an den falschen Modelltyp weiterleiten kann.
Für Text-zu-Bild-Generierung oder Bild-zu-Bild-Bearbeitung, nutze den Image-Befehl mit einem Prompt und einer Modell-ID. Füge --image wenn du eine lokale Datei oder URL als Referenz angibst.
openart generate image "A ceramic mug on a studio table" \
--model nano-banana-2 \
-o ./out/
Das Beispiel oben nutzt nano-banana-2; tausche ein beliebiges Modell ein openart model list zeigt dir.
Für Text-zu-Video oder Bild-zu-Video, nutze den Video-Befehl. Unterstützte Optionen können je nach Modell Dauer, Seitenverhältnis und Auflösung umfassen.
openart generate video "Slow camera orbit around the product" \
--model kling-3-omni \
--image ./start-frame.png \
--duration 8
Modellauswahl und Anfrageparameter
Mit Modell-Befehlen kannst du die aktuellen Optionen prüfen, statt Annahmen fest einzucodieren. openart model list zeigt verfügbare Modelle und die von ihnen unterstützten Modi. Modellnamen können sich ändern, wenn OpenArt neue Optionen hinzufügt.
openart model list
openart model cost
openart model cost --model nano-banana-2 --mode text2image
openart model form nano-banana-2 text2image
openart model cost listet für sich allein jedes Modell auf, das günstigste zuerst, ohne Credits zu verbrauchen. Füge --model und --mode um eine bestimmte Kombination zu bepreisen. Der form Der Befehl liefert die genauen Parameter, die ein bestimmtes Modell und ein bestimmter Modus akzeptieren. Wenn du zwischen zweien wählst, sieh dir an, wie GPT Image 2 im Vergleich mit Nano Banana 2 bevor du einen Batch-Job daran bindest.
Kreationen und gespeicherte Assets
Mit Creation-Befehlen können Skripte den Generierungsverlauf einsehen und eingereichte Jobs verwalten. Nutze list für frühere Kreationen, get für einen Job, und wait wenn ein Skript pausieren muss, bis ein asynchroner Auftrag abgeschlossen ist.
openart creation list --type video --limit 10
openart creation get <creation-id>
openart creation wait <creation-id>
Projekt- und Workspace-Befehle steuern, wohin neue Arbeit gehört.
openart project list
openart project create --name "<name>"
openart workspace list
openart workspace select <workspace-id>
openart workspace select
workspace select ohne Argument wechselt zurück zu deinem persönlichen Workspace, und workspace list markiert den aktiven mit einem Sternchen.
Für wiederverwendbare Referenzdateien, openart upload add <file> lädt das Asset einmal hoch und gibt eine URL für spätere Befehle aus, und openart upload list --type image zeigt, was du bereits hochgeladen hast. Der offizielles CLI-Repository enthält die aktuelle Befehlsreferenz, während sich die Oberfläche weiterentwickelt.
Das Deinstallieren ist ein manueller Schritt, da die CLI keinen eingebauten Deinstallationsbefehl hat. Unter macOS oder Linux entfernst du die Binary und ihre gespeicherten Zugangsdaten mit rm "$(command -v openart)" und rm -rf ~/.openart. Lösche unter Windows %LOCALAPPDATA%\Programs\openart, entferne ihn aus deinem User PATH, und lösche %USERPROFILE%\.openart. Wenn du auf einen meldenswerten Bug stößt, füge die Ausgabe von openart version in deinem Issue. Es meldet den genauen Build, die Plattform und den Commit.
Flags, die für Skripte gemacht sind, nicht für Klicks
OpenArt CLI bietet Steuerungen, die die Generierung in Skripten vorhersehbar machen. Jede davon adressiert ein häufiges Automatisierungsproblem: strukturiertes Parsen, versehentliche Ausgaben, langlaufende Jobs und hängengebliebene Prozesse.
Der --json schreibt maschinenlesbare Ergebnisse in die Standardausgabe. Fortschritts- und Paginierungsmeldungen gehen an die Standardfehlerausgabe, sodass ein CI-Job oder Agent-Tool-Aufruf sauberes JSON in einen anderen Befehl pipen kann, ohne menschenlesbaren Text auslesen zu müssen. Ein Skript kann Creation-IDs, Status und Ergebnis-URLs zuverlässig extrahieren.
Der --dry-run Flag gibt für jeden Befehl, der schreiben oder Credits ausgeben würde, die exakte Anfrage aus, die OpenArt senden würde – ohne sie tatsächlich zu senden. Nutze es, um Modellauswahl und Parameter zu prüfen, bevor du eine Batch-Schleife startest, oder lass einen Agenten einen generierten Befehl in der Vorschau ansehen, bevor er die Erlaubnis erhält, eine Schreib- oder Ausgabeaktion auszuführen.
Der --async schickt eine Generierung ab und gibt sofort ihre Creation-ID zurück, statt zu warten. Ein Batch-Skript kann mehrere Jobs abschicken, andere Arbeit erledigen und später openart creation wait oder openart creation get um Ergebnisse zu sammeln. Da --async zurückkehrt, bevor eine Datei zum Download existiert, kann es nicht kombiniert werden mit -o oder --output.
Ohne --async, übermittelt OpenArt CLI den Job und pollt, bis er fertig ist. Das Polling stoppt beim konfigurierten --timeout, das standardmäßig fünf Minuten beträgt. Eine begrenzte Wartezeit verhindert, dass eine fehlgeschlagene Generierung oder ein Netzwerkaussetzer einen CI-Job endlos laufen lässt, während ein expliziter Timeout es dir erlaubt, langsamere Video-Jobs zu berücksichtigen.
Warum eine CLI und nicht einfach ein Browser
Kommandozeilen-Interfaces gibt es länger als die Maus. Der erste Kommandozeilen-Interpreter lief 1961 auf dem CTSS-System des MIT, und die damit begründete Shell-Scripting-Tradition – fortgeführt durch die erste Unix-Shell 1971 und die Bourne-Shell 1977 – ist bis heute die Art, wie die meisten Server, CI-Pipelines und Entwickler-Tools automatisiert werden (Wikipedia). GitHubs eigene Erklärung bringt es auf den Punkt: Eine CLI erledigt eine Aufgabe mit ein paar Tastenanschlägen statt einer Klick-Abfolge, verbraucht nur einen Bruchteil der Ressourcen einer grafischen Oberfläche und verwandelt wiederkehrende Arbeit in ein Skript statt in eine Reihe manueller Schritte.
Dieses Argument wird noch stärker, wenn ein KI-Agent statt eines Menschen die Befehle absetzt. LLMs sind textbasiert – das Text-rein-, Text-raus-Format eines CLI bedeutet also, dass ein Agent nie einen Screenshot parsen muss, um zu wissen, ob ein Klick angekommen ist. das Engineering-Team von Parallel hat argumentiert, dass CLI-Aktionen ebenfalls deterministisch und weit günstiger sind als eine vergleichbare Browser-Automatisierung, da keine Seite gerendert, kein Layout interpretiert werden muss und keine Unklarheit darüber besteht, was nach dem Ausführen des Befehls passiert ist. Claude selbst kann keine Bilder oder Videos generieren, und genau deshalb braucht ein Agent einen Weg, ein Modell zu erreichen, das es kann. Aus demselben Grund behandeln Claude Code und Codex ein Terminal als ihren Arbeitsbereich – und darum openart generate image ... passt für diese Agenten natürlicher als eine Browser-Session zu steuern.
Der Begriff selbst wird von den Leuten, die ihn täglich nutzen, immer noch diskutiert. Auf r/AskProgramming haben sich Entwickler mit dem Unterschied zwischen einer CLI und einem Vollbild-Terminalprogramm, einer TUI, auseinandergesetzt: Eine CLI ist zeilenbasiert, du tippst einen Befehl und bekommst eine Antwort, bevor du zur nächsten Zeile gehst, während etwas wie vim oder htop den ganzen Bildschirm neu zeichnet und dich darin navigieren lässt (r/AskProgramming). openart ist eine CLI in diesem engeren Sinne. Jeder Befehl ist eine Eingabezeile, ein Ergebnis – genau die Form, die ein Skript oder ein Agent erwartet, und ein Teil davon, warum es kein interaktives Dashboard sein will.
CLI vs. MCP: die richtige Oberfläche wählen
Die OpenArt CLI passt zu Workflows, die ohnehin im Terminal laufen: Skripte, Batch-Generierung, CI-Jobs und Shell-basierte Automatisierung, bei der Befehle und maschinenlesbare Ausgabe den nächsten Schritt speisen.
Coding-Agents wie Claude Code und Codex können die CLI über ihren bestehenden Shell-Zugriff aufrufen. Du sparst dir eine weitere Integrationsschicht, und der Agent nutzt dieselben Befehle, die du auch von Hand ausführen würdest.
OpenArt's MCP-Server passt kreative Arbeit im Dialog in Claude ein (siehe ein Beispiel zur Videogenerierung aus Claude), ChatGPT, oder Cursor. Mit MCP kann der Agent mitten im Chat OpenArt-Tools aufrufen, was zu iterativen Anfragen passt, bei denen du ein Bild oder Video beschreibst und es im Gespräch verfeinerst statt per Skript. Wenn du die Optionen breiter vergleichen willst, hier der Vergleich mit andere MCP-Server für die Bild- und Videogenerierung.
Keines der beiden ersetzt die OpenArt-Web-App. Die Web-App ist nach wie vor die richtige Wahl, wenn du visuelle Steuerung und direkte Kontrolle willst; die CLI eignet sich für wiederholbare Terminal-Arbeit und MCP für chatbasierte Interaktion. Wähle die Oberfläche, auf der der Rest deiner Arbeit ohnehin stattfindet: Wenn du dich zwischen CLI und MCP für einen Agenten entscheidest, den du gerade baust, frag dich, ob dieser Agent mit dir in einem Chat-Fenster spricht (MCP) oder unbeaufsichtigt in einer Shell oder Pipeline läuft (CLI).
Schnellstart: installieren, anmelden, generieren
Führe unter macOS oder Linux den Installer aus.
curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh
Windows-Nutzer können stattdessen den PowerShell-Installer ausführen.
irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex
Authentifiziere dich anschließend über das Browserfenster, das der Login-Befehl öffnet.
openart login
Finde ein aktuelles Bildmodell und kopiere seine Kennung.
openart model list
Ersetze das Modell im folgenden Befehl durch eine Kennung aus dieser Liste, zum Beispiel nano-banana-2. Sieh dir deine erste Anfrage in der Vorschau an mit --dry-run damit OpenArt keine Credits ausgibt.
openart generate image "A small red sailboat on a calm lake at sunrise" \
--model nano-banana-2 \
--dry-run
Entferne nach dem Prüfen der Vorschau --dry-run um die Generierung abzuschicken.
openart generate image "A small red sailboat on a calm lake at sunrise" \
--model nano-banana-2
FAQ
Was ist das OpenArt CLI?
OpenArt CLI ist eine einzige Binary zum Generieren von Bildern und Videos aus dem Terminal. Sie verbindet sich über browserbasiertes OAuth mit deinem OpenArt-Konto, und du kannst sie in Skripten, Batch-Jobs, CI-Aufgaben und Coding-Agenten mit Shell-Zugriff nutzen.
Ist die Installation der OpenArt CLI kostenlos?
Die Installation der CLI kostet für sich genommen nichts. Bild- und Videogenerierung nutzt die Credits deines OpenArt-Kontos und Tarifs – genau wie beim Generieren über die Web-App. Führe aus openart model cost um zu prüfen, was ein bestimmtes Modell kostet, bevor du generierst.
Braucht die OpenArt CLI einen API-Key?
Nein. openart login öffnet eine browserbasierte OAuth-Anmeldung für dein OpenArt-Konto, sodass du kein separates Geheimnis in der lokalen Konfiguration speichern oder rotieren musst.
Welche Plattformen unterstützen die OpenArt CLI?
macOS, Linux und Windows, verteilt als eigenständige Binärdatei über das offizielles GitHub-Repository. Du brauchst weder Python noch Node installiert.
CLI vs. MCP: Was sollte ich nutzen?
Nutze die CLI, wenn die Arbeit ohnehin im Terminal stattfindet: Shell-Skripte, CI-Pipelines oder ein Coding-Agent wie Claude Code oder Codex mit Shell-Zugriff. Nutze OpenArts MCP-Server wenn du einen chat-basierten Agenten in Claude, ChatGPT oder Cursor willst, der mitten im Gespräch Bilder oder Videos generiert und verfeinert – so wie du es Produktanzeigen direkt aus Claude generieren. Die beiden schließen sich nicht aus – manche Teams skripten die wiederholbaren Teile mit der CLI und nutzen MCP für den explorativen Teil.
Wie unterscheidet sich die OpenArt CLI von der Web-App?
Die CLI stellt Generierungs- und Kontovorgänge als Befehle mit strukturierter Ausgabe, Dry-Runs und asynchroner Job-Verarbeitung bereit. Die Web-App bietet dir eine visuelle Oberfläche zum interaktiven Erstellen und Bearbeiten. Greif zur CLI, wenn du wiederholbare Shell-Befehle oder Automatisierung brauchst, statt dich durch ein UI zu klicken.
Wie deinstalliere ich die OpenArt CLI?
Es gibt keinen integrierten Deinstallations-Befehl, also entferne die Binärdatei und die gespeicherten Zugangsdaten manuell. Führe aus rm "$(command -v openart)" und rm -rf ~/.openart unter macOS oder Linux, oder lösche %LOCALAPPDATA%\Programs\openart und %USERPROFILE%\.openart unter Windows.