Génère des images et des vidéos depuis ton terminal avec OpenArt CLI

Qu'est-ce qu'OpenArt CLI

OpenArt CLI est un binaire unique qui donne à ton terminal l'accès à un OpenArt compte sur macOS, Linux et Windows. Tu te connectes une seule fois via un navigateur avec 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.

La commande de connexion utilise le flux OAuth standard avec PKCE, le même schéma de redirection via navigateur qu'utilisent les applis de bureau pour éviter de gérer directement un mot de passe. Le CLI stocke les identifiants obtenus à ~/.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 et 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 Dépôt GitHub OpenArt CLI 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

Sous Windows, ouvre PowerShell et exécute l'installateur en une ligne.

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 dans un répertoire d'exécutables standard. Sur macOS et Linux, il utilise /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. Sur Windows, il s’installe dans %LOCALAPPDATA%\Programs\openart\bin et ajoute ce dossier à ton utilisateur PATH automatiquement, donc aucun droit administrateur n'est nécessaire.

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

Tu préfères ne pas passer un script dans ton shell ? Télécharge l'archive pour ta plateforme depuis le dernière sortie (macOS Apple silicon ou Intel, Linux x86-64 ou arm64, Windows x86-64 ou arm64), extrais-le et place 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

Connecte ensuite la CLI à ton compte OpenArt.

openart login

La commande de connexion ouvre un navigateur pour l'authentification OAuth. Une fois l'accès approuvé, la CLI peut utiliser ton compte sans clé API ni environnement d'exécution comme Python ou Node.

Les commandes essentielles en un coup d'œil

L'interface de commande principale

Authentification et accès au compte

OpenArt utilise l'OAuth du navigateur pour accéder au compte. Démarre une session avec 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 et video garantissent qu'un script ne peut pas router une requête vers le mauvais type de modèle par accident.

Pour génération de texte vers image ou édition image-à-image, utilise la commande image avec un prompt et un ID de modèle. Ajoute --image lorsque tu fournis un fichier local ou une URL comme référence.

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.

Pour 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

Les commandes de modèle te permettent d'inspecter les options actuelles au lieu de coder en dur des hypothèses. openart model list affiche les modèles disponibles et les modes qu'ils prennent en charge. Les noms des modèles peuvent changer à mesure qu'OpenArt ajoute de nouvelles 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 génère à lui seul un devis pour chaque modèle, du moins cher au plus cher, sans dépenser de crédits. Ajoute --model et --mode pour tarifer une combinaison précise. Le form renvoie les paramètres exacts acceptés par un modèle et un mode précis. Si tu hésites entre deux d'entre eux, regarde comment GPT Image 2 comparé à Nano Banana 2 avant de lancer un traitement par lot sur un seul.

Créations et ressources stockées

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 quand un script doit se mettre en pause jusqu'à ce qu'une tâche asynchrone se termine.

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 sans argument, revient à ton espace de travail personnel, et workspace list marque celui qui est actif d'un astérisque.

Pour des fichiers de référence réutilisables, 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)" et rm -rf ~/.openart. Sur Windows, supprime %LOCALAPPDATA%\Programs\openart, supprime-le de ton utilisateur PATH, et supprimer %USERPROFILE%\.openart. Si tu rencontres un bug qui vaut la peine d'être signalé, inclus la sortie de openart version dans ton signalement. Il indique la build exacte, la plateforme et le commit.

Des drapeaux conçus pour les scripts, pas pour les clics

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 pour rassembler les résultats. Parce que --async revient avant qu'un fichier existe à télécharger, elle ne peut pas être combinée avec -o ou --output.

Sans --async, OpenArt CLI soumet la tâche et interroge jusqu'à ce qu'elle se termine. L'interrogation s'arrête au --timeout, qui vaut cinq minutes par défaut. Une attente limitée évite qu'une génération échouée ou un souci réseau ne laisse un job CI tourner indéfiniment, tandis qu'un timeout explicite te permet de prendre en compte les tâches vidéo plus lentes.

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.

Le terme lui-même fait encore débat chez ceux qui l'utilisent au quotidien. Sur r/AskProgramming, des développeurs ont exploré la différence entre une CLI et un programme terminal plein écran, une TUI : une CLI est en mode ligne, tu tapes une commande et obtiens une réponse avant de passer à la ligne suivante, tandis qu'un outil comme vim ou htop redessine tout l'écran et te laisse y naviguer (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.

Les agents de code comme Claude Code et Codex peuvent appeler le CLI via leur accès shell existant. Tu évites d'ajouter une couche d'intégration supplémentaire, et l'agent utilise les mêmes commandes que tu lancerais à la main.

OpenArt's Serveur MCP s'intègre au travail créatif conversationnel dans Claude (voir 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.

Ni l'un ni l'autre ne remplace l'application web OpenArt. L'app web reste le bon choix quand tu veux des contrôles visuels et une inspection directe ; la CLI convient au travail répétable en terminal, et le MCP à l'interaction par chat. Choisis la surface là où se passe déjà le reste de ton travail : si tu hésites entre la CLI et le MCP pour un agent que tu construis, demande-toi si cet agent te parle dans une fenêtre de chat (MCP) ou s'exécute sans supervision dans un shell ou un pipeline (CLI).

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

Sur macOS ou Linux, lance l'installateur.

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

Qu'est-ce que l'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 ouvre une connexion OAuth dans le navigateur pour ton compte OpenArt, pour que tu n'aies pas à stocker ni à renouveler un secret séparé dans ta config locale.

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 ?

Utilise la CLI quand le travail se fait déjà dans un terminal : scripts shell, pipelines CI, ou un agent de code comme Claude Code ou Codex qui a un accès shell. Utilise l'OpenArt Serveur MCP quand tu veux un agent conversationnel dans Claude, ChatGPT ou Cursor pour générer et affiner des images ou des vidéos en pleine conversation, comme tu le ferais 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 ?

La CLI expose les opérations de génération et de compte sous forme de commandes avec sortie structurée, exécutions à blanc et gestion asynchrone des tâches. L'application web t'offre une interface visuelle pour la création et l'édition interactives. Opte pour la CLI quand tu as besoin de commandes shell reproductibles ou d'automatisation plutôt que de cliquer dans une interface.

Comment désinstaller OpenArt CLI ?

Il n'y a pas de commande de désinstallation intégrée, donc supprime le binaire et son identifiant stocké manuellement. Exécute rm "$(command -v openart)" et rm -rf ~/.openart sur macOS ou Linux, ou supprime %LOCALAPPDATA%\Programs\openart et %USERPROFILE%\.openart sous Windows.