# Usar tu propia clave de IA > Añade una clave de API de OpenAI, Anthropic o Google Gemini para que las funciones de IA de Atheneum usen tu propia cuenta del proveedor sin límite de créditos, y qué pasa si la clave falla. URL: https://atheneum.app/es/docs/byok Language: Español (es) Where in the app: Ajustes → Conexiones → Tu propia clave de IA Updated: 2026-10-25 Si tienes una clave de API de OpenAI, Anthropic o Google Gemini, puedes añadirla a Atheneum. Mientras la clave esté en uso, todas las funciones de IA se ejecutan en tu proveedor con el modelo que elijas y no cuestan créditos de IA. Tu proveedor te factura lo que uses. Necesitas una cuenta. Cualquier plan puede añadir una clave. ## Proveedores | Proveedor | Modelo predeterminado | Modelos sugeridos | |---|---|---| | OpenAI | gpt-5-mini | gpt-5-mini, gpt-5, gpt-4.1-mini | | Anthropic (Claude) | claude-opus-5-5 | claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5 | | Google Gemini | gemini-2.5-flash | gemini-2.5-flash, gemini-2.5-pro | Puedes escribir el nombre de cualquier modelo al que tenga acceso tu clave; las sugerencias son solo un punto de partida. ## Añadir una clave 1. Abre **Ajustes** y elige **Conexiones**. 2. Desplázate hasta **Tu propia clave de IA**. 3. En **Añadir una clave**, elige un **Proveedor**. 4. Opcional: escribe un **Modelo**. Déjalo vacío para usar el predeterminado del proveedor que aparece en el cuadro. 5. Pega tu clave en **Clave de API**. Si no tienes una, selecciona **Obtener una clave de …** para abrir la página de claves del proveedor. 6. Selecciona **Comprobar y guardar**. Primero Atheneum comprueba con el proveedor que la clave funciona y puede usar el modelo que elegiste. Esta comprobación usa la consulta gratuita de modelos del proveedor, así que no te cuesta nada. Si la supera, verás "Clave comprobada y guardada. Todas las funciones de IA la usan ahora." Puedes tener una clave a la vez. Guardar una nueva, en **Sustituir la clave**, reemplaza la anterior. ## Qué desbloquea Mientras tu clave está activa: - Athena, los resúmenes, las guías de estudio, las tarjetas, los cuestionarios, la calificación de cuestionarios, las comprobaciones de Blurt y los planes de lección se ejecutan en tu proveedor y tu modelo. - Estas acciones no cuestan créditos de IA, y tu asignación mensual no las limita. Siguen apareciendo en el panel de uso, con cero créditos, para que veas lo que usaste. - La pausa de la IA gratuita no te afecta, aunque estés en el plan Free. Lo que no cambia: - Siguen aplicándose los límites de cuadernos, archivos, almacenamiento y subidas de tu plan. Una clave cambia la IA, no el almacenamiento. - Tus créditos se quedan donde están, para cuando la clave esté en pausa o la quites. ## Qué sigue usando créditos Dos cosas se ejecutan siempre en el servicio de IA de Atheneum y gastan tus créditos aunque tengas una clave: - **Indexación de archivos**: preparar un archivo de un cuaderno para que Athena pueda encontrar pasajes en él. - **Relacionar tu pregunta con tus archivos**: un pequeño paso que ordena fragmentos de los archivos de tus cuadernos para Athena. Si no te quedan créditos, pasa a una simple coincidencia de palabras clave; tu chat sigue funcionando. ## Pausar, reanudar o quitar una clave La fila de tu clave muestra el proveedor, el modelo, los cuatro últimos caracteres de la clave y su estado: - **En uso para todas las funciones de IA**: la clave está activa. Selecciona **Pausar** para dejar de usarla. - **En pausa: se usa la IA de Atheneum**: se usan en su lugar la IA y los créditos de tu plan. Selecciona **Volver a usar mi clave** para reactivarla. Atheneum vuelve a comprobar la clave antes. - **Rechazada por el proveedor: sustitúyela**: el proveedor rechazó la clave al volver a comprobarla. Añade una clave nueva. Selecciona **Quitar** y confirma para eliminar la clave. La IA de Atheneum vuelve a encargarse. ## Cuando falla la clave Atheneum nunca te cambia a su propia IA sin preguntarte. Si falla una solicitud con tu clave, ves un error que indica el motivo, por ejemplo: - "OpenAI rechazó tu clave de API." - "… dice que tu cuenta se ha quedado sin saldo o sin cuota." - "… está limitando las solicitudes de tu clave en este momento." - "… no ofrece el modelo que elegiste para esta clave." - "… rechazó esta solicitud." - "… tardó demasiado en responder." - "… devolvió un error." Una ventana, **Tu clave de IA no funcionó**, explica el problema y ofrece dos opciones: - **Arreglar mi clave** abre Ajustes → Conexiones para que puedas sustituir la clave o cambiar el modelo. - **Usar la IA gratuita** pone tu clave en pausa (se conserva, no se elimina) para que la siguiente solicitud use la IA de Atheneum y tus créditos. Vuelve a intentar tu solicitud después del cambio. No se cobró nada por la solicitud que falló. ## Privacidad - Tu clave se cifra antes de guardarse. Nunca se devuelve a tu navegador; solo se muestran sus cuatro últimos caracteres. - Con una clave activa, tus preguntas y el material de estudio que necesita cada acción de IA se envían desde los servidores de Atheneum a tu proveedor en lugar de al servicio de IA de Atheneum. Lo que el proveedor haga con ellos, incluida la conservación y el entrenamiento, se rige por tu propio acuerdo con ese proveedor. - Quitar la clave la elimina. Consulta la sección de la política de privacidad sobre el uso de tu propia clave de IA. ## Límites - Una clave por cuenta. - Guardar, pausar, reanudar y quitar están limitados a 15 cambios cada 10 minutos. Después verás "Demasiados intentos: inténtalo de nuevo en unos minutos." ## Solución de problemas - **"Primero pega tu clave de API."** El cuadro **Clave de API** está vacío. - **La comprobación falla al guardar.** Lee el mensaje: una clave rechazada suele indicar un error al escribirla o una clave revocada; un modelo que falta significa que tu clave no puede usar ese modelo. Prueba con el modelo predeterminado del proveedor. - **Cambié a la IA gratuita y quiero recuperar mi clave.** Abre Ajustes → Conexiones y selecciona **Volver a usar mi clave**. - **"No se pudieron cargar los ajustes de tu clave de IA."** Recarga la página. ## Relacionado - [Créditos de IA](https://atheneum.app/es/docs/ai-credits) - [Athena, tu tutora](https://atheneum.app/es/docs/athena) - [Planes](https://atheneum.app/es/docs/plans) - [Seguridad de la cuenta](https://atheneum.app/es/docs/security)