Apresentamos o Breeze CLI: a IA de voz que mora no seu terminal

A forma mais rápida de avaliar uma API de voz é ouvindo. Todo comando deste post cabe em uma linha: copie, rode e siga lendo. Para instalar:

Confirme que ficou tudo no lugar:

Faça login uma única vez. O CLI abre seu navegador, você aprova o dispositivo e uma chave específica dele é gravada na sua máquina com permissões de arquivo restritas. Você nunca copia uma API key na mão, e o servidor guarda apenas um hash dela:

Agora é só fazer ele falar:

O áudio começa a tocar no instante em que os primeiros bytes chegam — direto para as suas caixas de som, com a forma de onda ao vivo no terminal. Repare em tudo o que você não fez: não escolheu um modelo, não vasculhou um catálogo de vozes, não leu um guia de início rápido. Se você não escolhe uma voz, a Breeze escolhe uma boa por você, porque a única pergunta que importa nos seus primeiros trinta segundos é “eu gosto do que estou ouvindo?”

Quando a voz padrão não é a que está na sua cabeça, navegue pela biblioteca:

Faça teste de voz como você faria qualquer teste A/B: mesma fala, vozes diferentes, comparação imediata. Rode de novo usando os voice IDs da lista:

Guarde a take de que você gostou:

Todo o resto da superfície de vozes está a um subcomando de distância: desenhar uma voz nova a partir de um briefing em texto, clonar, ouvir prévias, consultar seu histórico de geração, disparar jobs assíncronos. O CLI é um cliente completo da Breeze Developer API, não um invólucro de demo em cima de um cantinho dela.

O pior momento de qualquer protótipo é descobrir que a ferramenta divertida e a API de verdade são dois mundos separados. O Breeze CLI fecha essa lacuna por construção: cada comando corresponde à Developer API pública /v1 — a mesma que está por trás dos nossos SDKs de Python e TypeScript. Então, quando uma take sai do jeito certo, peça ao CLI que entregue a requisição:

O breeze curl imprime uma requisição cURL reproduzível para exatamente o que você acabou de fazer, com a sua chave real trocada por um placeholder — dá para colar em um script, em um pull request ou no chat de um colega sem risco. Traduza para uma chamada de SDK ou coloque no ar do jeito que está. Nada muda de semântica entre explorar e produzir, porque sempre foi a mesma API.

Cada vez mais, o “desenvolvedor” que digita um comando de CLI é um agente de IA. Tratamos isso como restrição de projeto, não como curiosidade. Acrescente --agent a qualquer comando e o Breeze CLI vira uma chamada de ferramenta bem-comportada: resultado em JSON no stdout, envelope de erro em JSON no stderr, sem perguntas interativas, sem spinner, sem áudio inesperado:

A síntese que você acabou de rodar no modo interativo vira uma chamada silenciosa que produz arquivos:

As falhas são ramificáveis, não parseáveis: erros de autenticação, de credits, de timeout e de rede correspondem cada um a um exit code estável, então o script se recupera com lógica — refazer login, recarregar credits, tentar de novo — em vez de aplicar regex sobre texto escrito para humanos. E o agente não precisa aprender a superfície de comandos por tentativa e erro, porque o CLI se descreve em uma única chamada:

Para agentes de programação há mais um degrau: skills curadas que ensinam ao Claude Code, ao Codex ou ao Cursor os fluxos de trabalho recomendados da Breeze. A instalação é opt-in explícito e nunca encosta na sua API key:

Troque codex por claude ou cursor. E se for um agente preparando o CLI para você, uma linha instala os dois:

Voz raramente entra em cena sozinha. O Video Lab, embutido no CLI, transforma uma composição em HTML em um MP4 com narração do Breeze TTS — e o pipeline inteiro foi desenhado para ser conduzido por um agente, com relatório JSON em cada etapa. Para iniciar um projeto:

Valide antes de gastar tempo de renderização — é aqui também que um agente pega os problemas visuais quadro a quadro: texto transbordando, elementos cortados, legendas ilegíveis:

Depois, renderize o MP4 final, já com a narração:

Suas composições, seus assets e seus vídeos prontos nunca saem da sua máquina. A única requisição de rede do pipeline inteiro é a própria narração.

Uma ferramenta que você conecta a scripts precisa ser sem graça nos lugares certos. Os dados vão para o stdout e o status vai para o stderr, então os pipes sempre se comportam. As credenciais ficam em arquivos locais com permissões travadas, e as chaves só aparecem mascaradas na saída. Os profiles mantêm staging e produção — ou duas contas — bem separados na mesma máquina. E o breeze update atualiza o binário e o runtime quando você pede: nunca no meio de um script, nunca no CI, nunca pelas suas costas.

Três linhas separam um terminal vazio de uma voz que você pode ouvir:

A documentação completa — início rápido, referência de comandos, guia de scripting e solução de problemas — está em docs.breezeblue.ai/cli. Vamos adorar saber o que você vai construir com ela.