UNIFIED GATEWAY · 多协议兼容

一个 API Key,
接入主流大模型。

NextHub 把 Claude、GPT、Gemini 等主流模型的接入聚合为一个统一网关:按 Token 精确计费、逐请求可追溯,Chat Completions、Messages、Responses 三种协议可通过同一端点调用。可用模型与分组取决于账户权限与控制台配置。

CLAUDE GPT GEMINI GROK
3支持的协议
10公开分组
Token级计费
逐请求用量与扣费可追溯
01 / USE CASES

先看你属于哪一种

四种典型用法各自对应一个主要问题与一个下一步入口;具体到某个工具怎么配置,在接入文档里逐篇展开。

01

AI 编程工具

CODING AGENTS

面向 Claude Code、Codex、OpenCode、Kilocode、Zed 等工具的使用者。

问题

每个工具的地址、协议、模型名与配置方式都不一样,换一个工具就要重配一遍。

做法

用同一套账户、API Key 与接入入口;具体配置按对应工具的教程完成,本页不重复教程正文。

查看接入文档与各工具教程 →
02

现有 SDK 或 API 迁移

SDK MIGRATION

面向已经在使用 OpenAI 或 Anthropic SDK 的开发者。

问题

多供应商的地址、鉴权与账单分散在各家,账号与成本都难以汇总。

做法

支持三种已公开协议,通过调整 Base URL、密钥与模型配置即可接入,保留主流 SDK 的使用方式;下方快速接入区给了三种协议的最小示例。

查看 cURL / SDK 接入教程 →
03

多模型应用

MULTI-MODEL

面向需要在 GPT、Claude、Gemini 及其他已授权模型之间做选择的开发者。

问题

模型 ID、协议、渠道与成本口径各不相同,逐个对接的维护成本高。

做法

统一入口、按分组划定可调用范围、逐请求记录用量;分组决定路由渠道与扣费倍率,负载均衡由平台侧承担。

前往模型广场查看分组与倍率 →
04

团队密钥治理

KEY GOVERNANCE

面向需要多人、多个项目或多个环境共用 API 的团队。

问题

一把主密钥大家共用:没有额度边界,消耗也追不到人和项目。

做法

按 API Key 设置额度上限、过期时间、IP 白名单 / 黑名单,以及 5 小时 / 每天 / 每周的速率限制。

查看 API Key 管理教程 →
02 / CAPABILITIES

把一个请求送到上游的能力

从账号池与分组路由到 API Key 治理;下面六项都对应平台公示条款与接入文档里列明的能力,不写没有口径的数字。

01
统一网关UNIFIED GATEWAY

把 Claude、GPT、Gemini 等模型家族的接入聚合为一个端点:Chat Completions、Messages、Responses 三种协议均可用,替换 base URL 与密钥即可接入。

→
02
账号池与负载均衡ACCOUNT POOL

上游以官方号池提供;请求按账号池与分组选择线路,负载均衡与请求调度由平台侧承担。

→
03
精确计费METERED BILLING

按 Token 计量、按分组倍率结算;每次请求的 Token 用量与扣费都有记录,可在控制台逐笔核对。

→
04
分组路由GROUP ROUTING

创建 API Key 时选择的分组决定可调用的模型范围与路由渠道;具体上游选择按平台路由规则执行。

→
05
密钥治理KEY GOVERNANCE

按 API Key 设置额度上限、过期时间、IP 白名单 / 黑名单,以及 5 小时 / 每天 / 每周的速率限制。

→
06
稳定与风控RESILIENCE

使用官方号池直连上游官方 API;平台侧做健康检查、错误分类与风控隔离,并保留计费、审计与风控记录。

→
03 / REQUEST FLOW

一次请求如何完成

上一节说的是「具备什么」;这一节说的是这些能力在一次调用里依次怎么协作。

  1. 01

    客户端或工具发起请求

    你的 SDK、CLI 或 IDE 插件把请求发到 NextHub 的端点。

  2. 02

    请求进入匹配的协议端点

    按 Chat Completions、Messages 或 Responses 落到对应端点,协议格式在网关侧适配。

  3. 03

    密钥规则执行鉴权与范围控制

    校验 API Key,并套用该 Key 的额度上限、过期时间、IP 规则与速率限制窗口。

  4. 04

    网关选择上游渠道与模型

    按 API Key 所选分组与平台的路由规则,决定这次请求走哪条上游线路与哪个模型。

  5. 05

    返回结果并记录用量

    把结果交回客户端,同时记录本次请求的 Token 用量与扣费明细。

第 4 步的具体走向由平台策略决定。按平台公示的服务特定条款,请求可能依据模型、账号池、区域、余额、并发、限速、健康状态、粘性会话、故障转移或平台策略被路由到不同上游资源 —— 也就是说,某一步是否切换线路取决于当时的条件,不是必然发生的步骤。详见 服务特定条款。

04 / MODEL SELECTION

模型与分组怎么选

创建 API Key 时选的分组决定三件事:这个 Key 能调用哪些模型、请求走哪条上游线路、按什么倍率扣费。

分组与倍率快照 2026-09-30 倍率口径 实付 = 官方价格 × 分组倍率 结算以请求结算时的控制台记录为准

  1. 01 使用 Claude Code 或任意 coding agent claude code×0.4ANTHROPIC Claude-Max 号池,原生 Anthropic Messages 协议;不限制客户端,可接入任意 coding agent。
  2. 02 要更稳定的 Claude Max 号池 Claude Max ×0.5ANTHROPIC 已过 KYC 的 Claude Max $200 号池,更稳定、缓存命中率更高;原生 Anthropic Messages 协议,不限制客户端。
  3. 03 需要 Amazon Bedrock 线路 Claude-AWSB×0.7ANTHROPIC Amazon Bedrock 渠道,稳定可靠;coding 用户可作为重度主力。
  4. 04 使用 GPT / Codex 系列 GPT-Azure×0.47OPENAI Microsoft Azure 官方渠道,可用于 OpenCode 等任意第三方工具,可作为重度 coding 主力。
  5. 05 GPT / Codex 系列的低价线路 GPT-Pro×0.15OPENAI 20X Pro 号池,以最大限度维护可用性,价格更低;该分组不可生图。
  6. 06 GPT 促销低价线路 GPT-offers×0.06OPENAI GPT 促销分组,高性价比的 OpenAI business 渠道逆向,不建议作为 coding 主力。
  7. 07 Gemini 经济型线路 Gemini-aistudio×0.28GEMINI 企业号池,性价比更高;推荐通过 Cline、OpenCode 等工具接入。
  8. 08 Gemini 官方稳定线路 Gemini-Vertex×0.49GEMINI Google Vertex 官方渠道,稳定可靠;使用 Gemini flash 推荐这个分组。
  9. 09 使用 Grok 系列 Grok×0.55GROK Grok 官方渠道,提供 Grok 相关模型。
  10. 10 开源模型与低价跑量 开源模型组×0.15DEEPSEEK 提供 DeepSeek、GLM、Qwen、Step,价格实惠;带 free 后缀的 Step 两款目前免费,且不提供 SLA。

图像生成等专属分组需要登录控制台并开通对应权限后才会显示,因此不在上表;实际可用模型、权限与结算价格以控制台与模型广场为准。

模型广场:完整模型清单与实付价格 → 控制台 →

05 / QUICKSTART

三步完成接入

同时支持 Chat Completions、Messages、Responses 三种协议,替换端点、填入密钥,其余交给 NextHub。

STEP 01

创建账户

注册 NextHub 账户,进入个人控制台。

STEP 02

生成 API Key

在控制台选择模型分组,按需配置额度、过期时间与速率限制,复制平台密钥。

STEP 03

替换端点调用

三种协议任选其一,替换 base URL 与密钥即可;主流客户端与官方 SDK 的使用方式保持不变。

POST /v1/chat/completions
# OpenAI 兼容 · 替换 base URL 与密钥即可调用
curl https://api.nexthub.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-nx-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "messages": [{"role": "user", "content": "你好,NextHub!"}]
  }'
POST /v1/messages
# Anthropic 兼容 · 只需替换 base URL 与密钥
curl https://api.nexthub.cc/v1/messages \
  -H "x-api-key: sk-nx-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5-1",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好,NextHub!"}]
  }'
POST /v1/responses
# OpenAI Responses 协议
curl https://api.nexthub.cc/v1/responses \
  -H "Authorization: Bearer sk-nx-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "input": "你好,NextHub!"
  }'

按工具找配置教程

下面每个入口都指向接入文档里该工具自己的教程页,配置步骤以教程为准。

上述工具都是各自厂商的产品,NextHub 与其没有官方合作关系 —— 这里只是把这些工具连到 NextHub 的配置步骤整理成了教程。其中 CC-Switch 是第三方配置辅助工具,不是 NextHub 自有产品。

06 / PRICING

怎么付费,适合什么用法

按实际用量计费;下面三行分别是个人与团队的付费方式、充值口径和企业定制。

A
按量付费PAY-AS-YOU-GO

按 Token 实际用量 × 所选分组的倍率结算,每次请求都有用量与扣费记录,可在控制台逐笔核对。

B
充值与支付TOP-UP

单笔最低充值 5 USD、无手续费,支持 Stripe(Visa / MasterCard / 支付宝 / AMEX)与加密货币(USDT / USDC),按实时汇率充值;以控制台实际支付页面为准。

C
企业定制ENTERPRISE

专属通道、定制配额与人工技术支持;具体范围与结算以订单或双方书面约定为准。

首页只说明计费口径,不复制完整价目表。各分组的最新价格与完整模型清单,请前往 模型广场 查看。

07 / FAQ

常见问题

NextHub 支持哪些模型?

公开提供 Claude、GPT、Gemini、Grok 等模型家族以及 DeepSeek、GLM、Step 等国产开源模型的当前主流版本,可用模型随上游更新。图像生成等通过专属分组提供,需要登录控制台并开通对应权限后才会显示。也就是说,你能调用哪些模型由账户权限与所选分组共同决定,完整清单以 模型广场 与 控制台 为准。

支持哪些 API 协议?

三种主流协议都支持:OpenAI Chat Completions(/v1/chat/completions)、Anthropic Messages(/v1/messages)、OpenAI Responses(/v1/responses),端点统一为 https://api.nexthub.cc。具体某个模型可以用哪种协议调用,以该分组提供的模型与接入文档的说明为准。

兼容 OpenAI 或 Anthropic SDK 吗?

兼容。把 base URL 换成 NextHub 的地址、填入平台密钥,主流 SDK 与客户端的调用方式就可以保持不变;只改 base URL 与密钥即可,不需要重写业务代码。base URL 的具体写法见下面「Base URL 需要带版本路径吗?」。

如何计费?

按各模型单价 × 实际消耗的 Token 计费,实付 = 官方价格 × 所选分组的倍率。每次请求的 Token 用量与扣费都会记录,可在 控制台 逐笔核对;分组倍率见 模型广场 的分组说明。

对话和请求数据如何处理?

为完成鉴权、转发、计费、风控、排障与合规,平台会处理必要的请求元数据:账户信息、API Key 标识、IP 与设备信息、路由信息、模型名、Token 用量、错误信息、订单信息与日志。请求转发到上游后,相关输入、输出与日志可能按上游服务商的条款由其处理;请不要提交不必要的敏感个人信息、密钥或受管制数据。完整口径见 隐私政策 与 服务特定条款 的数据与日志边界一节。

遇到问题怎么办?

先查 接入文档 里的常见报错排查;仍未解决的话,可以在 FAQ 与联系方式 页面找到工单入口与管理员联系方式。

应该如何选择模型分组?

按你要用的模型来定:用 Claude 系列选 claude code 分组(不限制客户端),要更稳定的号池可选 Claude Max 分组;需要 Amazon Bedrock 线路选 Claude-AWSB 分组;GPT / Codex 系列选 GPT-Azure 分组;追求更低价格可选 GPT-Pro 分组;要促销价可选 GPT-offers 分组(不建议作为 coding 主力);Gemini 按预算在 Gemini-aistudio(经济型)与 Gemini-Vertex(官方稳定)之间选;Grok 系列选 Grok 分组;DeepSeek、GLM、Step 等开源模型选开源模型组。本页上方「模型与分组怎么选」一节按用途列出了各分组、当前倍率与各自的限制,分组名与倍率都取自本页快照;也可以直接看 分组与倍率说明。

Base URL 需要带版本路径吗?

因协议和工具而异,没有对所有场景都成立的地址。OpenAI 风格的接口(Chat Completions、Responses)base URL 用 https://api.nexthub.cc/v1,带 /v1;Anthropic 风格(Messages 协议、Claude Code 与 Anthropic SDK)的 base URL 填 https://api.nexthub.cc,不带 /v1——SDK 会自动补全路径,直接请求的完整端点是 https://api.nexthub.cc/v1/messages。Zed、Kilocode 这类 OpenAI 兼容客户端则填 https://api.nexthub.cc/v1。以对应工具的教程为准。

遇到 429 错误应该检查什么?

429 可能来自不同原因,逐项排查:先看账户额度与余额是否充足,不足会直接被拒;额度充足仍频繁触发,通常说明碰到了 API Key 或所在分组的速率限制(5 小时 / 每天 / 每周窗口),可以稍后重试,或调整该 Key 的限速设置。另外确认调用的模型属于该 Key 所选的分组。

模型广场的价格多久更新一次?最终按什么价格结算?

模型广场由平台后台直接维护,分组与价格随后台配置、上游官方调价自动同步,打开页面看到的就是最新数据。实际扣费仍以请求结算时的控制台记录为准;对账单有疑问时,可以附上请求 ID 联系管理员核对。

准备好接入
NextHub 了吗?

注册即可创建你的第一把 API Key,并选择要使用的模型分组。