Mulai dalam 2 menit.
API Geraikita AI mendukung dua format sekaligus: OpenAI Chat Completions dan Anthropic Messages. Pakai SDK OpenAI, Anthropic, Claude Code CLI, Cline, dan tool lain — cukup ganti base URL dan API key.
https://ai.geraikita.com/v1https://ai.geraikita.comBearer gk-... (atau x-api-key: gk-...)https://ai.geraikita.com/v1Klien OpenAI menambah /chat/completions ke base URL — jadi base-nya berakhiran /v1.https://ai.geraikita.comKlien Anthropic (Claude Code CLI, SDK Anthropic) menambah /v1/messages sendiri — jadi base-nya tanpa /v1.Kalau keliru, path jadi /v1/v1/messages → error 400.
Key bansos wajib diklaim dulu di halaman Bansos (login + WhatsApp terverifikasi + gabung channel & grup Telegram, gratis, 1 key per akun). Key berbayar gk- dari Dashboard tidak berlaku di endpoint bansos, dan sebaliknya — kalau ketuker hasilnya 401 unauthorized.
Base URL bansos juga berbeda dari yang berbayar di atas:
https://ai.geraikita.com/v1/claudehttps://ai.geraikita.com/v1/claude/chat/completionsANTHROPIC_BASE_URL=https://ai.geraikita.com/v1/claudeSDK menambah /v1/messages sendiri → https://ai.geraikita.com/v1/claude/v1/messages.GET https://ai.geraikita.com/v1/claude/modelsModel gratis: deepseek-v4-flash, glm-5.3-flash, qwen3.8-flash, qwen3.8-max. Model lain dibalas 404; daftar terkini ada di GET /models.
Selebihnya sama persis dengan endpoint berbayar.
Autentikasi
Setiap permintaan membawa API key gk- milikmu di header Authorization: Bearer gk-.... Key dibuat di dashboard dan hanya ditampilkan sekali saat dibuat — simpan baik-baik. Kamu bisa membatasi tiap key ke model tertentu (allowlist).
Permintaan pertama
from openai import OpenAI
client = OpenAI(
base_url="https://ai.geraikita.com/v1",
api_key="gk-xxxxxxxx",
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Halo!"}],
)
print(resp.choices[0].message.content)Claude Code CLI
Claude Code memakai format Anthropic. Set base URL ke root (https://ai.geraikita.com — tanpa /v1), lalu jalankan claude. Gunakan model claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.
# Base URL = ROOT tanpa /v1 (Claude Code menambah /v1/messages sendiri)
export ANTHROPIC_BASE_URL="https://ai.geraikita.com"
export ANTHROPIC_AUTH_TOKEN="gk-xxxxxxxx"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
claudeCline & tool lain
Cline / Roo (OpenAI Compatible): provider OpenAI Compatible, Base URL https://ai.geraikita.com/v1, API key gk-..., Model ID claude-sonnet-5.
Cline (Anthropic): provider Anthropic, Base URL https://ai.geraikita.com, API key gk-....
Tool auto-discovery model? Endpoint GET https://ai.geraikita.com/v1/models tersedia. Kalau ada kolom "Gateway base URL" yang otomatis menambah /v1/models, isi dengan https://ai.geraikita.com (root) agar tidak jadi /v1/v1/models.
OpenCode
OpenCode membaca daftar provider dari berkas konfigurasi. Daftarkan Geraikita sebagai provider OpenAI-compatible di ~/.config/opencode/opencode.json, atau di opencode.json milik proyek.
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"geraikita": {
"npm": "@ai-sdk/openai-compatible",
"name": "Geraikita AI",
"options": {
"baseURL": "https://ai.geraikita.com/v1",
"apiKey": "{env:GERAIKITA_API_KEY}"
},
"models": {
"claude-sonnet-5": { "name": "Claude Sonnet 5" },
"gpt-5.6-sol": { "name": "GPT 5.6 Sol" },
"deepseek-v4-pro": { "name": "DeepSeek V4 Pro" }
}
}
}
}Lalu ekspor key kamu dan jalankan OpenCode. Pilih modelnya lewat /models — namanya muncul sebagai geraikita/claude-sonnet-5.
export GERAIKITA_API_KEY=gk-xxxxxxxx
opencodePenting: kunci di bawah models dikirim apa adanya ke API, jadi harus sama persis dengan id publik model Geraikita.
Ingat: tulis nama model PERSIS seperti di halaman harga — tanpa prefix.
9router
9router adalah proxy lokal yang menyebar permintaan ke banyak provider dan berjalan di http://localhost:20128. Tool kamu tidak diarahkan langsung ke Geraikita — Geraikita didaftarkan sebagai salah satu provider upstream 9router.
- Buka dashboard 9router di http://localhost:20128/dashboard.
- Masuk ke Providers lalu tambahkan endpoint custom OpenAI-compatible: Base URL https://ai.geraikita.com/v1, API key gk-xxxxxxxx.
- Tool coding kamu tetap menunjuk 9router (http://localhost:20128/v1), cukup pilih model Geraikita — 9router yang meneruskan permintaannya ke Geraikita.
http://localhost:20128/dashboardhttps://ai.geraikita.com/v1gk-xxxxxxxxhttp://localhost:20128/v1# tool kamu tetap menunjuk 9router, bukan langsung ke Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"Dengan begini kamu tetap dapat routing & fallback antar provider dari 9router, sementara tokennya dibayar dari GeraiPoints Geraikita kamu.
Ingat: tulis nama model PERSIS seperti di halaman harga — tanpa prefix.
Hermes
Hermes (Hermes Agent dari NousResearch) bisa dipakai dengan endpoint OpenAI-compatible mana pun. Arahkan ke Geraikita lewat ~/.hermes/config.yaml.
model:
default: claude-sonnet-5
provider: custom
base_url: https://ai.geraikita.com/v1
api_key: gk-xxxxxxxx # atau taruh di ~/.hermes/.envAtau jalankan hermes model, pilih Custom OpenAI-compatible endpoint, lalu isi base URL dan key-nya — Hermes mendeteksi sendiri model yang tersedia lewat GET https://ai.geraikita.com/v1/models.
Ingat: tulis nama model PERSIS seperti di halaman harga — tanpa prefix.
GeraiPoints
Daftar model
Nilai model yang bisa kamu kirim. Lihat halaman harga untuk tarif tiap model.
Buat API key
Kode error
| Status | Arti |
|---|---|
| 400 | Base URL / body salah — cek jangan ada /v1 dobel (mis. /v1/v1/messages) |
| 401 | API key tidak valid / ketuker jalur — key berbayar ≠ key bansos. Cek base URL: berbayar pakai /v1, bansos pakai /v1/claude |
| 402 | GeraiPoints tidak cukup — silakan top up |
| 403 | Model tidak diizinkan untuk key ini |
| 404 | Model tidak dikenal — kirim NAMA MODEL PERSIS (mis. claude-sonnet-5), tanpa prefix. Nama seperti gp/claude-sonnet-5 atau openai/... akan 404 |
| 429 | Terlalu banyak permintaan |