Tài liệu

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.

Base URL (OpenAI)https://ai.geraikita.com/v1

Base URL (Anthropic)https://ai.geraikita.com

Xác thựcBearer gk-... (hoặc x-api-key: gk-...)

Quan trọng — đừng viết /v1 hai lần.

OpenAIhttps://ai.geraikita.com/v1Client OpenAI tự thêm /chat/completions vào base URL — nên base kết thúc bằng /v1.

Anthropic / Claude Code CLIhttps://ai.geraikita.comClient Anthropic (Claude Code CLI, SDK Anthropic) tự thêm /v1/messages — nên base không có /v1.

Viết sai thì path thành /v1/v1/messages → lỗi 400.

Gói miễn phí (Bansos) dùng KHÓA RIÊNG — không phải khóa trả phí.

Khóa bansos phải được nhận trước tại trang Bansos (đăng nhập + xác minh Telegram, miễn phí, 1 lần mỗi tài khoản). Khóa trả phí gk- từ Dashboard không dùng được ở endpoint bansos, và ngược lại — nhầm lẫn sẽ nhận 401 unauthorized.

Base URL của bansos cũng khác với bản trả phí ở trên:

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 tự thêm /v1/messages → https://ai.geraikita.com/v1/claude/v1/messages.

Khám phá modelGET https://ai.geraikita.com/v1/claude/models

Phần còn lại giống hệt endpoint trả phí.

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

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

Công cụ tự khám phá model? Endpoint GET https://ai.geraikita.com/v1/models có sẵn. Nếu có ô "Gateway base URL" tự thêm /v1/models, hãy điền https://ai.geraikita.com (root) để không thành /v1/v1/models.

GeraiPoints

1 GP = 1 Rp. Bạn bị tính phí theo token từ usage thực của mỗi request — không có phí cố định theo request, chỉ có mức tối thiểu nhỏ mỗi request cho từng model (sàn). Nạp GeraiPoints trong dashboard; số dư không hết hạn và dùng được cho mọi model. Không có gói thuê bao hay hạn mức tháng.

Danh sách model

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

Viết tên model CHÍNH XÁC như trong danh sách — không có tiền tố. Gửi claude-sonnet-5, không phải gp/claude-sonnet-5 hay openai/claude-sonnet-5. Một số client/CLI tự thêm tên provider vào trước model (vd. profile tên gp → model thành gp/claude-sonnet-5) → kết quả là 404 model không xác định. Tiền tố gk- dành cho API key (header Authorization), không phải tên model.

Tạo API key

Mở Dashboard → Tạo API key, đặt tên và (tùy chọn) giới hạn cho các model nhất định. Key gốc chỉ hiển thị một lần. Tối đa 5 key hoạt động mỗi tài khoản — thu hồi key cũ để tạo key mới.

Mã lỗi

Mã	Ý nghĩa
400	Base URL / body sai — kiểm tra không có /v1 lặp (vd. /v1/v1/messages)
401	API key không hợp lệ / nhầm luồng — key trả phí ≠ key bansos. Kiểm tra base URL: trả phí dùng /v1, bansos dùng /v1/claude
402	GeraiPoints không đủ — vui lòng nạp thêm
403	Model không được phép với key này
404	Model không xác định — gửi TÊN MODEL CHÍNH XÁC (vd. claude-sonnet-5), không tiền tố. Tên như gp/claude-sonnet-5 hay openai/... sẽ bị 404
429	Quá nhiều request