Funciones Avanzadas
Claves de Proveedor y BYOK
Usa tus propias claves API de proveedor con TokSpan. Sin comisión de servicio en tráfico BYOK, mantén tus relaciones existentes con proveedores y combina tus claves con el grupo de TokSpan para máxima flexibilidad.
¿Qué es BYOK?
Bring Your Own Key (BYOK) le permite configurar sus claves API de proveedor existentes (OpenAI, Anthropic, Google, etc.) directamente en TokSpan. Cuando llama a un modelo que coincide con un proveedor BYOK, TokSpan enruta a través de su clave en lugar de nuestro grupo compartido.
Con BYOK, usted paga al proveedor directamente según sus tarifas — TokSpan no agrega ninguna comisión de servicio en solicitudes BYOK. Aun así obtiene el endpoint unificado de TokSpan, la conmutación automática, el seguimiento de costos y la gestión de límites de tasa.
¿Por Qué Usar BYOK?
| Escenario | Beneficio |
|---|---|
| Tiene precios empresariales con OpenAI / Anthropic | Conserve sus tarifas negociadas, evite márgenes duplicados |
| Su organización requiere facturación directa por proveedor | Los cargos del proveedor aparecen en su factura del proveedor, no en TokSpan |
| Necesita cumplimiento estricto de políticas de datos | Los datos fluyen a través de sus claves — usted controla la relación con el proveedor directamente |
| Desea una ruta de migración gradual | Comience con BYOK, agregue el grupo de TokSpan como respaldo, transicione a su ritmo |
Configurando BYOK
- Vaya a Panel → Configuración → Claves de Proveedor
- Haga clic en Agregar Clave de Proveedor
- Seleccione el proveedor (OpenAI, Anthropic, Google, etc.)
- Pegue su clave API del proveedor
- Opcionalmente, restrinja a modelos específicos — solo esos modelos usarán esta clave
- Establezca una prioridad — los números más bajos se intentan primero
Lógica de Enrutamiento con BYOK
Cuando realiza una solicitud, TokSpan resuelve qué clave usar en este orden:
- Claves BYOK (por prioridad) — Sus claves se intentan primero si coinciden con el modelo solicitado
- Grupo de TokSpan — Si ninguna clave BYOK coincide (o todas fallan), recurrimos a nuestro grupo compartido
Puede activar "Usar siempre esta clave" para evitar la conmutación por error al grupo — la solicitud dará error si su clave falla (útil para requisitos estrictos de políticas de datos).
Ejemplo de Configuración
Una configuración típica con enrutamiento basado en prioridad:
{
"providers": {
"openai": {
"api_key": "sk-your-openai-key",
"models": ["gpt-4o", "gpt-4o-mini"],
"priority": 1
},
"anthropic": {
"api_key": "sk-ant-your-key",
"priority": 2
}
}
}En esta configuración: las solicitudes para GPT-4o o GPT-4o-mini usan su clave de OpenAI (sin comisión de servicio). Las solicitudes para modelos Claude usan su clave de Anthropic. Todo lo demás recurre al grupo de TokSpan.
Monitoreando el Uso de BYOK
En los registros de uso del Panel, las solicitudes BYOK se etiquetan con la clave de proveedor utilizada. Filtre por proveedor para ver su gasto directo con el proveedor vs. el gasto del grupo de TokSpan. Los registros de actividad muestran qué clave sirvió cada solicitud — útil para depuración y asignación de costos.
Mejores Prácticas
- Deje el respaldo habilitado — A menos que tenga una razón de política estricta, permita que TokSpan recurra al grupo si su clave falla. Esta es la principal ganancia en fiabilidad.
- Establezca restricciones de modelo — Limite cada clave BYOK a modelos específicos para evitar enrutar accidentalmente modelos costosos a través de su clave.
- Monitoree las facturas del proveedor — Las solicitudes BYOK aparecen en la factura de su proveedor. Cruce periódicamente con los registros de uso de TokSpan.
- Rote las claves BYOK — Se aplica la misma política de rotación de 90 días. Revise las claves antiguas desde el panel del proveedor, actualice en TokSpan.