GreatHub.AI

DOCS

API 文档

一个 API Key 调用当前已开通的模型。Claude 用 CC Switch 接入;代码里只换官方 SDK 的地址和密钥。

地址与鉴权

OpenAI 兼容接口的 base_url 带 /v1,Anthropic SDK 不带,它会自己拼 /v1/messages。

OpenAI 兼容
https://your-domain.com/api/v1
Anthropic
https://your-domain.com/api
协议请求头
Anthropicx-api-key: sk-...anthropic-version: 2023-06-01
OpenAIAuthorization: Bearer sk-...

可用模型

下表是当前默认可调用的模型,点名称即可复制。价格见模型广场。用 Key 请求 GET /v1/models 拿到这把 Key 的实时列表。 Claude 走 /v1/messages,其余模型走 OpenAI 兼容接口。

调用

方法路径说明
POST/v1/messagesAnthropic Messages,Claude 用这个
POST/v1/chat/completionsOpenAI Chat Completions
POST/v1/responsesOpenAI Responses
POST/v1/embeddings向量
GET/v1/models当前 Key 可用模型
Anthropic
curl https://your-domain.com/api/v1/messages \
  -H "x-api-key: $GREATHUB_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'
OpenAI
curl https://your-domain.com/api/v1/chat/completions \
  -H "Authorization: Bearer $GREATHUB_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'

官方 SDK 只改 base_url 和 api_key。需要流式时在请求体加 "stream": true。

用 CC Switch 接入

CC Switch 用来管理 Claude Code 和 Claude Desktop 的供应商。预设列表里没有 GreatHub.AI,添加自定义供应商,按下表填写。

安装

装最新版。macOS 可以用 Homebrew:

shell
brew install --cask cc-switch

或到CC Switch Releases下载:macOS 用 dmg / zip,Windows 用 msi / zip,Linux 用 deb / rpm / AppImage。首次若被系统拦截,到「隐私与安全性」里允许打开。

Claude Code

  1. 在控制台创建一把 API Key。
  2. 打开 CC Switch,顶部切到 Claude。
  3. 点右上角加号,添加自定义供应商。
  4. 按下表填写,保存后在卡片上点「启用」。
字段填写
名称GreatHub.AI
API 格式Anthropic
请求地址https://your-domain.com/api
API Key控制台创建的 sk- 密钥

密钥只在本机交给 CC Switch,不会发到服务器。没有弹出窗口就再点一次。令牌列表里的 CC Switch 按钮做同样的事。

Claude Desktop

  1. 顶部切到 Claude Desktop,同样添加自定义供应商。
  2. 请求地址、API Key、API 格式与 Claude Code 相同。
  3. 模型档位按下表填,没有对应模型的档位留空。
  4. 点「启用」,然后完整退出并重新打开 Claude Desktop。
字段填写

控制台在本机打开时,可以把 Claude Desktop 直接写入 CC Switch。公开网站不提供这个按钮:CC Switch 的深链接还不接受 Desktop,请按上面的步骤手动添加。

其他客户端

不用 CC Switch 时,把地址和密钥换成下面两组即可,不必改调用代码。

Claude Code 命令行
export ANTHROPIC_BASE_URL="https://your-domain.com/api"
export ANTHROPIC_API_KEY="sk-..."
OpenAI SDK
export OPENAI_BASE_URL="https://your-domain.com/api/v1"
export OPENAI_API_KEY="sk-..."

常见问题

返回 401?

核对请求头:Anthropic 用 x-api-key,OpenAI 用 Authorization: Bearer。确认 Key 完整、未删除、未过期。OpenAI SDK 的 base_url 要带 /v1,Anthropic 不要带。

提示模型无可用渠道?

Claude 走 /v1/messages,其他模型走 /v1/chat/completions 或 /v1/responses。协议和模型对不上就会失败。模型名与上面的列表保持一致,注意 - 和 .。

返回 403,余额或额度不足?

账号余额用完,或这把 Key 设置了额度并且已经用尽。到控制台查看余额和 Key 额度。

首字很慢或超时?

大模型思考时,首字要几秒到几十秒。请求加上 stream: true,客户端读超时留够。服务端等待上游的默认时间是 300 秒。