API INTEGRATION
API 接入
KeyGo 提供 OpenAI 兼容入口,并兼容 Claude Code 使用的 Anthropic 格式。新配置统一使用根地址作为 Base URL。
基础配置
| 配置项 | 值 | 说明 |
|---|---|---|
| Base URL | https://keygo.vip | OpenAI 兼容客户端和 Claude Code 都优先填写这个地址。 |
| 鉴权 | Authorization: Bearer YOUR_KEYGO_API_KEY | 密钥来自控制台 API Key 页面。 |
| 内容类型 | application/json | 普通 JSON 请求使用该类型。 |
| 兼容地址 | https://keygo.vip/v1 | 保留给已经配置好的老软件,不建议新软件继续使用。 |
OpenAI 兼容路径
当 Base URL 填写 https://keygo.vip 时,常见 OpenAI 兼容路径如下:
| 能力 | 请求路径 | 说明 |
|---|---|---|
| 聊天补全 | /chat/completions | 适用于大多数 OpenAI 兼容聊天客户端。 |
| Responses | /responses | 适用于支持 Responses 格式的软件或 SDK。 |
| 模型列表 | /models | 用于客户端拉取可用模型。 |
Python 示例
from openai import OpenAI
client = OpenAI(
api_key="YOUR_KEYGO_API_KEY",
base_url="https://keygo.vip",
)
response = client.chat.completions.create(
model="YOUR_MODEL_NAME",
messages=[
{"role": "user", "content": "你好,请用一句话介绍 KeyGo。"}
],
)
print(response.choices[0].message.content)
Node.js 示例
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.KEYGO_API_KEY,
baseURL: "https://keygo.vip",
});
const response = await client.chat.completions.create({
model: "YOUR_MODEL_NAME",
messages: [
{ role: "user", content: "你好,请用一句话介绍 KeyGo。" },
],
});
console.log(response.choices[0].message.content);
curl 示例
curl https://keygo.vip/chat/completions \
-H "Authorization: Bearer YOUR_KEYGO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_NAME",
"messages": [
{"role": "user", "content": "你好"}
]
}'
Claude Code 相关说明
Claude Code 使用 Anthropic 格式。配置软件时填写 Base URL 为 https://keygo.vip,不要手动拼接接口路径。Claude Code 会根据自身协议请求对应路径。
export ANTHROPIC_BASE_URL=https://keygo.vip
export ANTHROPIC_AUTH_TOKEN=YOUR_KEYGO_API_KEY
从 /v1 迁移到根地址
- 新软件统一填写
https://keygo.vip。 - 已经稳定运行的老配置可以暂时保留
https://keygo.vip/v1。 - 迁移时先复制一份新密钥进行测试,确认成功后再切换正式任务。
- 不要把
/v1写两次,例如https://keygo.vip/v1/v1。
生产环境建议
- 每个软件或服务单独创建 API Key,方便限流、停用和排查。
- 请求超时、网络错误、429 和 5xx 应加入有限次数指数退避重试。
- 不要无限重试非幂等任务,避免重复扣费或重复执行。
- 上线后定期检查余额、用量明细、错误日志和模型可用状态。