Skip to content
上新Nano Banana 2.1 已上線:Google 新一代生圖模型,單張低至 $0.0336,原生 4K,約上一代半價查看模型
HopBase
← 返回 Blog

一把 API Key 呼叫 DeepSeek、千問、GLM、Kimi 和豆包

先講結論: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)
DeepSeekdeepseek-v4.1-flash、deepseek-v4.1-flash-1017、deepseek-v4-pro-202606、deepseek-v4-flash-2026051M / 最高 393,216Chat Completions、Responses、Anthropic Messages以即時價格為準
通義千問(阿里巴巴)qwen3.8-max、qwen3.8-flash、qwen3.7-max、qwen3.7-plus、qwen3.7-flash1M / 131,072Chat Completions、Responses以即時價格為準
GLM(智譜)glm-5.3、glm-5.3-flash1M / 最高 131,072Chat Completions以即時價格為準
Kimi(月之暗面)kimi-k31,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-256KChat Completions、Responses、Anthropic Messages以即時價格為準
Claude、GPTclaude-sonnet-5-5、gpt-6-sol 等依模型而定Claude:Anthropic Messages;GPT:Chat Completions、ResponsesSonnet 5.5:$2 / $10;GPT-6 Sol:$2 / $10

DeepSeek 和 GLM 另有一套以 -us 結尾的美國區(US Region)ID,例如 deepseek-v4.1-flash-us、glm-5.3-us。它們有獨立的分組與價格,三種協定都支援,詳見美國區文件。

三步驟完成設定

  1. 在 api.hop-base.com 以電子郵件或 Google、GitHub 帳號註冊,打開 API 金鑰。
  2. 建立一把 Key,加入需要的分組:DeepSeek、千問、GLM、Kimi K3、豆包 Seed;想在同一把 Key 上使用 Claude 和 GPT,再加一個 Claude 分組和一個 GPT 分組。總共 7 個分組,在每把 Key 10 個的上限之內。如果同一把 Key 上有兩個分組都提供某個模型(例如兩個 Claude 分組),儲存前對話框會要求你指定由哪個分組服務。
  3. 列出這把 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。建議 temperature 1、top_p 0.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 呼叫這些模型,從自架代理到託管服務都有選擇。決定之前可以核對:

  1. 是否提供帶日期的精確模型 ID(例如 deepseek-v4.1-flash-1017),而不只是「deepseek-latest」。
  2. include_reasoning、enable_thinking、reasoning_content 這類模型專屬參數能否完整傳遞。
  3. 能否透過 API 看到每次請求的費用,失敗請求是否免費。
  4. 能否驗證回答你的確實是你指定的模型。我們的可重現保真度檢測方法適用於任何服務商。
  5. 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。