Claves API (BYOK)

Objetivo

Trae tu propia clave (BYOK): guarda tus propias API keys de OpenAI y Google AI para que tus agentes de IA usen tus cuentas de proveedor. Las claves se verifican con el proveedor antes de guardarse, se almacenan cifradas y se muestran enmascaradas. Mantienes el control total y puedes eliminar una clave en cualquier momento.

Acceso

Sidebar -> Settings -> API Keys Ruta: /app/{tenant}/settings/api-keys

También puedes llegar aquí desde avisos dentro de la app: cuando una función de IA necesita una clave que aún no está conectada, te enlaza directamente a esta página.

Roles

• owner, admin

Requisitos previos

• Un email verificado. A las cuentas pendientes de verificación se les pide confirmar su email antes de poder guardar o eliminar una API key.
• Una cuenta con el proveedor que quieras usar (OpenAI y/o Google AI), y una clave generada allí.

Cómo se relaciona con los créditos de IA gestionada

Que necesites una clave aquí depende de tu ajuste de AI Engine (Settings -> AI Engine):

• Managed (planes de pago) — la plataforma ejecuta la IA por ti con los AI credits incluidos. No necesitas guardar tu propia clave.
• Advanced (tu propia API key) y el plan gratis — tus agentes usan las claves que guardes aquí. Sin una clave, no se pueden generar respuestas de IA.

Una clave guardada en esta página es la misma que usan tus agentes en tiempo de ejecución, y se comparte con la página de Integraciones, que gestiona esas mismas credenciales de OpenAI y Google AI junto a otros proveedores.

Guardar una API key

1. En la tarjeta del proveedor (OpenAI o Google AI), pega tu clave en el campo API Key.
2. Pulsa Save & Verify.
3. La clave se comprueba en vivo con el proveedor. Si es válida, se guarda y la tarjeta muestra la etiqueta Verified; si el proveedor la rechaza, no se guarda.

Una vez guardada, la tarjeta muestra la clave enmascarada (los primeros 8 y los últimos 4 caracteres, el resto oculto), una etiqueta de estado Verified / Unverified y una marca de Last verified.

Reemplazar una clave

Hay un único espacio de clave por proveedor y no hay campo de edición mientras haya una clave guardada. Para cambiar una clave, elimina primero la actual y luego guarda la nueva.

Eliminar una clave

1. En la clave guardada, pulsa el icono de trash.
2. Confirma en el diálogo.

Eliminar una clave deja de permitir que tus agentes usen ese proveedor hasta que añadas una nueva (salvo que tu cuenta esté en AI credits gestionados).

Otros proveedores

Esta página cubre solo OpenAI y Google AI. Los proveedores de voz y búsqueda están en la página de Integraciones:

• ElevenLabs y Deepgram — voz; surten efecto una vez que seleccionas ese proveedor en Voice Agents.
• Web Search y Twilio — también se conectan desde Integraciones.

Buenas prácticas

• Usa una clave de un proyecto o cuenta dedicada, separada de tus claves de prueba.
• Configura límites de gasto y alertas en el panel de tu proveedor.
• Mantén tu cuenta de proveedor con fondos: una clave válida sin fondos igual puede guardarse, pero las funciones de IA pueden fallar hasta que recargues.
• Rota las claves periódicamente: elimina la antigua aquí y guarda la nueva.

Notas comunes

• Please enter an API key — el campo estaba vacío al pulsar Save & Verify.
• Invalid API key — el proveedor rechazó la clave (incorrecta, revocada o sin el permiso adecuado); no se guardó. Corrígela e inténtalo de nuevo.
• Verify your email first — las cuentas pendientes de verificación no pueden guardar ni eliminar claves hasta confirmar su email.

Captura

Relacionado

• Integraciones
• Facturación y uso
• Configuración general
• Agentes de IA