Tus propias keys de proveedor

Puedes darle a Zabio tu propia API key de cualquiera de los proveedores que ofrece: Anthropic, OpenAI, Google, DeepSeek, xAI, Mistral AI o Together AI. Las llamadas a ese proveedor se ejecutan entonces con tu key y el proveedor te las factura a ti, mientras conservas el enrutado, las sesiones, las conversaciones guardadas y el panel de Zabio.

Por qué

• Ya tienes un contrato con el proveedor, gasto comprometido o créditos que quieres aprovechar.
• Quieres la factura del proveedor para ese tráfico, no la de Zabio.
• Quieres aprovechar créditos que ya tienes en un proveedor: las llamadas a modelos con nombre con tu propia key no necesitan créditos de Zabio.

Qué proveedores

Proveedor	Key	Dónde crearla
anthropic	una API key de Anthropic	la consola de Anthropic (Anthropic Console)
openai	una API key de OpenAI	la plataforma de OpenAI, página de API keys
google	una key de Google AI Studio (Gemini API)	Google AI Studio
deepseek	una API key de DeepSeek	platform.deepseek.com/api_keys
xai	una API key de xAI	console.x.ai, página API Keys
mistral	una API key de Mistral AI	console.mistral.ai, apartado API Keys del menú lateral
together	una API key de Together AI	api.together.ai, página de API keys de tu proyecto

Una key activa por proveedor y organización.

Una key se aplica a todos los modelos que Zabio sirve a través de ese proveedor. Por eso una key de Together AI sirve también para las copias de DeepSeek alojadas en Estados Unidos (sus ids terminan en @together). Los modelos de DeepSeek servidos por la propia DeepSeek, que procesan los datos en China, necesitan una key de DeepSeek.

Añadir una key

Página Facturación, sección keys de proveedor, o:

zabio vendor-keys add --vendor anthropic --label "key del equipo"

La CLI lee la key con entrada oculta. A continuación Zabio:

1. verifica la key con una llamada barata y autenticada al proveedor (un listado de modelos). Una key que el proveedor rechaza no se guarda: recibes vendor_key_invalid. Si no se puede contactar con el proveedor, la petición falla con vendor_unavailable y no se guarda nada;
2. la cifra con una clave de datos única de tu organización (AES-256-GCM) y guarda el texto cifrado, los últimos cuatro caracteres y la etiqueta;
3. empieza a usarla para ese proveedor en unos segundos.

Solo los propietarios y administradores pueden añadir o eliminar keys de proveedor. El texto en claro no se vuelve a mostrar nunca, no se registra en logs y ninguna API lo devuelve.

Qué cambia en las llamadas

• Las respuestas servidas con tu key llevan zabio.byok: true y la cabecera x-zabio-byok: true.
• Gratis salvo (consulta la página de precios) por llamada auto. Las llamadas servidas con tu propia key no pagan comisión de servicio y vendor_micros es 0, porque Zabio no tiene coste de proveedor; el proveedor te factura directamente. Una llamada a un modelo que nombras con tu key no cuesta nada a través de Zabio. Una petición auto servida con tu key paga solo la cantidad por la elección automática del modelo, el precio de elegir el modelo, una vez por petición, que aparece como call_fee_micros. La respuesta sigue llevando direct_micros, lo que habría costado la llamada enviada directamente al proveedor, para que las cifras sigan siendo comparables.
• Sin necesidad de créditos para un modelo con nombre cuyo proveedor tienes en una key. auto (cualquier línea, o una petición sin modelo) se ejecuta con la key de Zabio tengas las keys que tengas, porque así lo hace el clasificador; con saldo cero se sirve con los términos de Free como cualquier otra llamada (o se rechaza con 402 insufficient_credits cuando la organización está configurada para detenerse). Lo mismo ocurre con una conversación guardada que requiere compactación: el resumen es una llamada auto/cheap con la key de Zabio. Una cuenta Free puede por tanto empezar con sus propias keys sin recargar: los modelos con nombre en tus keys no se bloquean ni cuentan para los límites de Free; auto sí.
• Los límites de tasa de tu key en el proveedor se aplican a tu tráfico.

Cuando el proveedor rechaza tu key

Si un proveedor responde 401 o 403 a una llamada hecha con tu key, Zabio marca la key como invalid, responde a tu llamada con 400 byok_key_invalid y deja de usarla. Nunca recurre a la key propia de Zabio para ese proveedor, así que nunca pagas a Zabio por tráfico que querías ejecutar con tu contrato. Sustituye la key para reanudar.

Eliminar una key

Página Facturación, o zabio vendor-keys remove vk_.... El texto cifrado se borra de inmediato; la fila se conserva sin ningún secreto utilizable para el registro de auditoría. Los procesos que tenían la key en caché dejan de usarla en cinco minutos. Las llamadas a ese proveedor vuelven a las keys de Zabio y a tus créditos.

Listado

zabio vendor-keys list

Muestra id, proveedor, últimos cuatro caracteres, estado (active o invalid) y etiqueta. La aplicación web muestra además cuándo se verificó la key, cuándo se usó por última vez y el motivo del proveedor cuando se marcó como inválida.