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-6-astra

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-6 Astra 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