Skip to Content
WikiAPI 文档从 OpenAI 迁移

从 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、更早的 GPTgpt-5.4(日常默认)或 gpt-5.6-sol(旗舰)OpenAI
gpt-4o-minigpt-5.4-nanoOpenAI
claude-3-*claude-*-2025*claude-sonnet-5(均衡)或 claude-opus-4-8Anthropic
Gemini 系列gemini-3.1-pro-previewgemini-3.5-flashOpenAI

这里只列了常见情况。完整的在线模型、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 无法通过网关鉴权。

下一步

Last updated on