Generate Images and Video From Your Terminal With OpenArt CLI

Qu'est-ce qu'OpenArt CLI

OpenArt CLI is a single binary that gives your terminal access to an OpenArt account on macOS, Linux, and Windows. You sign in once through a browser with openart login. Le flux OAuth évite d'avoir à installer Python ou Node, à créer une clé API ou à stocker une clé de longue durée dans des scripts.

The login command uses the standard OAuth flow with PKCE, the same browser-redirect pattern desktop apps use to avoid handling a password directly. The CLI stores the resulting credential at ~/.openart/cli-credentials.json (mode 0600, donc seul ton compte utilisateur peut le lire ; Windows le stocke à %USERPROFILE%\.openart\cli-credentials.json) et l'actualise automatiquement. openart logout révoque l'identifiant et efface cet état local.

OpenArt a conçu la CLI comme un vrai produit à part entière, et non comme un script qui clique à ta place dans l'appli web. Ses commandes exposent image and génération de vidéos, les infos sur les modèles, le statut des créations, les imports, les projets et les espaces de travail directement dans des scripts shell et des agents de code. La sortie lisible par machine, les aperçus de requêtes, les jobs asynchrones et le polling borné prennent en charge une automatisation reproductible.

Le CLI utilise les crédits de ton propre compte OpenArt, le même pool que celui de l'appli web. Ce n'est pas un produit API distinct avec sa propre clé et sa propre facturation. Le OpenArt CLI GitHub repository contient les instructions d'installation officielles, la référence des commandes et les détails de la version actuelle.

Comment installer OpenArt CLI

OpenArt CLI prend en charge macOS, Linux et Windows sous forme d'un unique binaire précompilé. Sur macOS ou Linux, lance l'installeur officiel.

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh

On Windows, open PowerShell and run the one-line installer.

irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

Le programme d'installation choisit la bonne version pour ta machine, la vérifie avec les sommes de contrôle de la release, et place openart in a standard executable directory. On macOS and Linux, it uses /usr/local/bin lorsque cet emplacement est accessible en écriture ou ~/.local/bin pour une installation au niveau utilisateur, plutôt que de demander sudo de façon inattendue. Si l'installateur utilise ~/.local/bin, assure-toi que ce répertoire est dans le PATH. On Windows, it installs to %LOCALAPPDATA%\Programs\openart\bin and adds that folder to your user PATH automatically, so no administrator rights are needed.

Les deux scripts d'installation acceptent un emplacement d'installation personnalisé ou une version épinglée. Sur macOS ou Linux, ajoute des options après le script.

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh -s -- --prefix "$HOME/.local" --version 0.1.0

Un script PowerShell dans un pipe ne peut pas recevoir de paramètres directement : définis d'abord la version comme variable d'environnement.

$env:OPENART_VERSION = '0.1.0'
irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

Prefer not to pipe a script into your shell? Download the archive for your platform from the latest release (macOS Apple silicon or Intel, Linux x86-64 or arm64, Windows x86-64 or arm64), extract it, and put openart sur ta PATH. Chaque sortie livre un checksums.txt tu peux vérifier avec shasum -a 256 -c checksums.txt --ignore-missing.

Pour mettre à jour plus tard, relance le même installateur. Il écrase le binaire existant à sa place.

Confirme l'installation dans une nouvelle fenêtre de terminal.

openart --help

Then connect the CLI to your OpenArt account.

openart login

The login command opens a browser for OAuth authentication. After you approve access, the CLI can use your account without an API key or a language runtime such as Python or Node.

Les commandes essentielles en un coup d'œil

L'interface de commande principale

Authentication and account access

OpenArt uses browser OAuth for account access. Start a session with openart login, termine par openart logout, et vérifie ta formule ou ton solde de crédits avec openart account.

openart login
openart account
openart logout

Génération d'images et de vidéos

OpenArt garde le type de média explicite dans chaque commande de génération. Séparer image and video commands mean a script can't route a request to the wrong model type by accident.

For génération de texte vers image ou édition image-à-image, use the image command with a prompt and model ID. Add --image when supplying a local file or URL as a reference.

openart generate image "A ceramic mug on a studio table" \
  --model nano-banana-2 \
  -o ./out/

L'exemple ci-dessus utilise nano-banana-2; remplace par n'importe quel modèle openart model list te montre.

For texte-vers-vidéo ou image-vers-vidéo, utilise la commande vidéo. Les options prises en charge peuvent inclure la durée, le ratio d'aspect et la résolution, selon le modèle.

openart generate video "Slow camera orbit around the product" \
  --model kling-3-omni \
  --image ./start-frame.png \
  --duration 8

Sélection du modèle et paramètres de requête

Model commands let you inspect current options instead of hard-coding assumptions. openart model list shows available models and their supported modes. Model names can change as OpenArt adds new options.

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 on its own quotes every model, cheapest first, without spending credits. Add --model and --mode pour tarifer une combinaison précise. Le form command returns the exact parameters accepted by a particular model and mode. If you're choosing between two of them, see how GPT Image 2 comparé à Nano Banana 2 before you commit a batch job to one.

Creations and stored assets

Les commandes de création permettent aux scripts d'inspecter l'historique de génération et de gérer les tâches soumises. Utilise list pour les créations précédentes, get pour un job, et wait when a script must pause until an asynchronous job finishes.

openart creation list --type video --limit 10
openart creation get <creation-id>
openart creation wait <creation-id>

Les commandes de projet et d'espace de travail contrôlent où les nouveaux travaux sont classés.

openart project list
openart project create --name "<name>"
openart workspace list
openart workspace select <workspace-id>
openart workspace select

workspace select with no argument switches back to your personal workspace, and workspace list marque celui qui est actif d'un astérisque.

For reusable reference files, openart upload add <file> importe l'asset une fois et affiche une URL pour les commandes ultérieures, et openart upload list --type image montre ce que tu as déjà importé. Le dépôt CLI officiel contient la référence de commandes actuelle à mesure que la surface évolue.

La désinstallation est une étape manuelle, car la CLI n'a pas de commande de désinstallation intégrée. Sur macOS ou Linux, supprime le binaire et son identifiant stocké avec rm "$(command -v openart)" and rm -rf ~/.openart. Sur Windows, supprime %LOCALAPPDATA%\Programs\openart, remove it from your user PATH, and delete %USERPROFILE%\.openart. Si tu rencontres un bug qui vaut la peine d'être signalé, inclus la sortie de openart version in your issue. It reports the exact build, platform, and commit.

Flags built for scripts, not clicks

OpenArt CLI expose des contrôles qui rendent la génération prévisible dans les scripts. Chacun répond à un problème d'automatisation courant : l'analyse structurée, les dépenses accidentelles, les tâches de longue durée et les processus bloqués.

Le --json écrit des résultats lisibles par machine sur la sortie standard. Les messages de progression et de pagination vont sur la sortie d'erreur, si bien qu'un job CI ou un appel d'outil d'agent peut transmettre du JSON propre à une autre commande sans avoir à extraire du texte lisible par un humain. Un script peut extraire de façon fiable les ID de création, les statuts et les URL de résultats.

Le --dry-run affiche la requête exacte qu'OpenArt enverrait, pour toute commande qui écrirait ou dépenserait des crédits, sans l'envoyer. Utilise-la pour inspecter les choix de modèles et les paramètres avant de lancer une boucle de traitement par lots, ou laisse un agent prévisualiser une commande générée avant qu'il ait la permission d'exécuter une action d'écriture ou de dépense.

Le --async soumet une génération et renvoie immédiatement son ID de création au lieu d'attendre. Un script de traitement par lots peut soumettre plusieurs tâches, faire autre chose, puis utiliser openart creation wait ou openart creation get to collect results. Because --async revient avant qu'un fichier existe à télécharger, elle ne peut pas être combinée avec -o ou --output.

Without --async, OpenArt CLI soumet la tâche et interroge jusqu'à ce qu'elle se termine. L'interrogation s'arrête au --timeout, which defaults to five minutes. A bounded wait keeps a failed generation or network hiccup from leaving a CI job running indefinitely, while an explicit timeout lets you accommodate slower video jobs.

Pourquoi un CLI, et pas juste un navigateur

Les interfaces en ligne de commande sont antérieures à la souris. Le premier interpréteur de commandes a tourné sur le système CTSS du MIT en 1961, et la tradition du scripting shell qu'il a lancée, portée par le premier shell Unix en 1971 et le shell Bourne en 1977, reste aujourd'hui la manière dont la plupart des serveurs, pipelines CI et outils de développement sont automatisés (Wikipédia). l'explication de GitHub expose clairement l'intérêt pratique : une CLI termine une tâche en quelques frappes au clavier plutôt qu'en une série de clics, utilise une fraction des ressources requises par une interface graphique, et transforme le travail répétitif en script plutôt qu'en une suite d'étapes manuelles.

Cet argument devient encore plus fort dès lors qu'un agent IA, et non une personne, émet les commandes. Les LLM sont nativement textuels, donc le format texte-entrée/texte-sortie d'une CLI fait qu'un agent n'a jamais besoin d'analyser une capture d'écran pour savoir si un clic a abouti. L'équipe d'ingénierie de Parallel a soutenu que les actions en CLI sont elles aussi déterministes et bien moins coûteuses que l'automatisation de navigateur équivalente, puisqu'il n'y a aucune page à afficher, aucune mise en page à interpréter et aucune ambiguïté sur ce qui s'est passé après l'exécution de la commande. Claude ne peut pas générer d'images ou de vidéos par lui-même, et c'est justement pourquoi un agent a besoin d'un moyen d'atteindre un modèle capable de le faire. C'est la même raison pour laquelle Claude Code et Codex considèrent un terminal comme leur espace de travail, et c'est pourquoi openart generate image ... convient mieux à ces agents que de piloter une session de navigateur.

The term itself still gets debated by the people who use it daily. On r/AskProgramming, developers worked through the difference between a CLI and a full-screen terminal program, a TUI: a CLI is line-based, you type a command and get a response before moving to the next line, while something like vim or htop repaints the whole screen and lets you navigate around it (r/AskProgramming). openart est une CLI dans ce sens plus restreint. Chaque commande, c'est une ligne en entrée, un résultat en sortie, exactement la forme qu'attend un script ou un agent, et c'est en partie pourquoi elle ne cherche pas à être un tableau de bord interactif.

CLI vs MCP : choisir la bonne interface

OpenArt CLI s'intègre aux workflows qui tournent déjà dans un terminal : scripts, génération par lots, jobs CI et automatisation en ligne de commande où les commandes et la sortie lisible par machine alimentent l'étape suivante.

Coding agents such as Claude Code and Codex can call the CLI through their existing shell access. You avoid adding another integration layer, and the agent uses the same commands you'd run by hand.

OpenArt's MCP server fits conversational creative work inside Claude (see un exemple de génération de vidéo depuis Claude), ChatGPT, ou Cursor à la place. MCP permet à l'agent d'appeler les outils OpenArt en pleine conversation, ce qui convient aux demandes itératives où tu décris une image ou une vidéo et l'affines au fil de l'échange plutôt qu'avec un script. Si tu compares les options plus largement, voici comment il se positionne face à autres serveurs MCP pour la génération d'images et de vidéos.

Neither replaces the OpenArt web app. The web app is still the right choice when you want visual controls and direct inspection; the CLI serves repeatable terminal work, and MCP serves chat-based interaction. Pick the surface where the rest of your work already happens: if you're deciding between CLI and MCP for an agent you're building, ask whether that agent talks to you in a chat window (MCP) or runs unattended in a shell or pipeline (CLI).

Démarrage rapide : installe, connecte-toi, génère

On macOS or Linux, run the installer.

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh

Les utilisateurs Windows peuvent lancer l'installateur PowerShell à la place.

irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

Ensuite, authentifie-toi via la fenêtre de navigateur ouverte par la commande de connexion.

openart login

Trouve un modèle d'image actuel et copie son identifiant.

openart model list

Remplace le modèle dans la commande ci-dessous par un identifiant de cette liste, tel que nano-banana-2. Prévisualise ta première requête avec --dry-run donc OpenArt ne consomme pas de crédits.

openart generate image "A small red sailboat on a calm lake at sunrise" \
  --model nano-banana-2 \
  --dry-run

Après avoir vérifié l'aperçu, supprime --dry-run pour lancer la génération.

openart generate image "A small red sailboat on a calm lake at sunrise" \
  --model nano-banana-2

FAQ

What is OpenArt CLI?

OpenArt CLI est un binaire unique pour générer des images et des vidéos depuis un terminal. Il se connecte à ton compte OpenArt via OAuth dans le navigateur, et tu peux l'utiliser dans des scripts, des tâches par lots, des tâches CI et des agents de code disposant d'un accès shell.

L'installation d'OpenArt CLI est-elle gratuite ?

Installer le CLI ne coûte rien en soi. La génération d'images et de vidéos puise dans les crédits disponibles via ton compte et ton forfait OpenArt, exactement comme lorsque tu génères depuis l'app web. Lance openart model cost pour vérifier ce que facture un modèle donné avant de générer.

OpenArt CLI nécessite-t-il une clé API ?

Non. openart login opens a browser-based OAuth sign-in for your OpenArt account, so you're not storing or rotating a separate secret in local configuration.

Quelles plateformes prennent en charge OpenArt CLI ?

macOS, Linux et Windows, distribué sous forme de binaire autonome via le dépôt GitHub officiel. Pas besoin d'avoir Python ou Node installé.

CLI ou MCP : lequel choisir ?

Use the CLI when the work already happens in a terminal: shell scripts, CI pipelines, or a coding agent like Claude Code or Codex that has shell access. Use OpenArt's MCP server when you want a chat-based agent in Claude, ChatGPT, or Cursor to generate and refine images or video mid-conversation, the way you would générer des pubs produit directement depuis Claude. Les deux ne s'excluent pas ; certaines équipes scriptent les parties répétables avec la CLI et utilisent le MCP pour la partie exploratoire.

En quoi OpenArt CLI diffère-t-il de l'application web ?

The CLI exposes generation and account operations as commands with structured output, dry runs, and asynchronous job handling. The web app gives you a visual interface for interactive creation and editing. Reach for the CLI when you need repeatable shell commands or automation instead of clicking through a UI.

How do I uninstall OpenArt CLI?

There's no built-in uninstall command, so remove the binary and its stored credential manually. Run rm "$(command -v openart)" and rm -rf ~/.openart on macOS or Linux, or delete %LOCALAPPDATA%\Programs\openart and %USERPROFILE%\.openart on Windows.