把 OpenAI 或 Anthropic SDK 接到 Thklumi

已经在用 OpenAI 或 Claude?接入 Thklumi 通常只动两处:把 base_url 指向本站,把 api_key 换成控制台里 sk- 开头的密钥。模型名沿用模型页上的别名,例如 deepseek-v4-flash、gpt-5.5、claude-sonnet-4-6。

所有请求发往同一站点,并在请求头带上密钥。我们同时提供两套主流协议:OpenAI 兼容(Bearer 鉴权)与 Anthropic 原生(x-api-key 鉴权),按你手里的 SDK 选一套即可,业务代码几乎不用改。

这是最推荐的接入方式。把 OpenAI SDK 的 base_url 指向 Thklumi，model 填模型别名，messages 按 OpenAI 原格式传入即可。下面给出 Python、Node.js、cURL 三种写法。

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://api.thklumi.com/v1",
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "user", "content": "用一句话介绍你自己"}
    ],
)

print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的密钥",
  baseURL: "https://api.thklumi.com/v1",
});

const response = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [
    { role: "user", content: "用一句话介绍你自己" },
  ],
});

console.log(response.choices[0].message.content);

curl https://api.thklumi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ]
  }'

如果希望像 ChatGPT 一样边生成边显示，把 stream 设为 true。服务端返回标准 SSE 数据流（data: {...} 分片，以 data: [DONE] 结束），按 chunk 逐段读取即可。

stream = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "写一个三步上线检查清单"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

curl https://api.thklumi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "stream": true,
    "messages": [
      {"role": "user", "content": "写一首五言绝句"}
    ]
  }'

Responses 是 OpenAI 新接口。Thklumi 会优先调用上游原生 Responses；如果上游暂不支持，会自动转换到 chat.completions，再把结果包装回 Responses 格式。

response = client.responses.create(
    model="gpt-5.5",
    input="请用三句话解释什么是 API 网关",
)

print(response.output_text)

除 OpenAI 兼容格式外，我们还提供 Anthropic 原生 Messages 接口(/v1/messages)。anthropic 官方 SDK、Claude Code 无需改代码,只要把 Base URL 指向本站、密钥用 sk- 开头即可;鉴权走 x-api-key(也兼容 Authorization: Bearer),model 填 claude-* 别名。网关会在内部把 Anthropic 请求与流式事件与上游 OpenAI 渠道互相转换。

curl https://api.thklumi.com/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ]
  }'

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-你的密钥",
    base_url="https://api.thklumi.com",
)

resp = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)

print(resp.content[0].text)

export ANTHROPIC_BASE_URL="https://api.thklumi.com"
export ANTHROPIC_API_KEY="sk-你的密钥"

两个接口都跑在同一个 Base URL 上，按项目情况选择即可：老项目继续用 chat.completions，新项目也可以用 responses.create。

用下面的接口实时拉取当前账号可调用的完整模型列表；请求时 model 字段直接填返回里的 id（全小写）。也可以在模型页查看别名、价格与能力。

curl https://api.thklumi.com/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

Codex、Cline、Cherry Studio 等支持 OpenAI 协议的客户端，只需把 Base URL 和 API Key 指向 Thklumi，无需改动工具本身。设置以下环境变量即可：

export OPENAI_BASE_URL="https://api.thklumi.com/v1"
export OPENAI_API_KEY="sk-你的密钥"

凡是支持自定义 OpenAI Base URL 的客户端都可这样接入。如果工具是在界面里填写，把「API 地址 / Base URL」填 https://api.thklumi.com/v1，「密钥」填 sk- 开头的 Key 即可。