迁移指南

从 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 兼容 + Claude 原生 + Gemini 原生
计费币种	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 旧代码
client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="sk-or-vv-...",
)

# ─── 迁移后 ───
client = OpenAI(
    base_url="https://apiclaw.cc/v1",
    api_key="hy-xxxxxxxxxxxx",
)

# 其余代码完全不变
completion = client.chat.completions.create(
    model="claude-sonnet-4-6",  # 使用 HypersHub 模型 ID
    messages=[{"role": "user", "content": "你好"}],
)

模型名称对照

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

模型	OpenRouter ID	HypersHub ID
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

完整的模型列表请通过 /v1/models 接口或 hy models 命令查询。

HypersHub 独有能力

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

Claude 原生 API

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

Gemini 原生 API

通过 /v1beta/models/{model}:generateContent 使用 Google Gemini 原生格式，支持 grounding、generationConfig 等 Gemini 独有参数。

官方 CLI 工具

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

TypeScript SDK

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

Prompt Cache 自动折扣

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

统一运营控制台

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

第三方工具迁移

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

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

常见问题

迁移需要修改代码吗？

不需要。如果你使用 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 验证配置和连通性；或发送一条测试请求确认返回正常。

下一步

快速开始 — 完整的入门指南
API Reference — 查看各端点的请求格式
能力指南 — 学习工具调用、流式响应、视觉输入
模型与计费 — 查看详细价格与计费说明