5 分钟完成接入
本文说明如何把现有 OpenAI 或 Anthropic SDK 的请求地址切换到 KL API,代码改动不超过两行:换 API Key、换 base_url。附 Python、Node.js、curl 示例与 401 / 429 / 超时排查(2026-11-21 更新)。
第 1 步:获取 API Key
在 KL API 控制台 注册并登录,进入「令牌」页面创建一个 API Key。Key 只显示一次,请妥善保存,不要提交到代码仓库。
第 2 步:替换 base_url
OpenAI 协议地址:https://agent.kl-api.info/v1
Anthropic 协议地址:https://agent.kl-api.info(不带 /v1,SDK 会自动拼接)
Python(OpenAI SDK)
from openai import OpenAI
client = OpenAI(
api_key="YOUR_KEY",
base_url="https://agent.kl-api.info/v1", # 只改这一行
)
resp = client.chat.completions.create(
model="gpt-5-mini",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)Node.js(OpenAI SDK)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.KL_API_KEY,
baseURL: "https://agent.kl-api.info/v1", // 只改这一行
});
const resp = await client.chat.completions.create({
model: "gpt-5-mini",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);curl
curl https://agent.kl-api.info/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-5-mini", "messages": [{"role": "user", "content": "你好"}]}'Python(Anthropic SDK)
import anthropic
client = anthropic.Anthropic(
api_key="YOUR_KEY",
base_url="https://agent.kl-api.info", # 注意:Anthropic SDK 不带 /v1
)
msg = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)环境变量方式
# Claude Code 等读取环境变量的工具
export ANTHROPIC_BASE_URL="https://agent.kl-api.info"
export ANTHROPIC_AUTH_TOKEN="YOUR_KEY"
# 读取 OpenAI 环境变量的工具
export OPENAI_BASE_URL="https://agent.kl-api.info/v1"
export OPENAI_API_KEY="YOUR_KEY"第 3 步:验证
运行下面的命令,能列出模型即说明 Key 和地址都配置正确:
curl https://agent.kl-api.info/v1/models -H "Authorization: Bearer YOUR_KEY"期望输出(节选):
{
"object": "list",
"data": [
{ "id": "gpt-5-mini", "object": "model", ... },
...
]
}报错排查
401 Unauthorized
原因:API Key 错误、已删除或已过期;或请求头格式不对。
解法:确认请求头为 Authorization: Bearer YOUR_KEY(Anthropic SDK 会自动使用 x-api-key);在控制台检查 Key 状态与余额;确认没有把 Key 前后的空格一起复制。
429 Too Many Requests
原因:请求频率超过限制,或上游模型临时繁忙。
解法:降低并发,使用指数退避重试(如 1s、2s、4s);OpenAI 与 Anthropic 官方 SDK 默认带重试,可调大 max_retries。
连接超时 / Connection error
原因:base_url 写错(多了或少了 /v1)、本地代理拦截,或长输出请求超过了客户端默认超时。
解法:OpenAI SDK 用 https://agent.kl-api.info/v1,Anthropic SDK 用 https://agent.kl-api.info;检查本机代理设置;长输出任务开启流式(stream=True)或调大 timeout。