Ir al contenido
Zabio está en beta: los modelos, los precios y las funciones pueden cambiar. Cuéntanos qué falla en hello@zabio.ai.

Organizaciones, miembros y keys

Todo en Zabio pertenece a una organización: créditos, API keys, miembros, proyectos, conversaciones guardadas y uso. Las organizaciones pertenecen a una cuenta. Una persona puede pertenecer a varias organizaciones. La aplicación web y la CLI zabio gestionan todo esto; las API keys solo hablan con /v1.

Al registrarte obtienes tu cuenta y su primera organización, con tu nombre (“Espacio de Ana”, a partir del nombre de tu inicio de sesión o de tu dirección de email), que puedes renombrar en Ajustes, General. Tu primera API key se crea con ella, con el nombre “Primera key”; es una de las dos keys del plan Free. Eres el propietario de tu cuenta y de las organizaciones que contiene. Solo el propietario de la cuenta crea organizaciones y proyectos.

Las personas que invitas pertenecen solo a las organizaciones a las que las invitas. No tienen cuenta propia, no pueden crear organizaciones ni reciben una organización propia; quien fue invitado y quiere su propia cuenta se registra con otra dirección de email. Quien fue invitado y después no pertenece a ninguna organización ni tiene invitaciones pendientes (nunca se unió, se fue o la organización se cerró) recibe su propia cuenta y su primera organización la próxima vez que inicia sesión, tras las mismas comprobaciones que cualquier registro. Una persona que tiene cuenta también puede ser invitada a la organización de otra persona.

Una organización tiene un nombre, un slug para la URL, una región (EE. UU. en el lanzamiento), un idioma por defecto para los emails (en o es) y ajustes. Crear una requiere una dirección de email verificada y una cuenta propia. Quien la crea es su propietario. Transferir una organización a otro propietario la mueve a su cuenta, así que el nuevo propietario necesita una cuenta propia.

Los saldos son por organización, y el plan Free es una organización por persona, así que antes de crear una segunda organización el diálogo te sugiere primero un proyecto: un proyecto comparte el saldo de la organización y tiene sus propias keys y límites de gasto, mientras que una organización nueva tiene su propio saldo y su propia facturación. Si aun así la creas, puedes mover crédito pagado a ella desde una organización que te pertenezca; consulta Facturación.

Borrar una organización (solo el propietario) la cierra: las API keys dejan de funcionar de inmediato, las conversaciones guardadas y los cuerpos de llamadas registrados se borran, y la clave de cifrado que los protegía se destruye 30 días después. Consulta Privacidad.

Acción owner admin member
ver la organización, miembros, keys, proyectos, uso, modelos, facturación sí sí sí
crear API keys; cambiar, rotar y revocar sus propias keys sí sí sí
cambiar, rotar y revocar keys de otras personas; mover una key a otro proyecto; renombrar y archivar proyectos; editar el nombre y el idioma de la organización sí sí no
crear proyectos sí no no
invitar y eliminar miembros, asignar el rol admin o member, fijar cuotas de miembro, leer el registro de auditoría sí sí no
añadir o eliminar keys de proveedor; añadir créditos; borrar conversaciones guardadas desde la aplicación web sí sí no
transferir la propiedad, cambiar o eliminar a un propietario, borrar la organización sí no no

Una organización siempre tiene al menos un propietario. Transferir la propiedad convierte al propietario anterior en administrador.

Los propietarios y administradores invitan por email, eligiendo la organización, el rol (admin o member), una cuota mensual opcional y, para un miembro, si quieren, los proyectos en los que trabaja (consulta Proyectos). La persona invitada recibe un enlace en el idioma por defecto de la organización. La invitación se acepta con la sesión iniciada con la misma dirección de email a la que se envió. Invitar de nuevo a la misma dirección envía un enlace nuevo.

Cada miembro puede tener una cuota mensual en USD. Se aplica a la suma del gasto de todas las API keys que ese miembro creó, en el mes de calendario, en UTC. Cuando se alcanza, las llamadas con esas keys devuelven 429 quota_exceeded con x-zabio-quota-scope: member. Las cuotas y el gasto por miembro los ven los propietarios y administradores.

Los proyectos son una agrupación opcional de API keys, para poder leer el uso por proyecto. Un proyecto tiene un nombre y un slug. Archivar un proyecto lo oculta; sus keys siguen funcionando y conservan su proyecto.

La tarjeta de arriba del menú, con la organización, también muestra un proyecto o todos. Las páginas muestran las keys, las llamadas, el uso y las conversaciones del proyecto elegido ahí, y una key nueva se crea en ese proyecto, o a nivel de la organización con “Todos los proyectos”.

Un miembro puede quedar limitado a uno o varios proyectos, al invitarlo o después desde Miembros. Un miembro limitado a proyectos solo ve las keys, las llamadas, el uso y las conversaciones de esos proyectos (una llamada y su gasto cuentan en el proyecto en el que ocurrieron, aunque la key cambie después), y solo crea keys en ellos; no ve las keys a nivel de la organización. Los propietarios y los administradores siempre ven toda la organización. Zabio lo aplica en cada petición, no solo en la aplicación web.

En la API, una key que pertenece a un proyecto solo lee y cambia las conversaciones, respuestas, archivos y lotes creados con keys de ese proyecto; una key a nivel de la organización lee toda la organización. Lo que queda fuera responde 404, como si no existiera.

Una key es zb_live_ seguido de 43 letras y dígitos aleatorios. Se muestra una sola vez al crearla; Zabio guarda solo un hash y los primeros 8 caracteres tras el prefijo, que el panel muestra para que distingas las keys. Cualquier miembro puede crear una key; se requiere un email verificado.

Ajuste Por defecto Rango Efecto
name obligatorio una etiqueta
project_id ninguno el proyecto al que pertenece la key
scopes chat, embeddings, conversations subconjunto de los tres qué endpoints puede llamar la key, se cambian en el panel de edición de la key; una llamada fuera de los scopes devuelve 403 insufficient_scope
rpm_limit 600 de 1 a 100,000 peticiones por minuto
tpm_limit 200,000 de 1 a 100,000,000 tokens por minuto; se cobra con una estimación al admitir y se devuelve tras la llamada
expires_at nunca un momento futuro cuándo deja de funcionar la key: nunca, en 7, 30 o 90 días, o en una fecha (a las 00:00 UTC de ese día). Desde entonces las llamadas se rechazan con 401 key_expired y la key aparece como Caducada; quien la creó (el propietario, si quien la creó ya no está) recibe un correo 7 días antes. Una nueva caducidad vuelve a activar una key caducada
spend_limit_micros ninguno 0 o más límite de gasto en micros; 429 quota_exceeded al alcanzarlo, con la fecha en que se reinicia. La cuota mensual de miembro de quien la creó se aplica además
spend_reset monthly never, daily, weekly, monthly cuándo vuelve a empezar el límite de gasto, a las 00:00 UTC (las semanas desde el lunes); never es un presupuesto para toda la vida de la key
model_access todo lo que permiten los niveles superiores proveedores y modelos el nivel propio de la key en el acceso a modelos (consulta Acceso a modelos)
fallback_policy same_vendor same_vendor, cross_vendor, none valor por defecto de zabio.fallback en modelos explícitos
body_logging desactivado activado o desactivado guardar los cuerpos de petición y respuesta de las llamadas de chat completions y embeddings, cifrados, durante el periodo de retención

Al crear una key en la aplicación web se piden su nombre, su caducidad y su límite de gasto; los demás ajustes empiezan con su valor por defecto y se cambian en el panel de edición de la key, que también tiene sus modelos. La caché de prompt no es un ajuste de la key: es automática en cada llamada, y una llamada la desactiva con zabio.cache.ttl none (consulta cache.ttl). Cada cambio se aplica en la siguiente llamada. Rotar una key le da un secreto nuevo y conserva su id, sus ajustes y su historial; el secreto anterior deja de funcionar al instante. Revocar una key es inmediato e idempotente; la key sigue apareciendo como revocada.

Los miembros pueden cambiar, rotar y revocar las keys que crearon. Los propietarios y administradores pueden cambiar, rotar y revocar todas las keys.

Los propietarios y administradores también pueden limitar las direcciones desde las que se puede llamar con una key, para toda la organización, para un proyecto o para una sola key: consulta Listas de direcciones IP permitidas y denegadas.

Chat completions y embeddings no guardan nada por defecto. Con body_logging activado, la petición y la respuesta de cada llamada se guardan cifradas bajo la clave de datos de la organización y se conservan durante el periodo de retención de la organización. Los propietarios y administradores pueden leer un cuerpo guardado desde la lista de llamadas del panel; cada lectura se anota en el registro de auditoría. Los cuerpos nunca aparecen en las exportaciones de uso ni en los emails.

El acceso a modelos tiene cuatro niveles: tu cuenta, la organización, un proyecto y una key. Cada nivel limita el de arriba, y una llamada solo puede usar lo que permiten todos los niveles; auto elige solo entre esos modelos. Por defecto cada nivel permite todo lo que permite el nivel superior, incluidos los modelos que se añadan más adelante.

En cada nivel, el mismo selector muestra los modelos agrupados por proveedor, con filtros de proveedores, de capacidades y una búsqueda. El interruptor de un proveedor permite todos sus modelos, también los que añada más adelante; la casilla de un modelo permite exactamente ese modelo. Los modelos auto (auto y sus tres líneas, auto/best, auto/balanced y auto/cheap) tienen sus propias casillas arriba: si están desmarcados, las llamadas a ese modelo se rechazan. Cuando un nivel superior desactiva un modelo, un nivel inferior conserva su marca: el modelo aparece desactivado en ese nivel y no cuenta, y vuelve cuando el nivel superior lo activa de nuevo.

  • Cuenta: el propietario de la cuenta, en Modelos, Modelos permitidos.
  • Organización: propietarios y administradores, en Modelos, Catálogo.
  • Proyecto: propietarios y administradores, con Modelos en API keys, Proyectos.
  • Key: quien puede editar la key, con Modelos en el panel Editar de la key, en API keys.

Un modelo que un nivel rechaza devuelve 404 model_not_found y auto nunca lo elige; GET /v1/models solo lista lo que permiten todos los niveles para la key. Un nivel que permite un modelo auto debe dejarle al menos un modelo que elegir. Un cambio en la cuenta, la organización o un proyecto que dejaría a un proyecto o una key de debajo sin ningún modelo para auto no se rechaza, pero el selector nombra los proyectos y keys afectados y pregunta antes de guardar; sus llamadas a auto responden entonces 400 no_model_allowed, con el nivel que hay que revisar.

Ajustes, Datos y privacidad, propietarios y administradores: la retención por defecto de las conversaciones guardadas y de los cuerpos registrados, de 1 a 365 días (30 por defecto). Una conversación puede fijar su propia retención al crearse. Consulta Responses API y Privacidad.

El Panel y Uso, Resumen muestran gasto, coste del proveedor, ahorro, llamadas, tokens y latencia de un periodo, por modelo, con una serie diaria; Uso, Resumen también los muestra por key y por miembro. Uso, Registros muestra los metadatos de cada llamada (hora, key, modelos, tokens, coste, resultado, latencia) y se puede exportar en CSV. El uso también está disponible en la CLI con zabio usage.

Registro de auditoría, propietarios y administradores: lo que se hizo en la organización, quién y cuándo. Recoge las keys creadas, cambiadas, rotadas o revocadas; los miembros invitados, eliminados o con otro rol o cuota; los cambios de proyectos, de acceso a modelos y de listas de IP; los créditos añadidos, las tarjetas guardadas y los pagos; las keys de proveedor, los webhooks, las apps conectadas y las exportaciones; las conversaciones borradas y los cuerpos registrados leídos; y lo que Zabio hizo en la organización, como una suspensión o un ajuste de saldo, que aparece como hecho por Zabio. Las filas se agrupan por día, de la más reciente a la más antigua. Cada fila muestra cuánto hace que pasó (la hora exacta en tu zona horaria al pasar el puntero), quién lo hizo, el tipo y qué se hizo en palabras sencillas, sobre qué y un resumen de una línea; al hacer clic en una fila ves sus campos, con ids que puedes copiar. Los miembros ven que el registro es para propietarios y administradores.

Puedes buscar en el registro, filtrar por tipo, por persona y por fechas, y descargar las filas filtradas en CSV (hasta las 10.000 más recientes; acota las fechas para las anteriores). La búsqueda mira lo que muestra una fila: el nombre y el correo de la persona, la acción y sus palabras en tu idioma, sobre qué se hizo y los campos que se muestran, nunca uno oculto; funciona junto con los filtros y la dirección de la página los guarda todos. En la API es GET /admin/v1/orgs/{org}/audit con q (la búsqueda, hasta 200 caracteres; q_action, repetido, nombra acciones que cuentan como coincidencia), action (repítelo, o indica un prefijo que acabe en punto, como key.), actor (el id usr_ de una persona), from y to (RFC 3339, to no incluido) y el cursor de la página anterior. Una búsqueda lee hasta 5.000 filas por petición; cuando se detiene ahí, search.stopped_at_bound de la respuesta es true y el cursor sigue con las filas más antiguas. La descarga de datos de la organización en Ajustes contiene las mismas filas.

Cada fila lleva los campos que un cliente puede ver según su tipo y nada más: nunca prompts, respuestas ni secretos, ninguna dirección de correo salvo la de un miembro, y en las filas de Zabio ni notas internas ni el nombre de la persona de Zabio. Los inicios de sesión se registran para cada persona, no en el registro de una organización (consulta Inicio de sesión). Las filas se conservan mientras exista la organización.

Email y contraseña (12 caracteres o más), Google, o un enlace mágico enviado por email. Hace falta verificar el email antes de crear una API key o una organización. Las sesiones se pueden listar y cerrar en Mi perfil, Seguridad, que también muestra tus últimos 20 inicios de sesión: la hora, cómo los hiciste y si usaste el segundo paso. La descarga de datos de tu cuenta los incluye. Guardamos un registro de cada inicio de sesión en tu cuenta (cuándo, cómo entraste y si usaste el segundo paso) durante 90 días y después lo borramos. Se borra antes si borras tu cuenta. La CLI inicia sesión con un código de dispositivo y recibe un token personal (zbu_...) que puedes listar y revocar en Mi perfil, Tokens de acceso.