从其他平台迁移

把现有应用迁到 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 与协议。

迁移后检查