快速开始
三步从零到第一个回答：设置 base URL、创建 API 密钥、发送请求。
Base URL
OpenAI 格式客户端使用以 /v1 结尾的 base URL。Anthropic 格式客户端使用不含 /v1 的根地址，因为其 SDK 会自行追加 /v1/messages。
| 设置项 | 值 | 使用者 |
|---|---|---|
| base_url | https://ai.geraikita.com/v1 | OpenAI SDK、Cline/Roo（OpenAI Compatible）、OpenCode、n8n、Continue |
| base_url | https://ai.geraikita.com | Anthropic SDK、Claude Code CLI、Cline（Anthropic） |
| api_key | gk-… | 所有客户端——密钥在 Dashboard 中创建 |
创建 API 密钥
- 登录 Geraikita AI。
- 在充值页面充值 GeraiPoints（或在 Bansos 领取免费密钥）。
- 打开 Dashboard → 创建 API 密钥。复制
gk-…密钥——原始密钥只显示一次。
把密钥保存在环境变量中，例如
export GERAIKITA_API_KEY=gk-…，不要直接写进代码。第一个请求
选择你使用的语言或 SDK。所有示例都调用 claude-sonnet-5 模型；可替换为模型列表中的其他模型 id。
bash
curl https://ai.geraikita.com/v1/chat/completions \
-H "Authorization: Bearer gk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "你好！"}]
}'响应为 JSON，格式与 OpenAI API 相同（使用 /v1/messages 时则与 Anthropic 相同），包含记录计费 token 数的 usage 对象。
流式输出回答
对于长回答和 Agentic 工具，请开启 stream，让回答片段即时流出。服务器会立即发送响应头，并在等待第一个 token 时发送 keepalive 信号。请将应用的 timeout 设为至少 300 秒。
bash
curl https://ai.geraikita.com/v1/chat/completions -N \
-H "Authorization: Bearer gk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"stream": true,
"messages": [{"role": "user", "content": "你好！"}]
}'下一步
- 在 Claude Code、Cline、OpenCode 等工具中配置：工具集成。
- 使用 Agentic 工具？发送大型 prompt 前请先阅读Agentic 工具设置。
- 查看可用的模型 id：模型。
- 正确处理错误：限制与错误代码。