文档

两分钟即可上手。

Geraikita AI API 同时支持两种格式：OpenAI Chat Completions 和 Anthropic Messages。可直接使用 OpenAI SDK、Anthropic SDK、Claude Code CLI、Cline 等工具——只需更换 base URL 和 API 密钥。

Base URL（OpenAI）https://ai.geraikita.com/v1

Base URL（Anthropic）https://ai.geraikita.com

认证Bearer gk-...（或 x-api-key: gk-...）

重要——不要把 /v1 写两遍。

OpenAIhttps://ai.geraikita.com/v1OpenAI 客户端会在 base URL 后追加 /chat/completions——所以 base 以 /v1 结尾。

Anthropic / Claude Code CLIhttps://ai.geraikita.comAnthropic 客户端（Claude Code CLI、Anthropic SDK）会自行追加 /v1/messages——所以 base 不含 /v1。

写错的话路径会变成 /v1/v1/messages → 400 错误。

免费套餐（Bansos）使用独立密钥——不是付费密钥。

Bansos 密钥必须先在Bansos 页面领取（登录 + Telegram 验证，免费，每个账号一次）。Dashboard 的付费 gk- 密钥在 bansos 端点无效，反之亦然——用错会得到 401 unauthorized。

Bansos 的 base URL 也与上面的付费版不同：

Bansos Base URLhttps://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 会自行追加 /v1/messages → https://ai.geraikita.com/v1/claude/v1/messages。

模型发现GET https://ai.geraikita.com/v1/claude/models

其余部分与付费端点完全相同。

认证

每个请求都要在 Authorization: Bearer gk-... 请求头中携带你的 gk- API 密钥。密钥在 dashboard 创建，且只在创建时显示一次——请妥善保存。你可以把每个密钥限制到特定模型（白名单）。

第一个请求

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 使用 Anthropic 格式。把 base URL 设为根地址（https://ai.geraikita.com——不含 /v1），然后运行 claude。使用模型 claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5。

# Base URL = 根地址，不含 /v1（Claude Code 会自行追加 /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 与其他工具

Cline / Roo（OpenAI Compatible）：provider 选 OpenAI Compatible，Base URL https://ai.geraikita.com/v1，API 密钥 gk-...，Model ID claude-sonnet-5。

Cline（Anthropic）：provider 选 Anthropic，Base URL https://ai.geraikita.com，API 密钥 gk-...。

工具支持自动发现模型？GET https://ai.geraikita.com/v1/models 端点可用。如果有会自动追加 /v1/models 的「Gateway base URL」输入框，请填 https://ai.geraikita.com（根地址），以免变成 /v1/v1/models。

GeraiPoints

1 GP = 1 印尼盾。按每个请求的真实用量逐 token 计费——没有固定的按请求收费，只有每个模型的小额单请求最低消费（下限）。在 dashboard 充值 GeraiPoints；余额永不过期，可用于任何模型。没有订阅，也没有月度配额。

模型列表

可发送的 model 取值。各模型价格见价格页。

模型名必须与列表完全一致——不要加前缀。 发送 claude-sonnet-5，而不是 gp/claude-sonnet-5 或 openai/claude-sonnet-5。有些客户端/CLI 会在模型名前加 provider 名（例如名为 gp 的 profile → 模型变成 gp/claude-sonnet-5）→ 结果是 404 未知模型。gk- 前缀是给 API 密钥用的（Authorization 请求头），不是模型名。

创建 API 密钥

打开 Dashboard → 创建 API 密钥，起个名字，并可选地限制到特定模型。原始密钥只显示一次。每个账号最多 5 个有效密钥——先吊销旧的再创建新的。

错误代码

状态码	含义
400	Base URL / 请求体错误——检查是否有重复的 /v1（如 /v1/v1/messages）
401	API 密钥无效 / 用错通道——付费密钥 ≠ bansos 密钥。检查 base URL：付费用 /v1，bansos 用 /v1/claude
402	GeraiPoints 余额不足——请充值
403	此密钥不允许使用该模型
404	未知模型——请发送完全一致的模型名（如 claude-sonnet-5），不带前缀。gp/claude-sonnet-5 或 openai/... 之类的名称会返回 404
429	请求过于频繁