跳至正文
上新Nano Banana 2.1 已上線：Google 新一代生圖模型，單張低至 $0.0336，原生 4K，約上一代半價查看模型
HopBase
← 返回博客

一把 API Key 呼叫 Claude、GPT、Gemini、DeepSeek | HopBase

HopBase 2026年11月05日 11 分鐘閱讀

能用一把 API Key 同時呼叫 Claude、GPT、Gemini、DeepSeek 的服務主要有兩類:託管的多模型閘道(如 OpenRouter、HopBase),以及自行部署的開源閘道(如 LiteLLM、One API,但模型帳號仍要你逐家去開)。以 HopBase 為例,一把 Key 可包含 1–10 個分組,涵蓋 Claude、GPT、Gemini、DeepSeek、千問、GLM、Kimi、豆包、混元與 Grok;GPT、Gemini 與中國模型走 OpenAI 相容位址 https://api.hop-base.com/v1,Claude 走 Anthropic Messages 位址 https://api.hop-base.com(不帶 /v1)。同一協定下換模型只改 model 欄位。下面提供可直接執行的 curl 與 Python 範例,以及幾種做法的中立比較表。

一把 Key 怎麼涵蓋多家模型:兩種協定

多模型閘道不會把所有模型都塞進同一種請求格式。實際做法是:大多數模型用 OpenAI 相容格式,Claude 保留 Anthropic 原生 Messages 格式。兩種協定用同一把 Key,只是 Base URL 與 API 路徑不同。

協定Base URL端點適用模型驗證
OpenAI 相容https://api.hop-base.com/v1POST /v1/chat/completions(部分模型另有 /v1/responses)GPT、Gemini、DeepSeek、千問、GLM、Kimi、豆包、混元、GrokAuthorization: Bearer
Anthropic Messageshttps://api.hop-base.com(不帶 /v1)POST /v1/messagesClaude(只走這條);Gemini、DeepSeek、豆包也可用x-api-key

兩個常見地雷:Claude 只能走 /v1/messages,送到 /v1/chat/completions 會回 404;kimi-k3 只走 Chat Completions,在 /v1/responses 與 /v1/messages 上回 404。

Key 能呼叫哪些模型,由分組決定

  1. 在主控台「API 金鑰」建立 Key,勾選 1–10 個分組。一個分組對應一個模型家族,例如 Claude、DeepSeek、千問、GLM、Kimi K3。
  2. 用 GET /v1/models 查看這把 Key 能呼叫的模型,回傳的是所選分組模型的聯集。
  3. 只使用清單中的完整模型 ID。請求不在分組內的模型會回 404 model_not_found,不會被悄悄換成其他模型。
  4. 每個請求由涵蓋該模型的那個分組服務與計費,用量紀錄可看到是哪個分組。

注意:模型重疊的分組不能放在同一把 Key,訂閱類分組必須單獨一把 Key。

程式碼範例:只改 model 欄位切換模型

第一步,看這把 Key 能呼叫什麼:

curl https://api.hop-base.com/v1/models \
  -H "Authorization: Bearer sk-your-key"

第二步,用 OpenAI 相容格式呼叫 DeepSeek。換成千問或 GLM 只需改 model:

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Reply with only: ok"}]
  }'

第三步,在 Python 裡用同一個 OpenAI 用戶端輪流呼叫六個模型家族。這裡假設 Key 已包含 GPT(Codex Plus 或 Codex Pro)、Gemini、DeepSeek、千問、GLM 與 Kimi K3 分組:

# pip install openai
from openai import OpenAI

client = OpenAI(base_url="https://api.hop-base.com/v1", api_key="sk-your-key")

for model in ["gpt-5.6-sol", "gemini-3.8-flash", "deepseek-v4.1-flash",
              "qwen3.8-max", "glm-5.3", "kimi-k3"]:
    resp = client.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": "用一句話介紹你自己"}],
    )
    print(model, "->", resp.choices[0].message.content)

第四步,Claude 用 Anthropic SDK,Base URL 不帶 /v1,Key 需包含 Claude 分組。建議明確設定 max_tokens,未填時會以 4096 補上:

# pip install anthropic
import anthropic

client = anthropic.Anthropic(base_url="https://api.hop-base.com", api_key="sk-your-key")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "用一句話介紹你自己"}],
)
print(msg.content[0].text)

若某個模型回傳 {"error":{"code":"model_not_found",...}},先重新呼叫 /v1/models,再到主控台替 Key 加上對應分組。

幾種做法比較

下表只寫可查證的事實。OpenRouter 一欄依據其公開文件與公開模型 API,查核日期 2026-11-05;公開頁沒寫的項目標「公開頁未列出」,不代表沒有。

面向分別串接各廠商自建開源閘道(LiteLLM、One API)OpenRouterHopBase
中國模型涵蓋每家單獨註冊、驗證、儲值取決於你開通了哪些廠商帳號公開模型清單含 DeepSeek、Qwen、GLM(z-ai)、Kimi(moonshotai)、ByteDance SeedDeepSeek、千問、GLM、Kimi、豆包、混元
Claude 原生 MessagesAnthropic 自家 API 即原生取決於專案與版本設定文件說明提供相容 Anthropic Messages API 的入口,Claude Code 設 ANTHROPIC_BASE_URL=https://openrouter.ai/api支援,https://api.hop-base.com + /v1/messages
團隊額度與部門各廠商主控台各管各的專案通常內建虛擬 Key 與額度,部門層級需自行設定Organization 共用額度池,admin / member 角色;成員級額度公開頁未列出成員、部門,金鑰 / 成員 / 部門三級額度
計費幣別與付款各家幣別與付款方式不同軟體免費,模型費用各自向廠商支付美元 credits;主流信用卡、Alipay、USDC美元按量;支付寶、微信支付、Visa / Mastercard
逐筆對帳各家帳單分別核對閘道日誌與各廠商帳單需自行比對Activity 頁可依模型、API key 篩選歷史用量CSV 每列含官方成本、折扣、匯率、實扣,可複算「官方成本 × 折扣 ÷ 匯率 = 實扣」

怎麼選

  • 只用一兩家、已有合約:分別串接各廠商最單純。
  • 有資料落地要求、團隊有維運人力:自建 LiteLLM 或 One API,軟體可控,但帳號、高可用與對帳都要自己做。
  • 以海外模型為主、個人或小團隊:OpenRouter 模型涵蓋面廣,值得先看。
  • Claude Code 與中國模型並用、需要依部門管額度與逐筆對帳:HopBase 一把 Key 同時提供兩種協定,價格依各廠商官方牌價 × 分組折扣結算,見 價格頁。

中國模型各家的參數差異(思考欄位、圖片輸入、工具呼叫)見 一把 Key 呼叫 DeepSeek、千問、GLM、Kimi 和豆包;各平台比較見 2026 年 OpenRouter 替代方案;串接步驟見 快速開始文件。準備好了可以直接 註冊並建立 Key。

常見問題

一把 API Key 能同時呼叫 Claude 和 GPT 嗎?

能,前提是 Key 同時包含 Claude 分組與 GPT 分組。但兩者走不同協定:GPT 用 https://api.hop-base.com/v1 的 Chat Completions 或 Responses,Claude 用 https://api.hop-base.com 的 /v1/messages。Key 是同一把,用戶端要設兩個 Base URL。

DeepSeek、千問、GLM、Kimi 能用 OpenAI SDK 直接呼叫嗎?

能。把 OpenAI SDK 的 base_url 設為 https://api.hop-base.com/v1,model 填 deepseek-v4.1-flash、qwen3.8-max、glm-5.3 或 kimi-k3 等 /v1/models 回傳的 ID 即可,不需要加廠商前綴。

為什麼換了模型名稱就出現 404 model_not_found?

這個模型不在 Key 的分組裡,或模型 ID 拼錯。模型 ID 精確比對,不會自動修正。呼叫 GET /v1/models 確認可用 ID;缺哪家就到主控台編輯 Key,加上對應分組(每把 Key 最多 10 個)。

教學