先講結論:DeepSeek、通義千問、GLM、Kimi 和豆包 Seed 可以用同一把 OpenAI 相容的 API Key 呼叫,這把 Key 還能同時涵蓋 Claude 和 GPT。在 HopBase 上,把 OpenAI SDK 的 Base URL 設為 https://api.hop-base.com/v1,在主控台為 Key 加入各家模型的分組(每把 Key 最多 10 個分組),之後只改 model 欄位:deepseek-v4.1-flash、qwen3.8-max、glm-5.3、kimi-k3、doubao-seed-2-1-pro-260628。Claude 使用 Anthropic SDK,Base URL 是 https://api.hop-base.com(不含 /v1)。統一從一個美元餘額扣款,每個非串流回應都會回傳本次的確切扣款。真正讓串接出問題的不是端點,而是各家模型的差異:Kimi K3 要加 include_reasoning 才會回傳思考過程,兩款豆包模型不理會 tool_choice,千問依上下文長度分級計費,DeepSeek V4.1 Flash 有尖峰與離峰價。本文逐一列出這些差異,並在 2026-10-29 以實際請求逐項核對。
為什麼用一把 Key,而不是開五個帳戶
中國的開源與前沿模型已是許多技術堆疊的標準配備:DeepSeek 負責低成本推理,千問和 GLM 負責長上下文,Kimi K3 負責代理式程式開發,豆包 Seed 負責多模態對話。逐家直接申請代表五個開發者主控台、五份餘額、五套發票。其中好幾家的主控台主要服務中國大陸使用者,介面是簡體中文,需要手機號碼驗證或人民幣付款。而且每家所謂的「OpenAI 相容」介面都有自己的擴充欄位。
閘道給你的是一個帳戶、一個美元餘額、一個 Base URL。它無法消除各家模型的差異,所以本文大部分篇幅都在談這些差異。
模型陣容與定價
下表所有 ID 都已在公開目錄上線。廠商有公布美元官方價的,表中列出每百萬 token 的官方定價;其餘請看即時價格頁,那裡也列出每個模型的快取命中價。
| 家族 | 模型 ID | 上下文 / 最大輸出 | 協定 | 定價(輸入 / 輸出,每百萬 token) |
|---|---|---|---|---|
| DeepSeek | deepseek-v4.1-flash、deepseek-v4.1-flash-1017、deepseek-v4-pro-202606、deepseek-v4-flash-202605 | 1M / 最高 393,216 | Chat Completions、Responses、Anthropic Messages | 以即時價格為準 |
| 通義千問(阿里巴巴) | qwen3.8-max、qwen3.8-flash、qwen3.7-max、qwen3.7-plus、qwen3.7-flash | 1M / 131,072 | Chat Completions、Responses | 以即時價格為準 |
| GLM(智譜) | glm-5.3、glm-5.3-flash | 1M / 最高 131,072 | Chat Completions | 以即時價格為準 |
| Kimi(月之暗面) | kimi-k3 | 1,048,576 / 32,768 | 僅 Chat Completions | $3 / $15 |
| 豆包 Seed(字節跳動) | doubao-seed-2-1-pro-260628、doubao-seed-2-1-pro-260915、doubao-seed-2-1-lite-260915、doubao-seed-2-1-turbo-260628 等 7 款 | 128K-1M / 32K-256K | Chat Completions、Responses、Anthropic Messages | 以即時價格為準 |
| Claude、GPT | claude-sonnet-5-5、gpt-6-sol 等 | 依模型而定 | Claude:Anthropic Messages;GPT:Chat Completions、Responses | Sonnet 5.5:$2 / $10;GPT-6 Sol:$2 / $10 |
DeepSeek 和 GLM 另有一套以 -us 結尾的美國區(US Region)ID,例如 deepseek-v4.1-flash-us、glm-5.3-us。它們有獨立的分組與價格,三種協定都支援,詳見美國區文件。
三步驟完成設定
- 在 api.hop-base.com 以電子郵件或 Google、GitHub 帳號註冊,打開 API 金鑰。
- 建立一把 Key,加入需要的分組:DeepSeek、千問、GLM、Kimi K3、豆包 Seed;想在同一把 Key 上使用 Claude 和 GPT,再加一個 Claude 分組和一個 GPT 分組。總共 7 個分組,在每把 Key 10 個的上限之內。如果同一把 Key 上有兩個分組都提供某個模型(例如兩個 Claude 分組),儲存前對話框會要求你指定由哪個分組服務。
- 列出這把 Key 能呼叫的模型,只使用它回傳的 ID:
export HOPBASE_API_KEY=sk-your-key
curl https://api.hop-base.com/v1/models -H "Authorization: Bearer $HOPBASE_API_KEY"
一個用戶端,五個模型家族
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.hop-base.com/v1",
api_key=os.environ["HOPBASE_API_KEY"])
models = ["deepseek-v4.1-flash", "qwen3.8-max", "glm-5.3",
"kimi-k3", "doubao-seed-2-1-pro-260628"]
for m in models:
raw = client.chat.completions.with_raw_response.create(
model=m,
messages=[{"role": "user", "content": "In one sentence: what is a vector database?"}],
max_tokens=2000,
)
resp = raw.parse()
print(m, "|", resp.choices[0].message.content.strip()[:80],
"| cost USD:", raw.headers.get("X-HopBase-Cost-USD"))
每個計費的非串流回應都帶有 X-HopBase-Cost-USD 回應標頭,也就是本次從餘額扣除的確切金額,JSON 中的 usage.cost_usd 也是同一個值。串流回應不帶這個標頭,因為標頭在生成開始前就已送出;串流請求請到主控台的使用記錄頁查看。max_tokens 刻意給得寬鬆:這些模型大多預設開啟思考,思考 token 也計入這個上限。
Claude 用同一把 Key 走 Anthropic SDK:
from anthropic import Anthropic
claude = Anthropic(base_url="https://api.hop-base.com", api_key=os.environ["HOPBASE_API_KEY"])
msg = claude.messages.create(model="claude-sonnet-5-5", max_tokens=512,
messages=[{"role": "user", "content": "Hello"}])
各家模型的地雷
Kimi K3
- 只有請求中帶
"include_reasoning": true,思考過程才會出現在reasoning_content;thinking和reasoning_effort沒有作用。使用 OpenAI SDK 時透過extra_body={"include_reasoning": True}傳入。我們用同一個提示詞實測:不帶這個參數時沒有reasoning_content,帶上之後就有。 max_tokens上限是 32,768,且包含思考 token;n只能是 1;temperature範圍 0-1;top_p和 frequency/presence penalty 會被忽略。- 圖片只能用 base64,傳入圖片 URL 會回傳 400。
/v1/responses和/v1/messages回傳 404,所以 Claude Code 和 Codex 只能透過 CC Switch 這類本機路由工具串接(見 Kimi K3 文件)。
DeepSeek
deepseek-v4.1-flash和deepseek-v4.1-flash-1017依循 DeepSeek 公布的尖峰/離峰時段:北京時間平日 09:00-12:00 和 14:00-18:00 為尖峰,其他時段半價。每次請求依完成的時間點計價。在意成本的話,批次作業盡量避開尖峰時段。deepseek-v4-pro-202606和deepseek-v4-flash-202605全天以同一價格計費,依尖峰定價。deepseek-v4.1-flash-1017是 2026-10-17 發布的版本,deepseek-v4.1-flash仍是 9 月版本。兩者都能透過標準image_url讀圖,而 V4 Pro 和 V4 Flash 收到圖片會回傳 400。依模型 ID 選擇版本即可。- 四個模型都支援 Chat Completions、Responses 和 Anthropic Messages,我們用同一個提示詞在每個端點測了其中三個。在 Chat Completions 上,思考過程位於
reasoning_content,不在content。
通義千問
- 依上下文分級計費:單次請求的輸入一旦超過門檻,整次請求都以該級計費。
qwen3.7-plus超過 256K 升級,qwen3.7-flash超過 32K 升級;qwen3.8-max、qwen3.8-flash和qwen3.7-max只有一級。命中快取也不會讓你留在門檻以下。 - 對延遲敏感的呼叫,可以傳
enable_thinking: false(透過extra_body)關閉思考。除qwen3.7-max外都支援圖片與影片輸入。
GLM
glm-5.3只接受文字,傳入圖片回傳 400。兩款 GLM 都只提供 Chat Completions,所以只支援 Responses 協定的 Codex CLI 無法使用;美國區的glm-5.3-us三種協定都支援。glm-5.3-flash一律開啟思考,思考內容位於reasoning_content。建議temperature1、top_p0.95,串流輸出工具呼叫時加上tool_stream: true。支援文字、圖片、影片與檔案輸入。
豆包 Seed
doubao-seed-evolving和doubao-seed-2-1-pro-260915會忽略tool_choice。我們實測強制指定某個函式時,doubao-seed-2-1-pro-260628照做呼叫,而doubao-seed-2-1-pro-260915直接以文字回答。需要強制或停用工具呼叫時,請使用doubao-seed-2-1-pro-260628或doubao-seed-2-1-lite-260915。- 除
doubao-seed-character-260628外都預設思考。別把doubao-seed-*對話模型 ID 和doubao-seedance-*影片模型 ID 搞混。
跨家族統一處理錯誤
OpenAI 協定下,閘道錯誤格式統一為 {"error": {"code": ..., "message": ..., "type": ...}}。請依 HTTP 狀態碼和 code 分支處理,不要比對 message 文字——它會隨 Accept-Language 請求標頭改變。最常見的幾個:
- 404
model_not_found:這個模型不在該 Key 的任何分組中。重新查詢/v1/models。 - 402
insufficient_quota:餘額用完,或該 Key 自己的消費上限已到。 - 429
user_concurrency_limit/apikey_concurrency_limit:處理中的請求過多。超出的請求會被立即拒絕而不是排隊,請退避後重試。
沒有產生任何輸出就失敗的請求不計費。
如何為中國模型挑選閘道
想用一把 Key 呼叫這些模型,從自架代理到託管服務都有選擇。決定之前可以核對:
- 是否提供帶日期的精確模型 ID(例如
deepseek-v4.1-flash-1017),而不只是「deepseek-latest」。 include_reasoning、enable_thinking、reasoning_content這類模型專屬參數能否完整傳遞。- 能否透過 API 看到每次請求的費用,失敗請求是否免費。
- 能否驗證回答你的確實是你指定的模型。我們的可重現保真度檢測方法適用於任何服務商。
- Claude、GPT 能否和中國模型放在同一把 Key、同一個餘額下。
常見問題
能用 OpenAI Python SDK 呼叫 DeepSeek、千問和 Kimi 嗎?
可以。設定 base_url="https://api.hop-base.com/v1",填入模型 ID 即可。include_reasoning(Kimi)、enable_thinking(千問)這類模型專屬欄位放進 extra_body。
需要中國手機號碼或中國的付款方式嗎?
不需要。在 api.hop-base.com 以電子郵件或 Google、GitHub 帳號註冊,餘額與扣款都以美元計算。增值頁會在付款前顯示付款幣別、手續費和入帳金額。
一把 Key 能同時呼叫 Claude 和 DeepSeek 嗎?
可以,只要這把 Key 加入了兩邊的分組。Claude 走 Anthropic 協定,位址是 https://api.hop-base.com;DeepSeek 走 OpenAI 協定,位址是 https://api.hop-base.com/v1。每次請求依實際服務該模型的分組計費。
為什麼 Kimi K3 不回傳思考過程?
Kimi K3 只有在請求帶 "include_reasoning": true 時才回傳 reasoning_content。無論是否回傳,思考 token 都以輸出計費,並計入 max_tokens。
完整的參數限制在哪裡看?
見 DeepSeek、通義千問、GLM-5.3、Kimi K3 文件和模型清單。價格見 hop-base.com/pricing。