Usar la aplicación web

La aplicación web en app.zabio.ai es donde gestionas todo lo que rodea a tus llamadas a la API. El menú de la izquierda lleva a cada sección de esta página. Los propietarios y administradores pueden cambiar los ajustes de la organización; los miembros pueden usarlos (en Equipos y organizaciones tienes lo que puede hacer cada rol).

Organizaciones

Una organización contiene tu saldo, tus claves, tus miembros y tus ajustes. Su nombre aparece arriba a la izquierda, junto al logo de Zabio.

• Cambiar de organización: abre el menú de arriba a la izquierda y elige otra organización.
• Crear una organización: abre el mismo menú y elige Nueva organización. Si ya eres propietario de una, Zabio te sugiere antes un proyecto: el mismo saldo, con sus propias claves y topes de gasto. Elige Continuar con una organización nueva si de verdad necesitas un saldo y una facturación aparte. Una organización nueva empieza en el plan Free, con todos los proveedores de modelos activados.
• Cambiarle el nombre o el idioma por defecto: en Ajustes, el apartado de la organización (Nombre de la organización), y después Guardar.
• Elegir qué pasa cuando se acaba el saldo: en Ajustes, en Cuando el saldo llega a cero, elige entre seguir en el plan Free (100 peticiones al día con los modelos gratuitos hasta la próxima recarga) y Detener todas las peticiones hasta la próxima recarga. Tus claves y tus miembros se quedan en ambos casos.

Claves API

Las claves son lo que tu código envía con cada petición. Abre Claves API en el menú.

Crear una clave: pide tres cosas, y los demás ajustes empiezan con su valor por defecto.

1. Elige antes el proyecto en la parte superior de la página: la clave se crea en el proyecto en el que estás, o a nivel de la organización en Todos los proyectos.
2. Haz clic en Crear clave y ponle un Nombre (por ejemplo, “producción”).
3. Elige su Caducidad: Nunca, En 7 días, En 30 días, En 90 días o En una fecha (la clave deja de funcionar a las 00:00 UTC de ese día). Una clave caducada se rechaza y aparece como Caducada; quien la creó recibe un correo 7 días antes.
4. Si quieres, fija un Límite de gasto (USD) y cuándo Se reinicia: cada Día, Semana o Mes a las 00:00 UTC (las semanas empiezan el lunes), o Nunca, un presupuesto para toda la vida de la clave. Cuando la clave lo ha gastado, sus llamadas se rechazan hasta que el límite se reinicia. Déjalo vacío para no poner límite.
5. Haz clic en Crear y copia la clave cuando aparezca (Copia tu clave ahora). Es la única vez que se muestra completa; guárdala en un lugar seguro.

La lista muestra el gasto de cada clave frente a su límite en el periodo actual, cuándo se reinicia el límite y cuándo caduca la clave.

Cambiar una clave: haz clic en Editar en su fila. El panel lo tiene todo: el nombre, el proyecto (propietarios y administradores), la caducidad, el límite de gasto y su reinicio, los Permisos (Chat, Embeddings, Conversaciones: a qué endpoints puede llamar la clave), Peticiones por minuto y Tokens por minuto, la Política de respaldo (Solo el mismo proveedor, Cualquier proveedor, Sin respaldo) y Guardar el contenido de peticiones y respuestas (desactivado salvo que necesites conservar el texto completo de las llamadas; se guarda cifrado durante el plazo de retención de tu organización y lo pueden leer los propietarios y administradores); haz clic en Guardar. Debajo, Modelos elige qué modelos puede usar la clave, y se guarda por separado.

La caché de prompt no es un ajuste de la clave: Zabio usa la caché en cada llamada de forma automática, y una llamada que no la quiera lo indica con cache.ttl none.

Revocar una clave: haz clic en Revocar en su fila y confirma con Revocar clave. Las llamadas con esa clave fallan al instante, y no se puede deshacer. Las claves revocadas quedan ocultas; marca Mostrar claves revocadas para verlas.

Proyectos

Los proyectos agrupan claves y su uso bajo un mismo saldo, para separar trabajos (una app, un cliente, un entorno de pruebas) sin crear otra organización. Abre Proyectos.

• Crear un proyecto: haz clic en Nuevo proyecto, ponle un nombre y confirma. Después asígnale claves desde el campo de proyecto de cada clave.
• Renombrar un proyecto: haz clic en Editar en su fila.
• Archivar un proyecto: haz clic en Archivar. Sus claves siguen funcionando; el proyecto solo deja de aparecer en las listas. Marca Mostrar archivados para ver los proyectos archivados.

Miembros

Abre Miembros para ver quién está en la organización, su rol, su cuota mensual y lo que ha gastado este mes.

• Invitar a alguien: haz clic en Invitar, escribe su correo, elige su rol (miembro o administrador), si quieres fija una Cuota (USD al mes) que limita lo que pueden gastar sus claves, y confirma. La invitación aparece en Invitaciones pendientes hasta que la acepte, y desde ahí la puedes cancelar (Cancelar invitación).
• Cambiar un rol o una cuota: haz clic en Editar en la fila del miembro.
• Quitar a un miembro: haz clic en Quitar y confirma. Pierde el acceso a la organización; las claves que creó siguen activas, así que revócalas en Claves API si hace falta.

Una organización siempre conserva al menos un propietario.

Modelos

Abre Modelos para elegir qué modelos puede usar tu organización, con el precio de cada modelo por millón de tokens, su contexto y sus capacidades.

• Permite un proveedor entero, también los modelos que añada más adelante, con el interruptor junto a su nombre.
• Permite modelos sueltos con sus casillas; filtra por proveedor, capacidad o nombre, y usa Seleccionar todos o Quitar todos sobre lo que muestran los filtros.
• Permitir todo lo que permite el nivel superior vuelve al valor por defecto, también los modelos que se añadan más adelante.
• Las líneas auto tienen sus propias casillas arriba.
• Haz clic en Guardar cambios para guardar lo que cambiaste.
• El mismo selector fija los modelos de la cuenta (página Cuenta), de un proyecto (Modelos en Proyectos) y de una key (Modelos en Claves API); consulta Acceso a modelos.
• Cada proveedor indica dónde procesa las peticiones (por ejemplo, Estados Unidos, Norteamérica, o China en la API propia de DeepSeek).
• Los modelos auto solo eligen entre los modelos activados aquí.
• Usa tu propia clave (opcional) te permite añadir tu propia clave de ese proveedor; consulta Tus propias claves de proveedor.

Facturación

Abre Facturación para tu saldo, tus pagos y todo lo que mueve dinero. Las reglas completas están en Facturación.

• Añadir saldo: haz clic en Añadir saldo, elige un importe (como mínimo la recarga mínima de la página de precios) y haz clic en Continuar al pago; pagas en el formulario de la propia página. Marca Guardar esta tarjeta para recargas en un clic y recarga automática si quieres. Tus datos de facturación se piden con la primera recarga.
• Editar los datos de facturación (nombre, dirección y número fiscal que aparecen en los recibos): haz clic en Editar en ese apartado.
• Gestionar las tarjetas guardadas: en su apartado ves cada tarjeta y cuál es la predeterminada, y puedes quitar una con Quitar.
• Activar la recarga automática: en su apartado, actívala, fija el saldo por debajo del cual recargar, el importe que se añade (como mínimo la recarga mínima de la página de precios), el tope mensual (200 USD por defecto) y la tarjeta, y haz clic en Guardar. Cada recarga te envía un recibo, y la puedes desactivar cuando quieras.
• Mover crédito a otra organización de la que eres propietario: en Mover crédito a otra organización ves cuánto se puede mover ahora (Disponible para mover ahora: crédito pagado de al menos 7 días). Elige el Destino y el Importe (USD), y haz clic en Mover crédito. El crédito promocional, de referidos y de match se queda donde está.
• Usar tus propias claves de proveedor: en el apartado de claves de proveedor, añade la tuya.
• Ver cada movimiento: el historial de actividad lista cada recarga, cargo y ajuste, del más reciente al más antiguo.

Panel

El Panel muestra cómo usa Zabio tu organización. Elige el periodo arriba a la derecha (este mes o los últimos 30 días), o exporta las cifras en CSV.

• El saldo, el gasto y el costo directo (lo que habrían costado las mismas llamadas a precio de lista de los proveedores), y después lo ahorrado, la diferencia. Las llamadas hechas mientras la referencia de una key estaba pendiente no cuentan ahorro, como mostró cada una, y una llamada que costó más que su referencia cuenta 0, nunca un ahorro negativo, así que lo ahorrado puede no coincidir con el costo directo menos el gasto.
• Los aciertos de caché, la parte de los tokens de entrada que el proveedor sirvió desde su caché, y el costo por millón de tokens, la forma habitual de comparar proveedores.
• Las llamadas, la latencia y las conversaciones guardadas.
• Debajo: el gasto diario, el desglose del costo (precio del proveedor, comisión de servicio de Zabio, la cantidad por la elección automática del modelo, y el clasificador en los días anteriores a la versión 1.2.6), a dónde fueron tus tokens, el gasto por tipo de trabajo (el tipo de tarea con el que el enrutado clasificó cada llamada auto, mostrado por su nombre, y después la dificultad y el riesgo; las llamadas que nombraron un modelo forman su propio grupo), y el gasto por modelo, por clave y por miembro. Los tipos de tarea están en la referencia de la API.

Uso

Uso muestra lo que cuestan tus llamadas, lo que ahorró Zabio y lo que se ejecutó, en tu propia zona horaria. Tiene dos pestañas bajo una misma barra de filtros: Periodo (Hoy, Últimos 7 días, Últimos 30 días, Este mes o un periodo personalizado), Proyecto, Clave, Proveedor y Modelo. La vista está en la dirección de la página, así que puedes guardarla o compartirla con tu equipo; los enlaces Explorar del panel la abren con los filtros correspondientes. Un miembro limitado a proyectos solo ve y filtra sus proyectos. Una llamada conserva el proyecto en el que ocurrió, aunque su clave pase después a otro proyecto.

Estadísticas dibuja cinco gráficos, cada uno con su total del periodo encima, por horas en un periodo de dos días o menos y por días en los demás:

• Gasto: lo que se te facturó.
• Ahorro: lo que ahorró el enrutado frente al modelo de referencia de cada clave. Una llamada que costó más que su referencia aparece por debajo de cero.
• Peticiones, con cuántas terminaron en error.
• Tokens: de entrada y de salida, con la parte de razonamiento.
• Caché: la entrada leída de la caché de prompt frente a la entrada sin caché, y lo que ahorró la caché a los precios de los proveedores.

Gasto, Ahorro, Peticiones y Tokens se apilan por modelo o por proveedor (Apilar por). Cada modelo y proveedor conserva un mismo color en todos los gráficos; un gráfico muestra ocho series como máximo, y el resto como Otros. Señala una barra para ver cada parte y el total, o usa Ver como tabla. Bajo los gráficos, Claves principales y Modelos principales listan los que más gastaron con su parte.

Registro lista las llamadas con los mismos filtros, de la más nueva a la más antigua, solo con metadatos; marca Solo errores para quedarte con las que fallaron. Cada fila muestra la hora, el modelo que pediste y el que respondió, el tipo de tarea de una llamada auto, los tokens de entrada y de salida, el costo, el resultado, el tiempo total, el tiempo propio de Zabio y el tiempo hasta el primer token en las llamadas en streaming. Haz clic en la hora de una llamada para abrirla; los propietarios y administradores ven además su petición y su respuesta cuando su clave guarda el contenido. Descargar CSV exporta las llamadas con los filtros. Haz clic en Cargar más para ver llamadas anteriores. La antigua dirección del Registro abre esta pestaña.

Conversaciones

Conversaciones muestra las conversaciones que tu código guarda mediante la API (/v1/responses o el parámetro conversation): cuántas hay, cuántas entradas, los tokens estimados y cuándo caduca la más antigua. Filtra por clave arriba. Aquí solo aparecen metadatos, nunca los mensajes. Cuánto tiempo se guardan se fija en Ajustes, con la Retención (días).

Playground

El Playground te permite probar la API y copiar la llamada a tu código.

1. Pega una clave en el campo Clave API. Se queda en tu navegador y solo va a la API con cada mensaje. Usa Mostrar para comprobarla y Olvidar para borrarla.
2. Elige el Modo: Chat completions, o Responses (conversación guardada).
3. Elige un modelo: auto, un nivel de enrutado (auto/cheap, auto/balanced, auto/best) o un modelo por su nombre.
4. Si quieres, añade un Prompt de sistema y ajusta las opciones de Zabio (caché, respaldo, máximo de tokens). Las opciones que dejas por defecto no se envían.
5. Escribe tu mensaje y haz clic en Enviar. Ves la respuesta, lo que hizo Zabio con ella (el modelo elegido, los tokens, el costo, lo que se sirvió desde la caché), consejos para que la llamada salga más barata, y la llamada lista para copiar.

Referidos

Referidos muestra tu enlace de referido y lo que ha ganado. Las reglas están en Créditos y promociones.

• Comparte tu enlace copiándolo, por correo, en X o en LinkedIn.
• Cambia el nombre de tu enlace: pide uno nuevo al azar o escribe el tuyo (de 3 a 20 caracteres: de la a a la z, del 0 al 9 y guiones) y confírmalo. Todos los nombres que has tenido siguen funcionando, así que los enlaces que ya compartiste nunca se rompen.
• Elige a qué organización va el crédito si perteneces a varias.
• Añade la insignia a tu README: copia el fragmento del final de la página en el README de tu proyecto; enlaza a tu enlace de referido.

Ajustes

Abre Ajustes para tu propia cuenta y la organización.

• Perfil: tu nombre y tu idioma, y después Guardar.
• Cambiar contraseña: escribe la Contraseña actual y la Contraseña nueva (al menos 12 caracteres), y haz clic en Actualizar contraseña.
• Sesiones: cada navegador en el que has iniciado sesión (el tuyo aparece como Este navegador). Revocar cierra una; Cerrar sesión en todos las cierra todas.
• Apps conectadas: las apps de IA que conectaste al servidor MCP de Zabio, con su organización, proyecto, qué pueden hacer, límite diario y caducidad. Desconectar termina una conexión y revoca su key. Consulta Conectar una app de IA.
• Tokens personales (para la CLI de Zabio): haz clic en Crear token, elige sus Permisos (Lectura, Gestionar claves, Uso, Facturación) y cópialo cuando aparezca; solo se muestra una vez y caduca a los 30 días. Cuando inicias sesión en la CLI desde una terminal, te muestra un código: abre Aprobar un dispositivo en la aplicación, escribe el Código y apruébalo.
• Conversaciones guardadas: fija la Retención (días), de 1 a 365, y Guardar.
• Descargar mis datos y Descargar los datos de la organización: un archivo JSON con todo lo que Zabio guarda de ti o de la organización (nunca las claves en sí).
• Borrar la organización y Borrar mi cuenta: cada apartado explica exactamente qué se borra al instante, qué en un plazo de 30 días y qué se conserva por la normativa contable. Ninguna de las dos acciones se puede deshacer.