Saltar al contenido principal

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.

Dónde encontrarlo
Ajustes → Conexiones → Tu propia clave de IA
Última actualización
Actualizado el · 5 min de lectura
Todos los artículos

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

ProveedorModelo predeterminadoModelos sugeridos
OpenAIgpt-5-minigpt-5-mini, gpt-5, gpt-4.1-mini
Anthropic (Claude)claude-opus-5-5claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5
Google Geminigemini-2.5-flashgemini-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

¿Algo aquí está mal o no se entiende? support@atheneum.app

Gratis para empezar

Pruébalo en tu propio espacio de trabajo.

Sin tarjeta. El temporizador, las notas, las tareas y la música funcionan incluso sin cuenta.