Línea de comandos
zabio te identifica con el navegador, te deja elegir una organización y una API key, muestra uso y precios, gestiona keys, proyectos y keys de proveedor, y chatea a través del router desde la terminal.
Instalación
Section titled “Instalación”La CLI es un único binario en Go. Compílala desde el repositorio del código fuente:
go build -o bin/zabio ./cmd/zabioDespués añade bin/zabio a tu PATH.
Primera ejecución
Section titled “Primera ejecución”zabio login # imprime una URL y un código, abre el navegador, espera la aprobaciónzabio orgs # tus organizacioneszabio use acme # elige una (se hace solo cuando hay exactamente una)zabio keys create --name laptopzabio keys use key_... # pega la key una vez; se guarda en el archivo de configuración (modo 0600)zabio chat "Resume la API de chat completions de OpenAI en una línea"zabio usagezabio keys use zb_live_... justo después de keys create también funciona: la CLI encuentra la key por su prefijo.
Comandos
Section titled “Comandos”usage: zabio [--config PATH] [--json] COMMAND [ARGS]
Commands: login sign in with the browser (device flow) logout revoke the session token and forget it whoami show the signed-in user orgs list your organizations use ORG_SLUG select the organization for later commands keys list|create|rotate|revoke|use manage API keys of the selected organization (list --project P: one project's keys) projects list|create manage projects (only the owner creates them) members list list members of the selected organization members invite EMAIL [--role member|admin] [--project P]... invite someone, optionally limited to projects members projects EMAIL [--project P]... limit a member to projects (none: all of them) usage [--month YYYY-MM | --days N] [--project P] spend summary and by-model breakdown models models and prices billing [show|ledger|topup] credits, ledger, add credits through Stripe vendor-keys [list|add|remove] your own vendor API keys (BYOK) conversations [list|show|delete] stored conversations (metadata only) chat --new | --conversation conv_... stateful chat through /v1/responses chat [--model M] [--system S] [--session ID] [MESSAGE] chat through the router (interactive without MESSAGE) tokens list|create|revoke manage your CLI tokens version print the version
Flags: --config PATH config file (default ~/.config/zabio/config.json) --json print the raw response JSON instead of tables
Environment: ZABIO_API_BASE, ZABIO_INFERENCE_BASE override the config file.El texto de ayuda de la CLI está en inglés.
Inicio de sesión e identidad
Section titled “Inicio de sesión e identidad”| Comando | Qué hace |
|---|---|
login [--no-browser] |
flujo de dispositivo: imprime una URL de verificación y un código, abre el navegador, espera la aprobación y guarda un token de usuario (zbu_...) |
logout |
revoca el token en el servidor y lo olvida en local |
whoami |
tu usuario, cómo has iniciado sesión, tus organizaciones, la organización y la key seleccionadas |
tokens list, tokens create --name N [--scopes a,b], tokens revoke ID |
tus tokens de CLI. create muestra el token una sola vez |
Organizaciones, keys, proyectos, miembros
Section titled “Organizaciones, keys, proyectos, miembros”| Comando | Qué hace |
|---|---|
orgs |
lista tus organizaciones; la seleccionada se marca con * |
use ORG_SLUG |
selecciona la organización. Cambiar de organización borra la API key seleccionada, porque las keys pertenecen a una sola organización |
keys list [--project P] |
keys de la organización, o de un proyecto; la que está en uso se marca con *. Un miembro limitado a proyectos solo ve las suyas |
keys create --name N [--project P] [--code C] |
crea una key y la muestra una sola vez. P es un id de proyecto (prj_...), un slug o un nombre. Con el inicio de sesión en dos pasos activado, la CLI te pide un código de tu app de autenticación; --code lo da sin preguntar (un script sin terminal debe pasarlo). La CLI no puede usar una llave de acceso: si solo tienes llaves de acceso, da un código de recuperación o crea la key en la app web |
keys rotate KEY_ID [--code C] |
da a la key un secreto nuevo y lo muestra una sola vez; la key conserva su id, sus ajustes y su historial, y el secreto anterior deja de funcionar al instante. Si es la key que usa esta CLI, la CLI guarda el secreto nuevo. Pide el segundo paso como keys create. La key de una app conectada no se puede rotar |
keys revoke KEY_ID |
revoca una key |
keys use KEY_ID [--key PLAINTEXT] [--yes] |
guarda una key en local para zabio chat. Pide la key con entrada oculta salvo que se pase --key, la comprueba contra el prefijo de la key y pide confirmación salvo con --yes |
projects list, projects create --name N |
proyectos; solo el propietario de la organización los crea |
members list |
miembros con rol, proyectos, cuota mensual y gasto del mes |
members invite EMAIL [--role member|admin] [--project P]... |
invita a alguien por email. Cada --project limita a un miembro a ese proyecto; sin ninguno ve toda la organización |
members projects EMAIL [--project P]... |
cambia los proyectos a los que está limitado un miembro; sin --project el miembro vuelve a ver toda la organización |
zabio chat --model auto/balanced --system "Responde en español" "¿Qué es la caché de prompt?"zabio chat --session soporte-42 "Segunda pregunta en la misma sesión de enrutado"zabio chat # interactivo; Ctrl-D o "exit" para salirzabio chat --new "Empieza una conversación guardada"zabio chat --conversation conv_... "Continúala"zabio transcribe --format srt reunion.mp3 # el archivo de subtítulos y una línea de costezabio speak -o manana.mp3 "Buenos días." # el archivo de audio y una línea de costezabio speak -o - --model aura-2 --voice aura-2-sirio-es --format wav "Hola." > hola.wavspeak acepta --model (auto por defecto), --voice (la voz por defecto del modelo si falta), --format (mp3, opus, aac, flac, wav, pcm) y --speed; -o - escribe el audio en la salida estándar. Las voces son generadas por IA.
Imágenes
Section titled “Imágenes”zabio image -o faro.jpg "Un faro rojo en una costa rocosa al atardecer" # el archivo de imagen y una línea de costezabio image -o cartel.png --model gpt-image-2.5-flare --size 1024x1536 --quality high --format png "Un cartel para una noche de jazz"zabio image edit -o sala-con-lampara.png "Pon la lámpara sobre la mesa de la sala" sala.png lampara.pngzabio image edit -o sombrero.png --mask mascara.png "Añade un sombrero rojo" retrato.pngzabio image --background --size 4096x4096 "Una ciudad de noche, detallada, 4K" # imprime el id, img_...zabio image status img_... # queued, in_progress, completed, failed o cancelledzabio image get -o ciudad.png img_... # la imagen cuando está completadaimage acepta --model (auto por defecto), --size (auto o ANCHOxALTO), --quality (de low a max en los modelos que lo aceptan) y --format (png, jpeg, webp); -o - escribe la imagen en la salida estándar. image edit acepta las mismas opciones, el prompt y luego uno o más archivos de imagen (png, jpeg o webp), y --mask con un png cuyas zonas transparentes marcan dónde editar la primera imagen (solo los modelos de OpenAI). image --background pone la generación en cola e imprime su id en lugar de esperar; image status ID imprime su estado, e image get -o FILE ID escribe su imagen cuando está completada. Una edición no puede ejecutarse en segundo plano. Las imágenes son generadas por IA; las de Google llevan una marca de agua SynthID.
Sin --model, chat usa auto: Zabio elige por ti el modelo más barato capaz de hacer el trabajo, y sube de línea cuando el trabajo lo necesita. chat emite la respuesta en streaming y después imprime una línea atenuada en stderr: modelo servido, proveedor, coste, tokens en caché y tiempo transcurrido. Sin mensaje, arranca un bucle interactivo que mantiene el historial en memoria y lo reenvía en cada turno. --new y --conversation usan la Responses API: el servidor guarda el historial, la CLI imprime el id de la conversación la primera vez, y la línea de estado añade escalated from ... o compacted cuando ocurren.
Uso, modelos y facturación
Section titled “Uso, modelos y facturación”| Comando | Qué hace |
|---|---|
usage [--month YYYY-MM | --days N] [--project P] |
facturado, ahorro (lo que ahorró el enrutado, calculado cuando lo ejecutas: consulta Facturación), llamadas, tokens, latencia media y una tabla por modelo, de la organización o de un proyecto. Por defecto: el mes en curso hasta hoy, en UTC |
models |
todos los modelos con los precios de lista de tu organización en USD por millón de tokens |
billing o billing show |
saldo, aviso de saldo bajo, recargas acumuladas, si se aplicó el crédito de prueba, plan y recarga mínima |
billing ledger [--limit N] |
el libro de créditos, del más reciente al más antiguo (de 1 a 500 filas) |
billing topup --amount USD [--no-browser] |
crea un enlace de Stripe Checkout por ese importe y lo abre. El saldo se actualiza cuando el pago se completa |
vendor-keys list, vendor-keys add --vendor anthropic|openai|google [--label L], vendor-keys remove vk_... |
tus propias keys de proveedor (Tus propias keys). add lee la key con entrada oculta y la verifica con el proveedor |
conversations list [--key key_...] [--limit N], conversations show conv_..., conversations delete conv_... |
conversaciones guardadas, solo metadatos. delete usa la API key seleccionada y es permanente |
Salida
Section titled “Salida”--json en cualquier comando imprime el cuerpo de la respuesta tal cual, en vez de la vista para personas. Los comandos que hacen varias llamadas imprimen un objeto con todos los cuerpos (whoami: {"me", "session"}; usage: {"summary", "by_model", "savings"}). chat --json imprime un evento en crudo por línea.
zabio usage --days 7 --json | jq .savings.saved_microszabio keys list --json | jq -r '.data[] | [.id, .name] | @tsv'Configuración
Section titled “Configuración”El archivo de configuración es ~/.config/zabio/config.json (modo 0600; se respeta $XDG_CONFIG_HOME). Guarda las URL base de la API, tu token de usuario, la organización seleccionada y la API key seleccionada. --config PATH o ZABIO_CONFIG seleccionan otro archivo. ZABIO_API_BASE y ZABIO_INFERENCE_BASE sustituyen las dos URL base durante una ejecución y nunca se escriben en el archivo.
Ningún comando imprime tu token de usuario ni tu API key, salvo tokens create y keys create, que muestran el secreto nuevo exactamente una vez.
Códigos de salida
Section titled “Códigos de salida”| Código | Significado |
|---|---|
| 0 | correcto |
| 1 | el servidor respondió con un error; se imprime como error: <mensaje> (<código>) |
| 2 | no se pudo contactar con el servidor o respondió algo ilegible |
| 64 | argumentos incorrectos; a continuación se imprime el texto de ayuda |