HyperAPI 使用手册

本文档适用于基于 New API 搭建的 https://hyperapi.cc 中转站，面向首次接入和日常使用场景。

参考说明：

站点入口：https://hyperapi.cc
OpenAI 兼容接口地址：https://hyperapi.cc/v1
如果你的控制台页面显示了单独的 API 地址，请优先以控制台展示的地址为准

1. 平台简介

HyperAPI 是一个聚合式 AI 模型中转平台，统一提供多模型、多厂商的 API 接入能力。你可以通过一个站点完成：

账户注册与登录
额度充值与消费管理
创建 API Key
以 OpenAI 兼容方式接入第三方客户端、脚本和应用
按模型调用聊天、绘图、向量、音频等能力

2. 快速开始

接入只需要 4 步：

注册并登录 https://hyperapi.cc
在控制台充值可用额度
在“令牌管理”中创建 API Key
使用 https://hyperapi.cc/v1 和你的 Key 发起请求

3. 注册、登录与充值

3.1 注册账号

打开 https://hyperapi.cc，完成注册并登录控制台。

3.2 充值额度

登录后进入控制台充值页面，按页面提示完成支付。充值成功后，额度会显示在账户余额中。

建议：

首次使用可以先小额充值，验证模型和客户端配置是否正常
不同模型价格不同，实际扣费以控制台模型价格页和账单页为准

4. 创建 API Key

登录后进入控制台的“令牌管理”，创建一个新的令牌。

建议的做法：

给令牌写清楚用途，例如“Cherry Studio”“脚本调用”“网站后端”
如需隔离风险，可以为不同项目分别创建不同令牌
不要把 Key 暴露到前端页面、公开仓库或聊天记录中

创建完成后，你会得到一串形如下面的密钥：

text

sk-xxxxxxxxxxxxxxxxxxxxxxxx

请妥善保存，该 Key 只应在受信任的客户端或服务端环境中使用。

5. 接口地址说明

HyperAPI 兼容多种上游请求格式，最常用的是 OpenAI 兼容接口。

重要说明：

文档中的模型名示例仅用于演示
实际调用时，请以控制台中的模型列表或 GET /v1/models 返回结果为准
如果模型名写错，最常见的报错就是模型不存在或无权限访问

5.1 OpenAI 兼容

Base URL：https://hyperapi.cc/v1
模型列表：GET https://hyperapi.cc/v1/models
对话接口：POST https://hyperapi.cc/v1/chat/completions
Responses 接口：POST https://hyperapi.cc/v1/responses
向量接口：POST https://hyperapi.cc/v1/embeddings
图片接口：POST https://hyperapi.cc/v1/images/generations
音频转写：POST https://hyperapi.cc/v1/audio/transcriptions

请求头：

http

Authorization: Bearer 你的_API_Key
Content-Type: application/json

5.2 Claude 兼容

接口地址：POST https://hyperapi.cc/v1/messages

5.3 Gemini 兼容

模型列表：GET https://hyperapi.cc/v1beta/models
文本生成：POST https://hyperapi.cc/v1beta/models/{model}:generateContent

如果你平时使用的是 OpenAI SDK、ChatBox、Cherry Studio、NextChat、LobeChat 等客户端，通常优先选择 OpenAI 兼容方式最省事。

6. 第一次 API 调用

6.1 使用 cURL

bash

curl https://hyperapi.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "你的模型名",
    "messages": [
      {
        "role": "user",
        "content": "你好，简单介绍一下你自己。"
      }
    ]
  }'

6.2 Python 示例

python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://hyperapi.cc/v1",
)

resp = client.chat.completions.create(
    model="你的模型名",
    messages=[
        {"role": "user", "content": "你好，给我一句欢迎语。"}
    ],
)

print(resp.choices[0].message.content)

6.3 Node.js 示例

javascript

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'sk-你的密钥',
  baseURL: 'https://hyperapi.cc/v1',
})

const resp = await client.chat.completions.create({
  model: '你的模型名',
  messages: [
    { role: 'user', content: '你好，给我一句欢迎语。' }
  ],
})

console.log(resp.choices[0].message.content)

7. 常用第三方客户端配置

7.1 Cherry Studio

新增 OpenAI 兼容提供商时填写：

接口地址：https://hyperapi.cc/v1
API Key：你的 Key
模型：从平台支持的模型中选择

7.2 ChatBox

配置 OpenAI API 时填写：

API Host：https://hyperapi.cc
API Path：/v1/chat/completions
API Key：你的 Key

如果客户端只有一个 Base URL 输入框，也可以直接填写：

text

https://hyperapi.cc/v1

7.3 NextChat / LobeChat / Open WebUI

这类应用通常支持自定义 OpenAI 网关，常见配置如下：

OPENAI_API_KEY=sk-你的密钥
OPENAI_API_BASE_URL=https://hyperapi.cc/v1

如果应用使用的是 OPENAI_BASE_URL、BASE_URL 或 OPENAI_API_HOST 等字段，请按应用自身变量名填写同一个地址。

7.4 Claude Code

Claude Code 走的是 Anthropic 兼容接口，建议使用 API Key 模式接入。

推荐环境变量：

bash

export ANTHROPIC_BASE_URL="https://hyperapi.cc"
export ANTHROPIC_API_KEY="sk-你的密钥"

说明：

ANTHROPIC_BASE_URL 填根地址即可，不要额外拼 /v1/messages
Claude Code 会基于该地址请求 Anthropic 兼容接口
模型名请填写平台实际可用的 Claude 系列模型，建议先在控制台或接口返回的模型列表中确认

调用示例：

bash

claude --model "你的 Claude 模型名" "用中文总结一下当前目录结构"

如果你的 Claude Code 默认使用登录态而不是 API Key，建议优先用下面的方式做一次隔离测试：

bash

ANTHROPIC_BASE_URL="https://hyperapi.cc" \
ANTHROPIC_API_KEY="sk-你的密钥" \
claude --bare --model "你的 Claude 模型名" "输出 ok"

说明：

--bare 会禁用 keychain、OAuth 等默认凭证读取，适合验证中转站 API Key 是否配置正确
如果这条命令能正常返回结果，说明 API Key 模式已经通了
验证通过后，你再决定是否继续使用 --bare，或改回你自己的日常启动方式

常见问题：

如果提示鉴权失败，优先检查 ANTHROPIC_API_KEY 是否生效
如果提示模型不存在，说明当前模型名与你平台开放的模型名不一致
如果流式输出异常，先升级 Claude Code 到较新版本再测试

7.5 Codex CLI

Codex CLI 更适合通过自定义 provider 走 OpenAI Responses 接口。

先设置 API Key：

bash

export OPENAI_API_KEY="sk-你的密钥"

然后编辑 ~/.codex/config.toml：

toml

model = "你的模型名"
model_provider = "custom"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.custom]
name = "custom"
base_url = "https://hyperapi.cc/v1"
wire_api = "responses"

说明：

base_url 使用 https://hyperapi.cc/v1
wire_api 建议填写 responses
model 请填写你平台当前支持的 OpenAI/Codex 系列模型
建议先用 GET https://hyperapi.cc/v1/models 或控制台模型页确认模型名

启动示例：

bash

codex -m "你的模型名"

非交互示例：

bash

codex exec -m "你的模型名" "阅读当前项目并总结主要模块"

如果你已经配置过 ~/.codex/config.toml，只需要改两处：

把 base_url 改为 https://hyperapi.cc/v1
确保 OPENAI_API_KEY 使用的是 HyperAPI 生成的 Key

常见问题：

如果提示认证失败，检查 OPENAI_API_KEY
如果提示模型不可用，换成平台已开放的模型
如果请求失败，确认 provider 走的是 responses 而不是其他协议

8. 如何选择模型

常见建议如下：

日常轻量对话：选择便宜、速度快的小模型
高质量写作与复杂推理：选择更强的主力模型
代码生成：优先选择代码能力更强的模型
长文本处理：确认模型上下文长度是否满足需求
图像与音频：使用对应的图片或音频接口，不要误用聊天接口

如果你不确定选哪个模型，建议先从平台里价格较低、兼容性较好的模型开始测试，再逐步切换到更强模型。

9. 计费说明

HyperAPI 的实际扣费通常与以下因素有关：

模型单价
输入 Token 数
输出 Token 数
缓存命中或特殊计费项
图片、音频、向量等非文本接口的单独计费规则

注意：

不同模型的价格差异可能很大
同一个模型在不同时间也可能调整价格
最终以控制台中的模型价格页、余额变化和消费日志为准

10. 常见问题

10.1 提示 `401 Unauthorized`

通常是以下原因：

API Key 填错
没有加 Bearer
令牌已被禁用或删除

10.2 提示 `403` 或模型不可用

通常说明：

当前 Key 没有权限调用该模型
该模型当前未开放
账户分组或额度策略限制了访问

10.3 提示余额不足

说明账户可用额度不足，需要先充值，或更换为更便宜的模型测试。

10.4 请求成功但没有内容

建议排查：

模型名称是否正确
客户端是否使用了错误的接口格式
是否开启了流式输出但客户端没有正确读取流

10.5 为什么同一个问题扣费不同

因为影响扣费的不只是提问文本，还包括：

上下文历史长度
输出长度
模型价格
是否命中缓存

11. 安全建议

不要把 API Key 写死在前端代码里
不要把 Key 提交到 GitHub 等公开仓库
建议不同用途使用不同 Key
发现 Key 泄露后，立即删除并重新创建
服务端项目建议配合调用频率限制与用量监控

12. 推荐排错流程

当你接入失败时，按这个顺序排查最快：

确认站点能正常登录，账户余额充足
确认令牌已创建且可见
先查看控制台模型页，或请求 GET /v1/models 确认模型名
用 cURL 直接测试 chat/completions
确认 base_url 是否填成了 https://hyperapi.cc/v1
确认模型名与平台实际支持的模型一致
再去排查第三方客户端自身配置

13. 一份最小可用配置

如果你只想尽快跑通，可以直接记住下面三项：

text

Base URL: https://hyperapi.cc/v1
API Key: sk-你的密钥
接口: /chat/completions

最小示例请求体：

json

{
  "model": "你的模型名",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ]
}

14. 免责声明

请遵守模型提供方的使用政策以及你所在地区的法律法规，不要将平台用于违规、侵权、滥用或其他非法用途。

15. 联系方式

如需咨询、反馈问题或获取支持，可以通过以下方式联系：

Telegram: https://t.me/hyperapiai
QQ 群：1095326876

1. 平台简介

2. 快速开始

3. 注册、登录与充值

3.1 注册账号

3.2 充值额度

4. 创建 API Key

5. 接口地址说明

5.1 OpenAI 兼容

5.2 Claude 兼容

5.3 Gemini 兼容

6. 第一次 API 调用

6.1 使用 cURL

6.2 Python 示例

6.3 Node.js 示例

7. 常用第三方客户端配置

7.1 Cherry Studio

7.2 ChatBox

7.3 NextChat / LobeChat / Open WebUI

7.4 Claude Code

7.5 Codex CLI

8. 如何选择模型

9. 计费说明

10. 常见问题

10.1 提示 401 Unauthorized

10.2 提示 403 或模型不可用

10.3 提示余额不足

10.4 请求成功但没有内容

10.5 为什么同一个问题扣费不同

11. 安全建议

12. 推荐排错流程

13. 一份最小可用配置

14. 免责声明

15. 联系方式

10.1 提示 `401 Unauthorized`

10.2 提示 `403` 或模型不可用