HUIBAO AI / GETTING STARTED
从注册,到第一次成功调用。
按下面的顺序完成准备与配置。先用少量请求确认模型、费用和兼容性,再用于实际任务。
01 / 注册与准备
- 进入注册页面,使用能够正常接收邮件的邮箱注册。
- 完成注册页面要求的邮箱验证。未收到邮件时,先检查垃圾邮件和邮箱地址是否正确。
- 登录控制台,确认账号余额与可用功能。
- 先查看价格和分组限制,再根据控制台显示的充值方式、金额与到账规则按需充值。新用户注册并完成邮箱验证,即送 ¥3 体验额度,仅用于 DeepSeek Flash。每位用户限领一次,老用户不补发。
首次使用建议从你能接受的小额用量开始,完成实际调用后再核对账单。
02 / 按你的工具和任务选择分组
创建 API Key 前,先去模型价格页查找目标模型,确认它所在的分组。不要仅凭分组名称判断接口、性能或限制。
| 你要做什么 | 先确认什么 |
|---|---|
| 使用 Claude Code | 选择支持 Anthropic 协议及该客户端的分组。标注“仅限 claude 客户端”的分组只接受官方 Claude Code 客户端请求。 |
| 使用 Codex 等编程工具 | 确认目标分组支持该工具需要的接口;使用 Responses 的工具不能直接按 Chat Completions 示例配置。 |
| 使用通用聊天应用或 SDK | 确认客户端允许填写自定义地址,并与分组支持的协议、模型及能力一致。 |
| 进行批量或长文本任务 | 比较输入、输出、缓存费用,并确认上下文档位、时段价格与并发限制。 |
03 / 填写地址、API Key 和模型名
- 在控制台的 API 密钥管理页面创建密钥,并选定目标分组。保存完整密钥,不要把登录密码填入 API Key。
- 在客户端里填写兼容的服务地址。域名和
/v1只应各出现一次。 - 填写该分组支持的模型标识。复制价格页或控制台中的模型名,不要把中文分组名当作模型名。
| 客户端要求 | 填写方式 |
|---|---|
| OpenAI 兼容 Base URL | https://huibaoai.com/v1 |
| 单独填写域名 / 服务根地址 | https://huibaoai.com;按客户端要求保留请求路径中的 /v1。 |
| Anthropic 协议客户端 | 服务根地址使用 https://huibaoai.com (不要再拼 /v1)。由客户端按该协议构造请求,并确认密钥分组允许该客户端。 |
| API Key | 使用本站控制台创建的密钥;不要使用登录密码或其他平台的密钥。 |
| 模型名 | 使用当前分组支持的完整模型标识,以本站价表及控制台为准。 |
如果请求地址出现 /v1/v1/,说明路径重复拼接,需要调整客户端的地址配置。
04 / 编程工具接入要点
Claude Code
按客户端的自定义服务地址方式配置本站域名和密钥。密钥分组需要支持 Anthropic 协议;“仅限 claude 客户端”分组请使用官方 Claude Code。填写后新开终端或重新启动客户端,确保配置生效。
Codex 等使用 Responses 的工具
先确认所选分组支持 Responses 接口,再按工具自己的配置格式填写自定义提供方、本站地址、密钥和模型名。不要把下面的 Chat Completions 请求当作 Responses 兼容性的验证。
支持自定义提供方的 IDE 或聊天客户端
先确认当前版本允许修改服务地址。填写地址、密钥和模型后,用短消息验证;界面中的“测试成功”不代表全部功能均兼容,仍需实际测试你的工作流。
05 / 用一个短请求验证接入
以下示例仅用于支持 Chat Completions 的 OpenAI 兼容分组。将模型名和密钥替换为自己的值;当前推荐先用 DeepSeek:deepseek-v4.1-flash-1017 或 deepseek-v4-pro-0813。不适用于限制客户端或仅支持其他接口的分组。详见 DeepSeek 快速上手。
API 调用会按实际用量计费。不要把密钥提交到代码仓库或发送给他人。
Windows PowerShell
替换 YOUR_MODEL_ID 与 YOUR_API_KEY 后,在本机 PowerShell 中执行。请勿分享包含真实密钥的命令记录。
$requestBody = @{
model = 'YOUR_MODEL_ID'
messages = @(@{ role = 'user'; content = '你好,请简短回答。' })
max_tokens = 64
stream = $false
} | ConvertTo-Json -Depth 5
$requestHeaders = @{
Authorization = 'Bearer YOUR_API_KEY'
}
Invoke-RestMethod `
-Method Post `
-Uri 'https://huibaoai.com/v1/chat/completions' `
-Headers $requestHeaders `
-ContentType 'application/json; charset=utf-8' `
-Body ([System.Text.Encoding]::UTF8.GetBytes($requestBody))macOS / Linux / Bash
替换同样的两个占位符;部分模型可能不支持 max_tokens,请根据所选分组的参数支持情况调整。
curl 'https://huibaoai.com/v1/chat/completions' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data '{
"model": "YOUR_MODEL_ID",
"messages": [{"role": "user", "content": "你好,请简短回答。"}],
"max_tokens": 64,
"stream": false
}'什么算第一次接入成功?
- 请求返回了预期的模型回复。
- 控制台出现对应的调用与用量记录。
- 模型、分组与扣费符合你的选择。
- 在实际使用的客户端中,也能完成一次真实任务。
本页提供配置示例;模型可用性、参数支持、余额和调用结果,以你的实际请求及平台当前服务情况为准。
05b / DeepSeek 第一次调用(当前主力)
站上现在主要在跑 DeepSeek。按下面配置,用 OpenAI 兼容接口即可验证。
| 项目 | 填写 |
|---|---|
| Base URL | https://huibaoai.com/v1 |
| 模型(Flash) | deepseek-v4.1-flash-1017 |
| 模型(Pro) | deepseek-v4-pro-0813 |
| 密钥分组 | 选择带「6折」的 DeepSeek 分组(分组倍率 0.6) |
| 高峰时段 | 北京时间工作日 09:00–12:00、14:00–18:00 为高峰价(约 2×);法定节假日除外 |
curl 示例(Flash)
curl 'https://huibaoai.com/v1/chat/completions' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data '{
"model": "deepseek-v4.1-flash-1017",
"messages": [{"role": "user", "content": "你好,请简短回答。"}],
"max_tokens": 64,
"stream": false
}'创建密钥时请选 DeepSeek / OpenAI 兼容分组,不要误用默认 Anthropic。客户端里的接口地址务必带 /v1。
计费说明(请先看)
- 价表展示的是本站售价(每百万 Token)。
- 实际扣费 ≈ 价表单价 × 分组倍率。当前 DeepSeek「6折」分组倍率为 0.6。
- DeepSeek 在北京时间工作日高峰(09:00–12:00、14:00–18:00)再按高峰价约 ×2(法定节假日除外)。
- 常见:空闲价 × 0.6;若价表已显示高峰价,则高峰单元格 × 0.6(不要再 ×2)。以控制台账单为准。
06 / 调用失败时按顺序检查
| 现象 | 优先检查 |
|---|---|
| 401 / 鉴权失败 | 是否使用本站创建的 API Key,密钥是否完整、有效,是否夹带空格,鉴权方式是否与接口协议一致。 |
| 403 / 无权使用 | 分组、客户端和目标模型是否匹配,是否存在客户端或访问限制;以返回的具体错误信息为准。 |
| 404 / 找不到接口或模型 | 服务地址与路径是否正确,有没有重复 /v1,模型名是否存在于当前分组。 |
| 400 / 参数不支持 | 接口是否匹配,模型是否支持所传参数。删除非必需参数后用最小请求复测。 |
| 429 / 请求受限 | 根据错误信息检查并发、调用频率或额度限制,降低并发并适当退避重试;不要立即循环轰炸接口。 |
| 余额不足 / 额度不足 | 查看余额、密钥额度及相关限制,按页面规则处理;充值后仍失败时联系管理员。 |
| 5xx / 超时 / 持续无响应 | 记录发生时间和请求 ID,检查客户端超时设置,间隔后重试;持续异常时联系管理员。 |
| 终端可以调用,客户端不行 | 核对客户端实际使用的接口、版本、密钥来源和地址;重新启动后再测,确认分组允许该客户端。 |
07 / 联系管理员时带上这些信息
联系管理员(微信):wxid_0k5wd75jqxv522
- 客户端名称、版本和操作系统。
- 发生时间、所用模型与分组名称。
- HTTP 状态码、具体错误信息及请求 ID(如有)。
- 已隐藏完整密钥、密码及个人内容的配置截图。
请勿提供管理员密码、完整 API Key 或无关的私人聊天内容。