GeraikitaGeraikita AI
MenuAvvio rapido

Avvio rapido

Da zero alla prima risposta in tre passaggi: prepara la base URL, crea una chiave API e invia la richiesta.

Base URL

I client in formato OpenAI usano una base URL che termina con /v1. I client in formato Anthropic usano la radice senza /v1, perché il loro SDK aggiunge /v1/messages da sé.

ImpostazioneValoreUsato da
base_urlhttps://ai.geraikita.com/v1SDK OpenAI, Cline/Roo (OpenAI Compatible), OpenCode, n8n, Continue
base_urlhttps://ai.geraikita.comSDK Anthropic, Claude Code CLI, Cline (Anthropic)
api_keygk-…Tutti i client — la chiave si crea nella Dashboard

Crea una chiave API

  1. Accedi a Geraikita AI.
  2. Ricarica i GeraiPoints nella pagina Ricarica (oppure ottieni una chiave gratuita su Bansos).
  3. Apri la Dashboard → Crea API key. Copia la chiave gk-…: la chiave in chiaro viene mostrata una sola volta.
Salva la chiave in una variabile d’ambiente, ad es. export GERAIKITA_API_KEY=gk-…, invece di scriverla direttamente nel codice.

Prima richiesta

Scegli il linguaggio o l’SDK che usi. Tutti gli esempi chiamano il modello claude-sonnet-5; sostituiscilo con un altro id dall’elenco dei modelli.

curl https://ai.geraikita.com/v1/chat/completions \
  -H "Authorization: Bearer gk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Ciao!"}]
  }'

La risposta è in JSON con lo stesso formato dell’API OpenAI (o Anthropic, se usi /v1/messages), compreso l’oggetto usage con il numero di token fatturati.

Risposta in stream

Per risposte lunghe e strumenti agentici, attiva stream così i frammenti della risposta arrivano subito. Il server invia immediatamente gli header e segnali keepalive mentre attende il primo token. Imposta il timeout della tua app ad almeno 300 secondi.

curl https://ai.geraikita.com/v1/chat/completions -N \
  -H "Authorization: Bearer gk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "stream": true,
    "messages": [{"role": "user", "content": "Ciao!"}]
  }'

Prossimi passi