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 + verifikasi Telegram, gratis, 1× 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

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.

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.

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

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