BYOK — Configura tu clave API
BYOK (Bring Your Own Key, "trae tu propia clave") significa usar tu clave API de un proveedor de modelos de IA en lugar de la proporcionada por NeoAgent. Se configura en General Settings → Modelo AI, en la opción Clave API del modelo.
¿Qué es una clave API?
Una clave API es una credencial secreta que autoriza el acceso a un servicio de IA. El proveedor la utiliza para:
- identificar tu cuenta,
- facturar el consumo en tu cuota,
- aplicar los límites de tu plan.
¿Para qué sirve el BYOK?
- Control de costes: el consumo se factura directamente en tu cuenta del proveedor.
- Cuotas y límites propios: usas el nivel y los límites de tasa de tu cuenta.
- Modelos específicos: accedes a los modelos habilitados con tu clave.
- Cumplimiento: el tráfico hacia el proveedor sigue tu contrato.
Si dejas el campo vacío, NeoAgent usa su propia clave (créditos de la plataforma).
¿Dónde insertarla?
- Abre tu Chatbot → General Settings → Modelo AI.
- Selecciona el Modello (ej.
gpt-5). - En el campo Clave API del modelo pega la clave del proveedor correspondiente. El enlace "Haz clic aquí para obtener tu clave API" abre el portal correcto.
- Guarda. Con la X elimina la clave y vuelve a la clave de NeoAgent.
La clave debe pertenecer al mismo proveedor del modelo seleccionado (ej. modelo OpenAI → clave OpenAI). Una clave de otro proveedor genera errores de autenticación.
¿Dónde obtener la clave?
| Provider | Modelos típicos | Dónde crear la clave API |
|---|---|---|
| OpenAI | GPT-5, GPT-Realtime | https://platform.openai.com/api-keys |
| Anthropic | Claude (Opus, Sonnet, Haiku) | https://console.anthropic.com/settings/keys |
| Gemini | https://aistudio.google.com/app/apikey | |
| xAI | Grok | https://console.x.ai/ |
| DeepSeek | DeepSeek Chat / Reasoner | https://platform.deepseek.com/api_keys |
| Mistral | Mistral | https://console.mistral.ai/api-keys/ |
Para cada proveedor: accede al portal de desarrolladores, crea una nueva clave y cópiala. Para los modelos de consumo se necesita una cuenta con método de pago activo.
Seguridad
- La clave es un secreto: no la compartas, no la comitas, no la pegues en chats.
- Puedes revocarla en cualquier momento desde el portal del proveedor.
- Establece límites de gasto en el proveedor para evitar costes imprevistos.
- NeoAgent almacena la clave solo para ejecutar las llamadas de tu agente.
Después de guardar, envía un mensaje de prueba al chatbot. Si aparece un error de autenticación, la clave es incorrecta o pertenece a otro proveedor.