Bắt đầu trong 2 phút.

API Geraikita AI hỗ trợ hai định dạng cùng lúc: OpenAI Chat Completions và Anthropic Messages. Dùng SDK OpenAI, Anthropic, Claude Code CLI, Cline và các công cụ khác — chỉ cần đổi base URL và API key.

Xác thực

Mỗi request mang API key gk- của bạn trong header Authorization: Bearer gk-.... Key được tạo trong dashboard và chỉ hiển thị một lần khi tạo — hãy lưu cẩn thận. Bạn có thể giới hạn mỗi key cho các model nhất định (allowlist).

Request đầu tiên

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 dùng định dạng Anthropic. Đặt base URL là root (https://ai.geraikita.com — không có /v1), rồi chạy claude. Dùng model claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base URL = ROOT không có /v1 (Claude Code tự thêm /v1/messages)
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 & công cụ khác

OpenCode

OpenCode đọc danh sách provider từ file cấu hình. Khai báo Geraikita như một provider OpenAI-compatible trong ~/.config/opencode/opencode.json, hoặc trong opencode.json của project.

{
  "$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" }
      }
    }
  }
}

Sau đó export key và mở OpenCode. Chọn model bằng /models — nó hiện ra là geraikita/claude-sonnet-5.

export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode

Quan trọng: các key bên dưới models được gửi thẳng tới API, nên phải trùng khớp tuyệt đối với id model công khai của Geraikita.

Nhớ nhé: viết tên model ĐÚNG như trên trang giá — không thêm prefix.

9router

9router là proxy chạy cục bộ, phân phối request tới nhiều provider và lắng nghe ở http://localhost:20128. Bạn không trỏ tool trực tiếp vào Geraikita — bạn đăng ký Geraikita như một provider upstream của 9router.

1. Mở dashboard 9router tại http://localhost:20128/dashboard.
2. Vào Providers và thêm endpoint custom OpenAI-compatible: Base URL https://ai.geraikita.com/v1, API key gk-xxxxxxxx.
3. Các tool coding vẫn trỏ vào 9router (http://localhost:20128/v1), chỉ cần chọn model Geraikita — 9router sẽ chuyển tiếp request sang Geraikita.

# tool của bạn vẫn trỏ vào 9router, không trỏ thẳng vào Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

Nhờ vậy bạn vẫn có routing và fallback giữa nhiều provider của 9router, còn token thì trả bằng GeraiPoints Geraikita của bạn.

Nhớ nhé: viết tên model ĐÚNG như trên trang giá — không thêm prefix.

Hermes

Hermes (Hermes Agent của NousResearch) dùng được với mọi endpoint OpenAI-compatible. Trỏ nó về Geraikita trong ~/.hermes/config.yaml.

model:
  default: claude-sonnet-5
  provider: custom
  base_url: https://ai.geraikita.com/v1
  api_key: gk-xxxxxxxx   # hoặc đặt trong ~/.hermes/.env

Hoặc chạy hermes model, chọn Custom OpenAI-compatible endpoint, rồi nhập base URL và key — Hermes tự dò các model khả dụng qua GET https://ai.geraikita.com/v1/models.

Nhớ nhé: viết tên model ĐÚNG như trên trang giá — không thêm prefix.

GeraiPoints

Danh sách model

Các giá trị model bạn có thể gửi. Xem trang giá để biết giá từng model.

Tạo API key

Mã lỗi