迁移指南

从 OpenRouter 迁移

如果你正在使用 OpenRouter，迁移到 HypersHub 只需更换 API 地址和密钥。两者都提供统一的 LLM API 网关，接口兼容 OpenAI 格式，迁移成本极低。

核心差异

对比项	OpenRouter	HypersHub
API 地址	https://openrouter.ai/api/v1	https://apiclaw.cc/v1
API Key 格式	sk-or-vv-...	hy-...
支持的协议	OpenAI 兼容	OpenAI 兼容（含 Gemini）+ Claude 原生
计费币种	USD	人民币（¥）
计费粒度	按 token 计费	按 token 计费，Prompt Cache 自动折扣
增值服务	模型排名、社区评价	统一控制台、Agent 平台、运营管理

迁移步骤

整个迁移只需要修改两处：Base URL 和 API Key。代码结构、请求体格式、SDK 调用方式均无需改动。

1. 注册 HypersHub 并获取 API Key

2. 替换 Base URL

在原有代码中，将 OpenRouter 的 API 地址替换为 HypersHub 的地址。model 字段使用 HypersHub 的模型 ID。

# OpenRouter old code
client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="sk-or-vv-...",
)

# --- After migration ---
client = OpenAI(
    base_url="https://apiclaw.cc/v1",
    api_key="hy-xxxxxxxxxxxx",
)

completion = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Hello"}],
)

模型名称对照

OpenRouter 使用组织/模型格式的模型 ID，HypersHub 使用简短的模型 ID。以下是常见模型的对照：

模型	OpenRouter ID	HypersHub ID
Claude Opus 4.8	anthropic/claude-opus-4-8	claude-opus-4-8
Claude Opus 4.7	anthropic/claude-opus-4-7	claude-opus-4-7
Claude Sonnet 4.6	anthropic/claude-sonnet-4-6	claude-sonnet-4-6
Claude Haiku 4.5	anthropic/claude-4-5-haiku	claude-haiku-4-5-20251001
GPT-5.5	openai/gpt-5.5	gpt-5.5
GPT-5.4	openai/gpt-5.4	gpt-5.4
GPT-5.4-mini	openai/gpt-5.4-mini	gpt-5.4-mini
Gemini 3.1 Pro	google/gemini-3.1-pro	gemini-3.1-pro-preview
DeepSeek V4 Pro	deepseek/deepseek-v4	deepseek-v4-pro
DeepSeek V4 Flash	deepseek/deepseek-v4-flash	deepseek-v4-flash

HypersHub 独有能力

除了基本的 OpenAI 兼容接口，HypersHub 还提供以下 OpenRouter 不具备或支持有限的特性：

说明：Gemini 模型通过 OpenAI 兼容接口使用，不提供 Gemini 原生 generateContent/streamGenerateContent 端点。

Claude 原生 API

通过 /v1/messages 使用 Anthropic 原生 Messages API，支持 Extended Thinking。认证使用 x-api-key 请求头，与 Anthropic SDK 完全兼容。

官方 CLI 工具

@hypershub/cli 提供 hy init 一键配置 Claude Code、Codex、OpenCode 等工具，hy use 随时切换模型，无需手动编辑配置文件。

TypeScript SDK

@hypershub/sdk 提供类型安全的 Chat、Responses、Messages、Models 接口，原生支持流式、工具调用和错误类型。

Prompt Cache 自动折扣

缓存命中的 Token 自动按折扣价计费（Claude ≈ 10% 原价、DeepSeek ≈ 1% 原价），无需修改代码，账单自动享受优惠。

统一运营控制台

在控制台统一管理 API Key、查看用量明细、设置预算告警、管理模型权限。支持多租户、分销模式等高级运营能力。

第三方工具迁移

如果 OpenRouter 用于 Claude Code、Codex 等第三方工具，迁移同样只需要替换地址和密钥。

工具	迁移方式
Claude Code	运行 hy init claude-code 一键配置；或手动设置环境变量 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。
Claude Desktop	在 Developer Mode 配置项中，将 Base URL 改为平台地址，API Key 替换。
Codex	运行 hy init codex；或手动编辑 ~/.codex/config.toml，将 API 地址改为平台地址。
OpenCode	运行 hy init opencode；或手动编辑配置文件中的 apiBaseUrl 和 apiKey。
其他 OpenAI 兼容工具	将 Base URL 改为平台地址，API Key 替换，即可直接使用。

常见问题

迁移需要修改代码吗？

不需要。如果你使用 OpenAI SDK 调用 OpenRouter，只需替换 base_url 和 api_key，其余代码完全不变。

模型 ID 不一样，需要逐个替换吗？

是的，模型 ID 需要从 OpenRouter 的组织/模型格式改为 HypersHub 的简化格式。请参考上方的模型名称对照表。

可以在同一个项目里同时使用吗？

可以。创建两个 SDK 客户端实例，分别配置不同的 base_url 和 api_key 即可。建议在完成迁移验证后，移除 OpenRouter 的配置以免混淆。

流式响应、工具调用等功能是否支持？

全部支持。流式响应（stream=True）、工具调用（tools）、视觉输入（image_url）等 OpenAI 兼容格式的能力，HypersHub 全部兼容。

如何验证迁移是否成功？

使用 HypersHub CLI 运行 hy check all --live 验证配置和连通性；或发送一条测试请求确认返回正常。