## Visión general

Cada cuenta puede usar sus **propias claves** de proveedores de IA (OpenAI, Anthropic, Google,
Groq, xAI, DeepSeek, OpenRouter, Cohere, ElevenLabs) — el llamado **BYOK** (bring your own key).
Cuando la cuenta no informa claves, aplican las claves globales definidas por el operador.

**Tavily** aparece en la misma pantalla, pero entra por otro motivo: **no es proveedora de chat**.
Ningún modelo corre con esa clave y nunca aparece en la cadena de modelos del bot — es la que
habilita las herramientas de **búsqueda en la web** y de **lectura de página**. Sin ella, esas dos
herramientas quedan indisponibles; todo el resto de la IA sigue funcionando normalmente.

## Requisitos previos

- Gobernanza de BYOK habilitada por el operador (interruptor de la instalación) y la capacidad
  activa en la cuenta.
- Perfil de administrador de la cuenta para registrar claves.

## Paso a paso

1. En la cuenta: Configuración → Integraciones → abre el proveedor deseado.
2. Usa **Obtener credenciales de _proveedor_** para crear la clave y **Ver documentación de
   configuración de _proveedor_** para consultar la guía oficial; ambos accesos aparecen sobre el
   formulario.
3. Introduce la clave. Pasa a usarse en los recursos de IA de esa cuenta (Cerebro, copiloto,
   agentes, dictado).
4. Para volver a las claves globales, desactiva la integración del proveedor.

## Configuración y opciones

- **Gobernanza del operador**: el operador puede apagar el BYOK de toda la instalación o de una
  cuenta específica. Con el BYOK apagado:
  - las claves de la cuenta **permanecen guardadas**, pero dejan de usarse;
  - se rechazan nuevas escrituras de claves;
  - todos los recursos de IA pasan a usar las claves globales.
- **Precedencia**: clave de la cuenta (BYOK activo) → clave global de la instalación.

## Casos de uso

- Cliente enterprise que exige facturación propia con el proveedor de IA.
- Operador que prefiere centralizar el consumo de IA en las claves globales para revender por
  paquete.

## Consejos, límites y buenas prácticas

- Nunca compartas claves entre cuentas de clientes distintos.
- Prefiere claves con límite de gasto configurado en el proveedor.
- Rota de inmediato las claves comprometidas — el cambio aplica en la siguiente solicitud.

## Solución de problemas

- **"No puedo guardar la clave"**: el BYOK está apagado por el operador para esta cuenta o para la
  instalación.
- **La IA responde con error de cuota**: verifica el saldo/límite de la clave en uso (de la cuenta
  o global) en el panel del proveedor.

## Ver también

- Maestro & IA: configuración y salud de la integración
- DeepSeek como proveedor de modelo del bot
- Búsqueda en la web: el bot consultando la internet pública
- Uso y límites de consumo