Codificare con chiavi API
Con una chiave API di Coderen puoi utilizzare strumenti di coding che funzionano con un API compatibile con OpenAI. Lo strumento invia richieste a AI-Public. AI-Public controlla la chiave, il budget, il periodo di validità e i modelli consentiti.
Poi AI-Public elabora la richiesta tramite l'integrazione tecnica dell'ambiente.
Di cosa hai bisogno?
Hai bisogno di tre dati:
| Dato | Dove trovarlo |
|---|---|
| Chiave API | Puoi ottenerla da un amministratore |
| Endpoint | https://europe-west1-ai-public-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 |
| Nome modello | Ad esempio gpt-5.6-luna, gpt-5.6-terra o gpt-5.6-sol |
La chiave API inizia con aip.. Trattala come una password.
Quale strumento scegliere?
AI-Public consiglia OpenCode per la maggior parte degli utenti. OpenCode è uno strumento di coding agentico per terminale, desktop e IDE. Lo strumento può eseguire autonomamente passaggi, modificare file e approfondire compiti.
Aider è tecnicamente compatibile con un endpoint OpenAI-compatible, ma non è consigliato come strumento standard nelle ambienti Public.
Vedi anche la documentazione ufficiale di OpenCode.
Gestione sicura delle chiavi
Non condividere la tua chiave API pubblicamente e non inserirla nel codice che condividi.
Preferisci utilizzare:
- variabili d'ambiente
- un file
.envlocale che non viene inviato a Git - la configurazione integrata dello strumento
Non inserire mai chiavi API in un repository pubblico, chat, documento condiviso o screenshot.
Se la chiave non funziona
Controlla quindi:
- se Coderen è attivato per l'ambiente
- se la tua chiave è ancora attiva
- se il budget non è esaurito
- se la chiave rientra nel periodo di validità impostato
- se stai usando un modello consentito
- se l'endpoint è impostato correttamente
In caso di dubbi chiedi a un amministratore di controllare la chiave.
Variabili d'ambiente e OpenCode
Per OpenCode puoi salvare la chiave API Coderen in un file locale .env nella cartella del progetto:
AI_SCHOOL_CODEREN_API_KEY=ais.il-tuoi-chiave-api
Assicurati che OpenCode carichi davvero questa variabile d'ambiente. In PowerShell puoi impostare la variabile anche temporaneamente per la sessione corrente:
$env:AI_SCHOOL_CODEREN_API_KEY="ais.il-tuoi-chiave-api"
Se vedi Authorization header with Bearer token is required, significa che lo strumento non include la chiave come Authorization: Bearer .... Se vedi Unknown parameter, rimuovi le impostazioni specifiche del provider che l'endpoint Coderen di AI-Public non supporta.