從其他平台遷移

把現有應用遷到 HopBase，只需要改三項：Base URL、金鑰，有時還有模型名稱。請求內容、串流處理和錯誤處理程式碼都不用動。

要改什麼

各模型系列走哪種協定，見 Base URL 與協定。

OpenAI SDK

設定 Base URL、換掉金鑰即可。gpt-5.5 這類 OpenAI 模型 ID 只要出現在這把金鑰的 GET /v1/models 裡，就不用改。

 import os
 from openai import OpenAI

 client = OpenAI(
-    api_key=os.environ["OPENAI_API_KEY"],
+    base_url="https://api.hop-base.com/v1",
+    api_key=os.environ["HOPBASE_OPENAI_API_KEY"],
 )

 resp = client.chat.completions.create(
     model="gpt-5.5",
     messages=[{"role": "user", "content": "Hello"}],
 )

不想改程式碼的話，兩個 SDK 都會讀取環境變數 OPENAI_BASE_URL 和 OPENAI_API_KEY：分別設為 https://api.hop-base.com/v1 和你的 HopBase 金鑰。更多範例見 OpenAI SDK。

Anthropic SDK

Claude 繼續走 Anthropic Messages API。Base URL 不帶 /v1，金鑰用「Claude Max(官號滿血版)」分組的。「Claude Max（ccmax）」分組的金鑰只能在 Claude Code 用戶端裡用，SDK 呼叫會失敗。

 import os
 from anthropic import Anthropic

 client = Anthropic(
-    api_key=os.environ["ANTHROPIC_API_KEY"],
+    base_url="https://api.hop-base.com",
+    api_key=os.environ["HOPBASE_CLAUDE_API_KEY"],
 )

 msg = client.messages.create(
     model="claude-sonnet-5",
     max_tokens=1024,
     messages=[{"role": "user", "content": "Hello"}],
 )

同樣可以只改環境變數：ANTHROPIC_BASE_URL=https://api.hop-base.com。詳見 Anthropic SDK。

OpenRouter

改 Base URL 和金鑰，去掉模型名稱裡的廠商前綴，並刪掉 OpenRouter 的來源標識請求標頭——HopBase 用不到它們。

 import os
 from openai import OpenAI

 client = OpenAI(
-    base_url="https://openrouter.ai/api/v1",
-    api_key=os.environ["OPENROUTER_API_KEY"],
-    default_headers={"HTTP-Referer": "https://your-app.example", "X-Title": "Your App"},
+    base_url="https://api.hop-base.com/v1",
+    api_key=os.environ["HOPBASE_OPENAI_API_KEY"],
 )

 resp = client.chat.completions.create(
-    model="openai/gpt-5.5",
+    model="gpt-5.5",
     messages=[{"role": "user", "content": "Hello"}],
 )

如果你之前是透過 OpenRouter 的 OpenAI 相容端點呼叫 Claude，HopBase 上 Claude 沒有這條路徑：請按上一節改用 Anthropic SDK 和 Claude 分組金鑰。其他系列（Gemini、GLM、通義千問、DeepSeek、Kimi、Grok）繼續用 OpenAI SDK，各用自己分組的金鑰。

不支援的功能

完整端點清單見 Base URL 與協定。

遷移後檢查