Schnellstart
Von null zur ersten Antwort in drei Schritten: Base-URL festlegen, API-Key erstellen, Request senden.
Base-URL
Clients im OpenAI-Format nutzen eine Base-URL, die auf /v1 endet. Clients im Anthropic-Format nutzen die Root ohne /v1, weil ihr SDK /v1/messages selbst anhängt.
| Einstellung | Wert | Genutzt von |
|---|---|---|
| base_url | https://ai.geraikita.com/v1 | OpenAI SDK, Cline/Roo (OpenAI Compatible), OpenCode, n8n, Continue |
| base_url | https://ai.geraikita.com | Anthropic SDK, Claude Code CLI, Cline (Anthropic) |
| api_key | gk-… | Alle Clients — Keys werden im Dashboard erstellt |
API-Key erstellen
- Melde dich bei Geraikita AI an.
- Lade GeraiPoints auf der Seite Aufladen auf (oder hol dir einen Gratis-Key bei Bansos).
- Öffne das Dashboard → API-Key erstellen. Kopiere den Key
gk-…— der Roh-Key wird nur einmal angezeigt.
export GERAIKITA_API_KEY=gk-…, statt ihn direkt in den Code zu schreiben.Erster Request
Wähle deine Sprache oder dein SDK. Alle Beispiele rufen das Modell claude-sonnet-5 auf; ersetze es durch eine andere Modell-ID aus der Modellliste.
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": "Hallo!"}]
}'Die Antwort ist JSON im selben Format wie die OpenAI-API (bzw. Anthropic bei /v1/messages), inklusive eines usage-Objekts mit der Anzahl abgerechneter Tokens.
Antwort streamen
Für lange Antworten und Agentic-Tools aktiviere stream, damit Teile der Antwort sofort ankommen. Der Server sendet die Header sofort und Keepalive-Signale, während er auf das erste Token wartet. Stelle den Timeout deiner App auf mindestens 300 Sekunden.
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": "Hallo!"}]
}'Nächste Schritte
- Einrichtung in Claude Code, Cline, OpenCode und anderen Tools: Tool-Integrationen.
- Nutzt du ein Agentic-Tool? Lies die Agentic-Tool-Einstellungen, bevor du große Prompts sendest.
- Verfügbare Modell-IDs ansehen: Modelle.
- Fehler richtig behandeln: Limits & Fehlercodes.