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)

Python
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)

Node.js
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
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)

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)

环境变量方式

bash
# 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
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。

下一步