Tous les produits d'IA vocale ont une jolie démo web. Mais le vrai travail de création avec la voix — brancher une narration dans un parcours d'onboarding, générer les dialogues d'un jeu, donner la parole à une application — ne se fait pas dans un navigateur. Il se fait dans un terminal, un éditeur, un pipeline de CI, et de plus en plus au cœur de la boucle d'outils d'un agent IA. Breeze CLI part de ce constat : la génération vocale Breeze arrive là où les développeurs travaillent déjà, et la question « en combien de temps puis-je entendre quelque chose ? » y est traitée comme la métrique qui compte le plus.
Démarrage rapide
Trente secondes avant le premier son
Le moyen le plus rapide d'évaluer une API vocale, c'est de l'entendre. Chaque commande de cet article tient sur une seule ligne : copiez-la, exécutez-la, poursuivez votre lecture. Installation :
curl -fsSL https://breezeblue.ai/cli/install.sh | shVérifiez que tout est en place :
breeze versionConnectez-vous une seule fois. La CLI ouvre votre navigateur, vous autorisez l'appareil, et une clé propre à cet appareil est écrite sur votre machine avec des permissions de fichier strictes. Vous ne copiez jamais de clé API à la main, et le serveur n'en conserve qu'un hash :
breeze loginMaintenant, faites-la parler :
breeze tts "Hello from Breeze"L'audio démarre dès l'arrivée des premiers octets, diffusé droit vers vos enceintes, avec une forme d'onde en direct dans le terminal. Remarquez tout ce que vous n'avez pas eu à faire : aucun modèle à choisir, aucun catalogue de voix à parcourir, aucun guide de démarrage à lire. Si vous ne choisissez pas de voix, Breeze en choisit une bonne à votre place, car la seule question qui compte dans vos trente premières secondes est : « est-ce que j'aime ce que j'entends ? »
Explorer
Trouver la bonne voix sans quitter le shell
Quand la voix par défaut n'est pas celle que vous avez en tête, parcourez la bibliothèque :
breeze voice listAuditionnez les candidates comme vous feriez n'importe quel A/B : même réplique, voix différente, comparaison immédiate. Relancez avec les Voice ID de la liste :
breeze tts "This is the voice of our onboarding narrator" --voice voc_xeh3w54cqvnpGardez la prise qui vous plaît :
breeze tts "This is the voice of our onboarding narrator" -o narrator.wavTout le reste de la surface voix est à une sous-commande de distance : concevoir une voix à partir d'un brief textuel, cloner, écouter des aperçus, consulter votre historique de générations, lancer des jobs asynchrones. La CLI est un client complet de la Breeze Developer API, pas une coquille de démo posée sur un coin de celle-ci.
Mettre en production
D'une commande jetable à une requête de production
Le pire moment du prototypage, c'est de découvrir que l'outil amusant et la vraie API sont deux mondes distincts. Breeze CLI supprime cet écart par construction : chaque commande correspond à la Developer API publique /v1, celle-là même qui alimente nos SDK Python et TypeScript. Alors, quand une prise sonne juste, demandez à la CLI de vous livrer la requête :
breeze curl tts "This is the voice of our onboarding narrator" --voice voc_xeh3w54cqvnp --format mp3 -o narrator.mp3breeze curl imprime une requête cURL reproductible correspondant exactement à ce que vous venez de faire, votre vraie clé remplacée par un placeholder : vous pouvez la coller sans risque dans un script, une pull request ou la conversation d'un collègue. Traduisez-la en appel SDK ou expédiez-la telle quelle. Rien ne change dans la sémantique entre l'exploration et la production, parce qu'il s'agissait de la même API depuis le début.
Nativement agent
Votre agent IA est un utilisateur de premier plan
De plus en plus souvent, le « développeur » qui tape une commande CLI est un agent IA. Nous en faisons une contrainte de conception, pas un gadget. Ajoutez --agent à n'importe quelle commande et Breeze CLI se comporte en appel d'outil bien élevé : résultats JSON sur stdout, enveloppes d'erreur JSON sur stderr, aucune invite interactive, aucun spinner, aucun son inattendu :
breeze voice list --agentLa synthèse que vous venez de lancer en interactif devient un appel silencieux qui produit un fichier :
breeze tts "Hello from Breeze" --voice voc_xeh3w54cqvnp -o hello.wav --agentLes échecs se traitent par branchement, pas par parsing : erreurs d'authentification, credits insuffisants, timeout et erreurs réseau correspondent chacun à un code de sortie stable, si bien qu'un script se rétablit par la logique — se reconnecter, recharger des credits, réessayer — au lieu de faire tourner des regex sur du texte écrit pour des humains. Et un agent n'a pas à découvrir la surface de commandes par tâtonnements, car la CLI se décrit elle-même en un seul appel :
breeze capabilities --agentPour les agents de code, il y a un cran de plus : des skills sélectionnées qui enseignent à Claude Code, Codex ou Cursor les workflows Breeze recommandés. L'installation est un opt-in explicite et ne touche jamais à votre clé API :
breeze skills install --target codexRemplacez codex par claude ou cursor. Et si c'est un agent qui installe la CLI pour vous, une seule ligne met les deux en place :
curl -fsSL https://breezeblue.ai/cli/install.sh | sh -s -- --with-skills codexVideo Lab
De la vidéo narrée, rendue sur votre machine
La voix voyage rarement seule. Intégré à la CLI, Video Lab transforme une composition HTML en MP4 doté d'une narration Breeze TTS, et tout le pipeline est conçu pour être piloté par un agent, avec un rapport JSON à chaque étape. Initialisez un projet :
breeze video init --project demo --template authored --agentValidez avant de dépenser du temps de rendu : c'est aussi là qu'un agent repère les problèmes visuels image par image, texte qui déborde, éléments rognés, sous-titres illisibles :
breeze video validate --project demo --agentLancez ensuite le rendu du MP4 final, narration comprise :
breeze video render --project demo --agentVos compositions, vos assets et vos vidéos terminées ne quittent jamais votre machine. La seule requête réseau de tout le pipeline, c'est la narration elle-même.
Savoir-faire
La confiance est une fonctionnalité
Un outil que l'on branche dans des scripts doit être ennuyeux aux bons endroits. Les données partent sur stdout et l'état sur stderr : les pipes se comportent toujours correctement. Les identifiants résident dans des fichiers locaux verrouillés par leurs permissions, et les clés n'apparaissent qu'en version masquée dans les sorties. Les profils gardent staging et production — ou deux comptes — proprement séparés sur une même machine. Et breeze update met à jour le binaire et son runtime quand vous le lui demandez : jamais au milieu d'un script, jamais en CI, jamais dans votre dos.
À vous de jouer
Commencez ici
Trois lignes entre un terminal vide et une voix que vous entendez :
curl -fsSL https://breezeblue.ai/cli/install.sh | shbreeze loginbreeze tts "Hello from Breeze"La documentation complète — démarrage rapide, référence des commandes, guide de scripting et dépannage — se trouve sur docs.breezeblue.ai/cli. Nous serions ravis de découvrir ce que vous construirez avec.
