Presentamos Breeze CLI: voz con IA que vive en tu terminal

La forma más rápida de evaluar una API de voz es escucharla. Cada comando de este artículo cabe en una sola línea: cópialo, ejecútalo y sigue leyendo. Instala:

Confirma que quedó instalado:

Inicia sesión una sola vez. La CLI abre tu navegador, tú apruebas el dispositivo y se escribe en tu máquina una clave propia de ese dispositivo, con permisos de archivo estrictos. Nunca copias una API key a mano, y el servidor solo guarda un hash de ella:

Ahora haz que hable:

El audio empieza a sonar en cuanto llegan los primeros bytes: se transmite directo a tus altavoces, con una forma de onda en vivo dentro de la terminal. Fíjate en todo lo que no hiciste: no elegiste un modelo, no recorriste un catálogo de voces, no leíste una guía de inicio. Si no eliges una voz, Breeze elige una buena, porque la única pregunta que importa en tus primeros treinta segundos es “¿me gusta lo que escucho?”

Cuando la voz por defecto no es la que tienes en la cabeza, recorre la biblioteca:

Audiciona candidatas como harías con cualquier prueba A/B: la misma frase, otra voz, comparación inmediata. Vuelve a ejecutar con los Voice ID de la lista:

Quédate con la toma que te gustó:

El resto de la superficie de voz está a un subcomando de distancia: diseñar una voz nueva a partir de un brief de texto, clonar, previsualizaciones, tu historial de generaciones, trabajos asíncronos. La CLI es un cliente completo de la Breeze Developer API, no un envoltorio de demo sobre un rincón de ella.

El peor momento de un prototipo es descubrir que la herramienta divertida y la API real son dos mundos distintos. Breeze CLI cierra esa brecha por construcción: cada comando se corresponde con la Developer API pública /v1, la misma que está detrás de nuestros SDK de Python y TypeScript. Así que cuando una toma suena bien, pídele a la CLI que te entregue la petición:

breeze curl imprime una petición cURL reproducible de exactamente lo que acabas de hacer, con tu clave real sustituida por un marcador de posición: puedes pegarla sin riesgo en un script, en un pull request o en el chat con un compañero. Tradúcela a una llamada del SDK o mándala tal cual. La semántica no cambia en nada entre explorar y producir, porque siempre fue la misma API.

Cada vez con más frecuencia, el “desarrollador” que escribe un comando de CLI es un agente de IA. Lo tomamos como una restricción de diseño, no como una curiosidad. Añade --agent a cualquier comando y Breeze CLI se convierte en una llamada de herramienta bien educada: resultados JSON en stdout, sobres de error JSON en stderr, sin prompts, sin spinners, sin audio inesperado:

La síntesis que acabas de ejecutar de forma interactiva se convierte en una llamada silenciosa que produce un archivo:

Los fallos se ramifican, no se parsean: los errores de autenticación, de credits, de timeout y de red se corresponden cada uno con un código de salida estable, así un script se recupera con lógica —volver a iniciar sesión, recargar saldo, reintentar— en vez de con expresiones regulares sobre texto pensado para humanos. Y un agente no tiene que aprender la superficie de comandos a base de prueba y error, porque la CLI se describe a sí misma en una sola llamada:

Para los agentes de programación hay un paso más: skills curadas que le enseñan a Claude Code, Codex o Cursor los flujos de trabajo recomendados de Breeze. La instalación es una decisión explícita y nunca toca tu API key:

Cambia codex por claude o cursor. Y si es un agente el que te está configurando la CLI, una sola línea instala ambas cosas:

La voz rara vez viaja sola. Video Lab, integrado en la CLI, convierte una composición HTML en un MP4 con narración de Breeze TTS, y todo el pipeline está pensado para que lo maneje un agente, con un informe JSON en cada paso. Inicializa un proyecto:

Valida antes de gastar tiempo de render; aquí también es donde un agente detecta problemas visuales fotograma a fotograma: texto desbordado, elementos recortados, subtítulos ilegibles:

Después renderiza el MP4 terminado, narración incluida:

Tus composiciones, tus recursos y tus videos terminados nunca salen de tu máquina. La única petición de red de todo el pipeline es la narración misma.

Una herramienta que vas a encadenar dentro de scripts tiene que ser aburrida en los lugares correctos. Los datos van a stdout y el estado va a stderr, así las tuberías siempre se comportan. Las credenciales viven en archivos locales con permisos bloqueados, y las claves solo aparecen enmascaradas en la salida. Los perfiles mantienen staging y producción —o dos cuentas— bien separados en una misma máquina. Y breeze update actualiza el binario y su runtime cuando tú se lo pides: nunca a mitad de un script, nunca en CI, nunca a tus espaldas.

Tres líneas para pasar de una terminal vacía a una voz que puedes escuchar:

La documentación completa —inicio rápido, referencia de comandos, guía de scripting y solución de problemas— está en docs.breezeblue.ai/cli. Nos encantaría saber qué construyes con ella.