Ir al contenido principal

Codificar con claves API

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

Luego AI-Corporate procesa la solicitud a través del enlace técnico del entorno.

¿Qué necesitas?​

Necesitas tres datos:

Dato¿Dónde lo encuentras?
Clave APILa obtienes de un administrador
Endpointhttps://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1
Nombre del modeloPor ejemplo gpt-5.4-mini, gpt-5.4 o gpt-5.5

La clave API empieza con aic.. Trata esta clave como una contraseña.

¿Qué herramienta eliges?​

AI-Corporate recomienda OpenCode para la mayoría de usuarios. OpenCode es una herramienta de codificación orientada a agentes para terminal, escritorio y IDE. La herramienta puede realizar pasos de forma autónoma, editar archivos y desarrollar tareas.

Aider es técnicamente compatible con un endpoint compatible con OpenAI, pero dentro de entornos Corporativos no se recomienda como herramienta por defecto.

Véase también la documentación oficial de OpenCode.

Seguridad al manejar claves​

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

Preferible usar:

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

Nunca coloques claves API en un repositorio público, chat, documento compartido o captura de pantalla.

Si la clave no funciona​

Verifica entonces:

  • si Coderen está activado para el entorno
  • si tu clave sigue activa
  • si el presupuesto se agotó
  • si la clave entra dentro del periodo de validez establecido
  • si estás usando un modelo permitido
  • si el endpoint está configurado correctamente

En caso de duda, solicita a un administrador que verifique la clave.

Variables de entorno y OpenCode​

Para OpenCode puedes almacenar la clave API de Coderen en un archivo local .env en la carpeta del proyecto:

AI_SCHOOL_CODEREN_API_KEY=ais.tu-clave-api

Asegúrate de que OpenCode cargue realmente esta variable de entorno. En PowerShell también puedes establecer la variable temporalmente para la terminal actual:

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

Si ves Authorization header with Bearer token is required, entonces la herramienta no envía la clave como Authorization: Bearer .... Si ves Unknown parameter, elimina las configuraciones específicas del proveedor que el endpoint de Coderen de AI-Corporate no admite.