跳到主要内容

GET CONNECTED

让第一条调用顺利返回

选择你熟悉的工具，使用当前可用的模型生成配置。教程可以直接分享，查看无需登录。

01

准备账户与密钥

先确认用途和价格，再把模型接到工具里。

登录并创建 API Key

给密钥命名，按需设置每日上限和模型白名单。明文只在创建时展示。

进入 API 控制台 ↗
02

生成你的接入配置

选择工具、模型和操作系统，按顺序复制设置命令、修改文件，再发起首次调用。

正在核对模型目录…

03

确认接通，也确认花费

在上方选择对应协议的 cURL 示例，替换密钥后运行。成功返回回复文本或向量后，到 API 调用记录核对模型、用量和结果，在 消费明细查看扣费依据。

调用会按实际用量计费。人民币标价，1 积分 = ¥1；一次请求各项费用合计后按 ¥0.002 向上取整。配置成功不代表后续请求一定成功，模型可用情况和账户额度可能变化。
04

遇到错误，按现象排查

保留错误代码和请求 ID，方便核对调用记录。

ChatGPT 普通聊天也会改用这个 API 吗？
这份配置用于桌面应用中的本地 Work / Codex 任务，以及读取同一配置的 Codex CLI 和 IDE 扩展。普通 Chat 聊天、网页版及云端任务不读取你电脑上的这份 provider 配置。请在桌面端选择本地任务；需要普通聊天客户端时，可在上方选择 Cherry Studio / ChatBox 教程。
桌面端提示缺少 HIVEMIND_API_KEY，或仍在使用原来的模型
检查密钥是否写入用户目录的 .codex/.env，文件名不要带 .txt；仅在终端 export 可能对桌面应用无效。若设置了 CODEX_HOME，配置和密钥文件应放在对应目录。确认 config.toml 的 model、model_provider 在顶层，provider 配置放在用户目录而非项目目录。保存后完全退出应用并新建本地任务；同时检查所选模型及已有配置覆盖。 要恢复原服务商，恢复原来的 model、model_provider 设置并重启、新建任务。
401：密钥不正确或已失效
检查密钥是否完整、是否带有多余空格、是否已撤销或过期。确认工具使用的是 HiveMind 的地址和密钥。在控制台查看密钥状态；不要把密钥发到公开群聊。
402：余额或消费额度不足
检查可用积分、密钥总额度及账户和密钥的每日消费上限。根据响应中的错误说明充值或调整额度；单纯重试不能解除额度限制。
403：权限、审核或账户限制
查看具体错误代码和说明。检查密钥的模型白名单；若提示内容审核或账户限制，按提示处理，切换密钥不会解除账户限制。
404：模型或接口不存在
从当前目录重新选择模型，复制完整模型 ID。OpenAI 兼容 Base URL 以 /v1 结尾；Anthropic SDK 的 Base URL 以 /anthropic 结尾，由 SDK 追加 /v1/messages。不要重复拼接 /v1。
429：请求频率或并发达到限制
按响应中的错误说明区分频率、并发和用量限制。降低并发，稍后重试；检查账户与密钥的剩余额度。立即密集重试可能继续触发限制。
5xx、超时或回答中途断开
先查看服务状态和公告，再检查本地网络。在控制台核对该请求的成功或失败记录及计费依据；如果重试，请注意一次新的调用可能产生新的费用。
缓存价格更低，为什么本次没命中？
缓存是否生效取决于模型、渠道和请求内容。价格目录列明的是计价规则，不保证每次命中。以实际消费明细中的缓存用量和价格快照为准。
为什么看不到某个工具可用的模型？
配置生成器只展示当前目录中可用且支持该接口的模型。Codex 使用 Responses；Claude Code 使用 Anthropic Messages。供应商名称相同不代表所有工具协议都已开放。

接入前请了解 API 数据处理与隐私政策。密钥只应保存在自己的工具或环境变量中，避免提交到代码仓库。