GeraikitaGeraikita AI
MenuAutenticazione

Autenticazione

Ogni richiesta è autenticata con la tua chiave API che inizia con gk-. Il costo viene scalato dal saldo GeraiPoints dell’account a cui appartiene la chiave.

Inviare la chiave API

Invia la chiave in uno dei seguenti header. Entrambi valgono su tutti gli endpoint a pagamento.

HeaderFormatoNote
AuthorizationBearer gk-…Predefinito nei client in formato OpenAI (https://ai.geraikita.com/v1).
x-api-keygk-…Predefinito nei client in formato Anthropic (https://ai.geraikita.com).
anthropic-version2023-06-01Inviato automaticamente dall’SDK Anthropic; includilo se chiami /v1/messages direttamente.
HTTP headers
# OpenAI
Authorization: Bearer gk-xxxxxxxx

# Anthropic
x-api-key: gk-xxxxxxxx
anthropic-version: 2023-06-01

Se la chiave manca, è errata o è stata revocata, il server risponde 401 con type authentication_error:

401 Unauthorized
{
  "error": {
    "message": "API key tidak valid atau tidak dikenali. Pastikan key gk- kamu benar.",
    "type": "authentication_error",
    "code": null
  }
}

Creare e revocare le chiavi

  1. Apri la Dashboard e scegli Crea API key.
  2. Dai un nome che ne descriva l’uso (ad es. laptop-kantor o server-produksi) e, se serve, scegli i modelli consentiti.
  3. Copia la chiave e conservala in un luogo sicuro. Per revocarla, premi Revoca nell’elenco delle chiavi: le richieste con quella chiave vengono rifiutate subito.
La chiave in chiaro viene mostrata una sola volta alla creazione e non è più visibile. Massimo 20 chiavi attive per account: revoca una chiave vecchia per crearne una nuova.

Limitare una chiave a modelli specifici

Ogni chiave può essere limitata a un elenco di modelli specifici (allowlist). Un elenco vuoto significa che tutti i modelli sono consentiti. Le richieste a modelli fuori elenco ricevono 403 permission_error, e GET /v1/models con quella chiave mostra solo i modelli consentiti. Usalo per le chiavi condivise con app o team, così tieni sotto controllo la spesa.

Tipi di chiave

ChiaveUsoBase URL
gk-API a pagamento — scalata dai GeraiPoints. Si crea nella Dashboard.https://ai.geraikita.com/v1
gk- (bansos)Piano gratuito — quota giornaliera, endpoint separato. Vedi Piano gratuito (Bansos). Non funziona sugli endpoint a pagamento, e viceversa.https://ai.geraikita.com/v1/claude
gkr-Programma reseller — gestito nella pagina Reseller.—

Tenere al sicuro la chiave

  • Non inserire la chiave nel codice front-end (browser, app mobili). Chiama l’API dal tuo server.
  • Conserva la chiave in variabili d’ambiente o in un secret manager, e non farne mai il commit in un repository.
  • Usa una chiave per ogni app o dispositivo, così l’uso è facile da tracciare e puoi revocare una chiave senza toccare le altre.
  • Sospetti una fuga della chiave? Revocala subito nella Dashboard e creane una nuova.