KKeyGo 文档

API INTEGRATION

API 接入

KeyGo 提供 OpenAI 兼容入口,并兼容 Claude Code 使用的 Anthropic 格式。新配置统一使用根地址作为 Base URL。

基础配置

配置项值说明
Base URLhttps://keygo.vipOpenAI 兼容客户端和 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 迁移到根地址

  1. 新软件统一填写 https://keygo.vip。
  2. 已经稳定运行的老配置可以暂时保留 https://keygo.vip/v1。
  3. 迁移时先复制一份新密钥进行测试,确认成功后再切换正式任务。
  4. 不要把 /v1 写两次,例如 https://keygo.vip/v1/v1。

生产环境建议