Ir al contenido principal

Codificación con claves API

Con una clave API de Coderen puedes usar herramientas de programación que funcionen con una API compatible con OpenAI. La herramienta envía solicitudes a AI-School. AI-School verifica la clave, el presupuesto, el periodo de validez y los modelos permitidos.

Después, AI-School procesa la solicitud a través del puente técnico del entorno.

¿Qué necesitas?

Necesitas tres datos:

Dato¿Dónde puedes encontrarlo?
Clave APILa obtienes de un administrador o profesor
Endpointhttps://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Nombre del modeloPor ejemplo gpt-5.6-luna, gpt-5.6-terra o gpt-5.6-sol

La clave API empieza con ais.. Trátala como una contraseña.

¿Qué modelo eliges?

Para la mayoría de los estudiantes, GPT-5.6 Luna es un buen punto de partida. Este modelo rápido es adecuado para ayuda de programación durante la clase y preguntas de código cotidianas.

Para docentes o estudiantes avanzados, encaja bien GPT-5.6 Terra para proyectos más grandes y código más complejo. Elige GPT-5.6 Sol para tareas más exigentes con mucho análisis, planificación o razonamiento.

¿Qué herramienta eliges?

AI-School recomienda dos herramientas:

HerramientaRecomendado paraPor qué
AiderEstudiantes y programación en claseFunciona de forma explícita, clara y menos “agente”
OpenCodeDocentes y usuarios avanzadosCLI agentic con una aplicación de escritorio

Aider para estudiantes

Aider funciona como una herramienta de programación en pareja en la terminal. El usuario solicita ayuda, ve cambios y se mantiene relativamente cercano al código. Eso encaja bien con aprender a programar: el estudiante recibe apoyo, pero sigue participando en lo que ocurre.

Consulta también la documentación oficial de Aider.

OpenCode para uso avanzado

OpenCode es más agentic. La herramienta puede realizar pasos de forma autónoma, editar archivos y desarrollar tareas. Eso es poderoso, pero también requiere más comprensión de código, git y entornos de desarrollo locales.

Consulta también la documentación oficial de OpenCode.

Manejo seguro de claves

No compartas tu clave API públicamente y no la pongas en código que compartas.

Usa preferiblemente:

  • variables de entorno
  • un archivo local .env que no se envíe a Git
  • la configuración integrada de la herramienta

Para OpenCode, por ejemplo, puedes usar un .env en la carpeta del proyecto:

AI_SCHOOL_CODEREN_API_KEY=ais.tu-clave-api

Asegúrate de que la herramienta cargue realmente este .env. En PowerShell también puedes establecer la variable temporalmente para la terminal actual:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.tu-clave-api"
Atención

Nunca coloques claves API en un repositorio público, en Teams, en documentos compartidos o capturas de pantalla.

Si la clave no funciona

Verifica entonces:

  • si Coderen está activado para el entorno
  • si tu clave sigue activa
  • si el presupuesto no se agotó
  • si la clave está dentro del periodo de validez establecido
  • si estás usando un modelo permitido
  • si el endpoint está configurado correctamente
  • si la herramienta envía la clave API como Authorization: Bearer ...
  • si la herramienta no envía parámetros específicos del proveedor que AI-School Coderen no admite

Si tienes dudas, solicita a un administrador o docente que verifique la clave.

WhatsApp