两分钟即可上手。

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

认证

每个请求都要在 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 与其他工具

OpenCode

OpenCode 从配置文件读取 provider。在 ~/.config/opencode/opencode.json（或项目里的 opencode.json）中把 Geraikita 注册为 OpenAI 兼容 provider。

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

然后导出你的 key 并启动 OpenCode，用 /models 选择模型——它会显示为 geraikita/claude-sonnet-5。

export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode

重要：models 下面的键会原样发给 API，因此必须与 Geraikita 的公开模型 id 完全一致。

提醒：模型名称要与价格页上完全一致——不要加任何前缀。

9router

9router 是一个本地代理，把请求分发给多家 provider，监听在 http://localhost:20128。你不用让工具直接指向 Geraikita——而是把 Geraikita 注册为 9router 的上游 provider 之一。

1. 打开 9router 控制台 http://localhost:20128/dashboard。
2. 进入 Providers，添加一个 custom OpenAI-compatible 端点：Base URL https://ai.geraikita.com/v1，API key gk-xxxxxxxx。
3. 你的编码工具依旧指向 9router（http://localhost:20128/v1），只要选一个 Geraikita 的模型，9router 就会把这些请求转发到 Geraikita。

# 工具仍然指向 9router，而不是直连 Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

这样你既保留 9router 跨 provider 的路由与兜底，token 又是从 Geraikita 的 GeraiPoints 里扣。

提醒：模型名称要与价格页上完全一致——不要加任何前缀。

Hermes

Hermes（NousResearch 的 Hermes Agent）可以对接任何 OpenAI 兼容端点。在 ~/.hermes/config.yaml 里把它指向 Geraikita。

model:
  default: claude-sonnet-5
  provider: custom
  base_url: https://ai.geraikita.com/v1
  api_key: gk-xxxxxxxx   # 或放进 ~/.hermes/.env

或者运行 hermes model，选择 Custom OpenAI-compatible endpoint，然后填入 base URL 和 key——Hermes 会通过 GET https://ai.geraikita.com/v1/models 自动发现可用模型。

提醒：模型名称要与价格页上完全一致——不要加任何前缀。

GeraiPoints

模型列表

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

创建 API 密钥

错误代码