OpenAI CLI : un outil officiel pour appeler l'API REST depuis le terminal
Sommaire
En bref
- OpenAI publie un outil en ligne de commande officiel permettant d'appeler son API REST directement depuis le terminal ou des scripts shell.
- Destiné aux opérations de bas niveau (générer des images, uploader des fichiers, soumettre des batches), il se différencie de Codex CLI, l'agent IA qui modifie du code.
- L'outil supporte macOS, Linux et Windows, s'installe via Homebrew ou Go, et s'authentifie par clé API.
Ce que dit la source
OpenAI présente cet outil comme répondant au besoin d'automatiser des appels à son API sans écrire une application complète. Il s'agit d'un wrapper CLI natif, exposant les opérations bas niveau (images, fichiers, batches, administration) de manière accessible depuis le shell. La différenciation avec Codex CLI est explicite : openai-cli pour les scripts directs, Codex pour les agents autonomes travaillant sur un projet.
- Génération et édition d'images directement en CLI avec preview terminal natif
- Gestion de fichiers (upload, download, récupération) en quelques commandes sans SDK
- Soumission de batches en JSONL pour traiter les requêtes en arrière-plan jusqu'à 24h
- Export de données en JSON, JSONL ou texte, compatible avec jq et les pipes Unix
- Authentification par clé API ou clés admin pour accès aux endpoints d'administration
- Installation multi-plateforme via binaires, Homebrew, ou Go 1.26+
- Commandes hiérarchisées (`openai <resource> <command>`) avec aide intégrée, pas de fichiers de config
Dans les commentaires
Débat partagé : satisfaction que l'outil existe enfin, mais beaucoup de scepticisme sur l'utilité réelle et la clarté de la présentation. Critiques récurrentes sur la documentation insuffisante et la confusion avec Codex.
- Plusieurs commentateurs jugent la distinction entre openai-cli et Codex confuse, d'autant que les noms de produits OpenAI créent déjà de la friction (Chat vs Work vs Codex vs cette CLI).
- Un fil récurrent : "c'est trivial à vibe-coder soi-même en 5 minutes avec curl et jq", ce qui réduit la perception de valeur ajoutée. Même observation que la documentation le présente de façon contre-intuitive pour des non-spécialistes.
- kristopolous propose llcat, un concurrent développé depuis un an, conçu comme une alternative unix-friendly (stateless, explicite, composable) avec des invocations sauvegardables et réutilisables entre collègues.
- Questions pratiques en suspens : la CLI consomme-t-elle la souscription forfaitaire ou les crédits API ? Anthropic propose-t-il un équivalent ? Ces réponses n'apparaissent pas dans le fil.
- Critique sur le manque de contexte dans la présentation officielle : une seule phrase aurait suffi à clarifier « à qui c'est destiné et pourquoi ».
Alternatives citées : llcat (kristopolous), alternative open source depuis un an, pensée comme outil unix-friendly avec persistance d'invocations et support multi-provider (OpenAI, Anthropic, OpenRouter).
Notre lecture
Utile pour les équipes utilisant déjà l'API OpenAI en scripts ou batch, mais probablement pas révolutionnaire. Le coût d'implémentation est si bas qu'une CLI wrapper de base n'est pas un exploit : la vraie question est si OpenAI en améliore l'ergonomie au-delà de ce que curl + jq offrent. À tester si vous orchestrez déjà des appels API sans SDK, mais aucune action imédiate pour une DSI généraliste. La confusion avec Codex suggère qu'OpenAI aurait du clarifier dès le titre : deux outils, deux usages, deux audiences.