HUB2API / GETTING STARTED

连接你的 AI 工作流。

准备好已授权账号、个人 API Key 和控制台显示的可用模型 ID，即可开始配置客户端。

当前公众注册关闭；邀请码注册、邮件验证和在线充值仍在准备。请通过既有团队管理员获取访问安排。不要向其他用户分享你的 API Key。

01 · 登录与个人密钥

1. 打开 API 控制台，使用已有账号登录。
2. 查看管理员分配的余额、分组、可用模型和使用范围。
3. 在 API Key 页面创建自己的密钥；按实际需求设置额度、有效期和访问限制。
4. 将密钥保存到客户端私密配置或环境变量中，避免提交到 Git。

02 · 统一接入地址

控制台：https://api.hub2api.com
OpenAI 兼容 Base URL：https://api.hub2api.com/v1
模型 ID：以控制台和 /v1/models 实际返回为准
API Key：使用你自己创建的个人密钥

客户端如自动添加 /v1，请避免重复。Chat Completions、Responses 与 Anthropic Messages 是不同协议，必须匹配客户端提供商类型与实际模型渠道。

03 · Cherry Studio

1. 打开设置中的模型服务，添加自定义或 OpenAI 兼容服务商。
2. 填写上述 API 地址和个人 Key，添加实际模型 ID。
3. 先使用基础聊天完成连接测试，再单独验证所需的工具调用和流式功能。

普通聊天成功不能代表 Work 或 Agent 模式已验收。文件生成由客户端执行；使用前检查工具权限、执行位置和模型协议支持。Cherry Studio 官方文档 ↗

04 · Roo Code 与 Cline

在客户端提供商设置中选择与模型协议相符的兼容提供商，填写 Base URL、个人 API Key 和模型 ID。只有在模型实际支持工具调用后再启用 Agent；首次任务保留文件写入、终端与外部访问的人工确认。

Roo Code 官方兼容接入文档 ↗ · Cline 官方兼容接入文档 ↗

05 · OpenCode

通过 /connect 添加自定义服务商并私密保存 Key，再按当前安装版本配置端点与模型。不同主版本的配置结构可能不同，请优先使用安装版本对应的官方示例。

Chat Completions 与 Responses 需要相应的适配器；不要只替换 URL 后就假定 Agent 兼容。OpenCode 官方文档 ↗

06 · 用量、额度与密钥轮换

在控制台查询余额、调用记录与用量。额度由管理员及 Key 设置共同限制。怀疑密钥泄露时，先停用旧 Key，检查历史用量，再创建新 Key 并更新客户端。

07 · 无法调用时

• 401：检查 Key 是否正确、有效并已填入正确客户端字段。
• 403：检查账号状态、模型组和权限；确认当前所在地与上游使用规则允许访问。
• 429：检查频率、并发限制与上游可用额度；降低请求频率。
• 模型不存在：核对实际模型 ID，避免凭名称猜测可用模型。
• 聊天可用，Agent 失败：检查工具调用参数、协议类型、多轮调用和客户端执行权限。
• 超时或 5xx：记录时间、模型及脱敏请求 ID，交给团队管理员排查，不发送完整 Key。

08 · 使用边界

Hub2API 提供 API 网关，不是 ChatGPT 官方 Work。请遵守适用法律、上游授权与团队规则，避免上传未经许可的个人信息或未发表敏感研究数据。真实支付未开放；不要向陌生账户或收款码转账。

← 返回 Hub2API 首页