OpenAI 兼容接口是什么：改一个 base_url 就能换模型服务

OpenAI 兼容接口，指路径和请求格式都和 OpenAI API 一样的接口，比如 POST /v1/chat/completions。土土金 API 的 OpenAI 兼容地址是 https://www.tutujin.com/v1。已经在用 OpenAI SDK 的代码只改两处：base_url 和 api_key，就能调用 GPT、Claude、Gemini、DeepSeek 等目录里标注支持该接口的模型，model 换成对应的模型名即可。

为什么大家都兼容 OpenAI 的格式

OpenAI 的接口格式用的人最多，周边工具也最全。官方 Python 和 Node.js SDK、LangChain、LlamaIndex、Dify、FastGPT、n8n 都支持自定义 base_url，所以一个服务只要兼容这套格式，这些工具拿来就能用。对企业来说，换供应商或者换模型时不用改业务代码，切换成本很低。

本站支持的接口

「已实测」的接口我们在本站做过真实调用和扣费核对；「原样转发」的接口按原格式交给模型服务处理，参数以对应模型的官方说明为准。

迁移只要三步

1. 在控制台创建 API Key，为它选一个分组。
2. 把 base_url 改成 https://www.tutujin.com/v1，api_key 改成新 Key。
3. 把 model 改成模型与价格里的模型名。

官方 SDK 也会读取环境变量，有些项目连代码都不用改，设置两个环境变量就行：

export OPENAI_BASE_URL="https://www.tutujin.com/v1"
export OPENAI_API_KEY="sk-你的Key"

在代码里显式指定也可以：

import os
from openai import OpenAI

client = OpenAI(base_url="https://www.tutujin.com/v1", api_key=os.environ["TUTUJIN_API_KEY"])

resp = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "用三句话介绍上下文缓存"}],
)
print(resp.choices[0].message.content)

import OpenAI from 'openai'

const client = new OpenAI({ baseURL: 'https://www.tutujin.com/v1', apiKey: process.env.TUTUJIN_API_KEY })

const resp = await client.chat.completions.create({
  model: 'deepseek-v4.1-flash',
  messages: [{ role: 'user', content: '用三句话介绍上下文缓存' }],
})
console.log(resp.choices[0].message.content)

上面这段代码只改 model 就能换成其他厂商的模型，比如 claude-sonnet-5-5 或 gemini-3.8-flash。

兼容不等于完全一样

• 参数支持有差别。temperature 的取值范围、response_format、tools、reasoning_effort 这些参数，非 OpenAI 模型的支持程度各不相同。不支持的参数可能被忽略，也可能返回 400。
• 部分返回字段不同。基本结构一致，但推理内容、缓存 tokens 这类厂商特有的信息，字段名和是否返回取决于模型。
• 模型名用本站的。同一个模型在不同平台的叫法可能不一样，以模型广场显示的为准。

所以换模型之后，先用少量请求验证一遍参数和返回，再放量。整个项目从官方 API 或其他服务迁移过来时，核对清单、分批切换和回滚办法见从官方 API 或其他 OpenAI 兼容服务迁移。

兼容接口和原生接口怎么选

三种接口用的是同一把 Key，按同样的价格计费。

常用工具的配置

• OpenAI SDK
• Anthropic SDK
• LangChain 和 LlamaIndex
• Dify、FastGPT 和 n8n

认证方式和请求头的写法见认证与 Base URL。