从 OpenAI 迁移
如果你已经用 OpenAI 或 Anthropic SDK 搭好了集成,迁移到 MyTokenGate 只需改三处:把 base URL 指向 MyTokenGate 网关、换成你的 MyTokenGate API Key、把模型名改成 MyTokenGate 的模型 id。请求和响应格式保持不变,其余代码照常工作。
迁移 OpenAI 集成
网关兼容 OpenAI 协议。继续用你现有的 openai SDK,只改 base URL、Key 和模型。
改动前:
from openai import OpenAI
client = OpenAI(
api_key="sk-your-openai-key",
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)改动后:
from openai import OpenAI
client = OpenAI(
base_url="https://gateway.mytokengate.com/v1",
api_key="tg-your-api-key",
)
response = client.chat.completions.create(
model="gpt-5.4",
messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)SDK 会在 base URL 后面自动拼上 /chat/completions,所以 base URL 只需设为 https://gateway.mytokengate.com/v1,不用再多加。
同一个请求用原始 curl 调用:
curl https://gateway.mytokengate.com/v1/chat/completions \
-H "Authorization: Bearer tg-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"messages": [{"role": "user", "content": "Hello"}]
}'Node.js 同理:给 openai 客户端传 baseURL: "https://gateway.mytokengate.com/v1" 和你的 tg- Key,再改模型名即可。
迁移 Claude / Anthropic 集成
网关同样兼容 Anthropic 协议以支持 Claude 模型。继续用 anthropic SDK,改 base URL、Key 和模型。
改动前:
from anthropic import Anthropic
client = Anthropic(
api_key="sk-ant-your-key",
)
message = client.messages.create(
model="claude-3-5-sonnet-20241022",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello"}],
)
print(message.content[0].text)改动后:
from anthropic import Anthropic
client = Anthropic(
base_url="https://gateway.mytokengate.com/v1",
api_key="tg-your-api-key",
)
message = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello"}],
)
print(message.content[0].text)SDK 会在 base URL 后面自动拼上 /messages,所以 base URL 保持 https://gateway.mytokengate.com/v1。
对于 Claude 模型,建议用上面这种原生 Anthropic 协议,而不是走 OpenAI 风格的接口。原生路径能把扩展思考等特性直接透传,也避免协议转换,兼容性最好。跨协议调用也能用,但原生是推荐的默认做法。
模型名映射
把旧的模型名换成当前的 MyTokenGate id。
| 旧模型 | MyTokenGate id | 协议 |
|---|---|---|
gpt-4o、更早的 GPT | gpt-5.4(日常默认)或 gpt-5.6-sol(旗舰) | OpenAI |
gpt-4o-mini | gpt-5.4-nano | OpenAI |
claude-3-*、claude-*-2025* | claude-sonnet-5(均衡)或 claude-opus-4-8 | Anthropic |
| Gemini 系列 | gemini-3.1-pro-preview 或 gemini-3.5-flash | OpenAI |
这里只列了常见情况。完整的在线模型、id 和价格,见模型参考。
保持不变的部分
因为网关兼容协议,其余部分都和原来的 API 一致:
- 请求和响应结构不变。
- 流式输出方式不变。
- 函数调用和工具调用方式不变。
- JSON 模式和结构化输出方式不变。
你不需要重写解析代码。把客户端指向网关,照常解析响应即可。
常见坑
- 不要重复写
/v1。base URL 设为https://gateway.mytokengate.com/v1,让 SDK 自动拼/chat/completions或/messages。自己再加一遍路径会得到重复的地址。 - 按模型家族保持原生协议。GPT、Gemini 及其他模型用 OpenAI 协议,Claude 用 Anthropic 协议。
- 用你的 MyTokenGate
tg-Key,不要用供应商的 Key。旧的sk-或sk-ant-Key 无法通过网关鉴权。