Dokumentasi

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.

Base URL (OpenAI)https://ai.geraikita.com/v1
Base URL (Anthropic)https://ai.geraikita.com
AutentikasiBearer gk-... (atau x-api-key: gk-...)
Penting — jangan tulis /v1 dua kali.
OpenAIhttps://ai.geraikita.com/v1Klien OpenAI menambah /chat/completions ke base URL — jadi base-nya berakhiran /v1.
Anthropic / Claude Code CLIhttps://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.

Tier gratis (Bansos) memakai KEY TERPISAH — bukan key berbayar.

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:

Base URL bansoshttps://ai.geraikita.com/v1/claude
OpenAIhttps://ai.geraikita.com/v1/claude/chat/completions
Anthropic / Claude Code CLIANTHROPIC_BASE_URL=https://ai.geraikita.com/v1/claudeSDK menambah /v1/messages sendiri → https://ai.geraikita.com/v1/claude/v1/messages.
Discovery modelGET https://ai.geraikita.com/v1/claude/models

Model 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"

claude

Cline & 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.

~/.config/opencode/opencode.json
{
  "$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.

bash
export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode

Penting: 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.

  1. Buka dashboard 9router di http://localhost:20128/dashboard.
  2. Masuk ke Providers lalu tambahkan endpoint custom OpenAI-compatible: Base URL https://ai.geraikita.com/v1, API key gk-xxxxxxxx.
  3. Tool coding kamu tetap menunjuk 9router (http://localhost:20128/v1), cukup pilih model Geraikita — 9router yang meneruskan permintaannya ke Geraikita.
Dashboard 9routerhttp://localhost:20128/dashboard
Base URL providerhttps://ai.geraikita.com/v1
API keygk-xxxxxxxx
Base URL untuk tool kamuhttp://localhost:20128/v1
bash
# 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.

~/.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/.env

Atau 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

1 GP = Rp1. Kamu ditagih per token dari usage nyata tiap request — tanpa biaya per request tetap, hanya ada minimum kecil per request tiap model (lantai). Isi ulang GeraiPoints di dashboard; saldo tidak kadaluarsa dan bisa dipakai untuk model apa pun. Tidak ada langganan atau kuota bulanan.

Daftar model

Nilai model yang bisa kamu kirim. Lihat halaman harga untuk tarif tiap model.

Tulis nama model PERSIS seperti di daftar — tanpa prefix. Kirim claude-sonnet-5, bukan gp/claude-sonnet-5 atau openai/claude-sonnet-5. Beberapa klien/CLI menambah nama provider di depan model (mis. profil bernama gp → model kebaca gp/claude-sonnet-5) → hasilnya 404 model tidak dikenal. Prefix gk- itu untuk API key (header Authorization), bukan untuk nama model.
Tier Token tersedia. Model bersuffix -token (mis. claude-opus-5-token) adalah opsi per-token yang murah — ditagih per token seperti Premium, tapi lewat seller partner. Base URL sama https://ai.geraikita.com/v1, API key sama.

Buat API key

Buka Dashboard → Buat API key, beri nama, dan (opsional) batasi ke model tertentu. Key mentah hanya ditampilkan sekali. Maksimal 5 key aktif per akun — cabut yang lama untuk membuat yang baru.

Kode error

StatusArti
400Base URL / body salah — cek jangan ada /v1 dobel (mis. /v1/v1/messages)
401API key tidak valid / ketuker jalur — key berbayar ≠ key bansos. Cek base URL: berbayar pakai /v1, bansos pakai /v1/claude
402GeraiPoints tidak cukup — silakan top up
403Model tidak diizinkan untuk key ini
404Model tidak dikenal — kirim NAMA MODEL PERSIS (mis. claude-sonnet-5), tanpa prefix. Nama seperti gp/claude-sonnet-5 atau openai/... akan 404
429Terlalu banyak permintaan