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.
Todos los artículos
Primeros pasos
Herramientas de estudio
Herramientas de enfoque
Planificación
Athena e IA
Cuenta y facturación
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
- Abre Ajustes y elige Conexiones.
- Desplázate hasta Tu propia clave de IA.
- En Añadir una clave, elige un Proveedor.
- Opcional: escribe un Modelo. Déjalo vacío para usar el predeterminado del proveedor que aparece en el cuadro.
- 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.
- 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
¿Algo aquí está mal o no se entiende? support@atheneum.app