Ir al contenido principal

Codificar con llaves de API

Con una clave de Coderen API 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 se encuentra?
API-keyLa obtienes de un administrador
Endpointhttps://europe-west1-ai-corporate.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 aic.. Trata esta clave como una contraseña.

¿Qué herramienta elegir?​

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

Aider es técnicamente compatible con un endpoint compatible con OpenAI, pero no se recomienda como herramienta predeterminada en entornos corporativos.

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

Seguridad al manejar llaves​

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

Utiliza preferentemente:

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

Nunca coloques llaves 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 no se ha agotado
  • si la clave está dentro del periodo de validez configurado
  • si estás usando un modelo permitido
  • si el endpoint está configurado correctamente

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

Variables de entorno y OpenCode​

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

AI_SCHOOL_CODEREN_API_KEY=ais.tu-llave-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-llave-api"

Si ves Authorization header con Bearer token es obligatorio, 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.

WhatsApp