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。