keahi 新手接入教程

第一次用 API？你只需要准备三项：接口地址、API 密钥、模型 ID。API 是软件向模型提问的通道；本站管理密钥和用量，聊天窗口由你选择的软件提供。

第一步：登录，查看你能用的模型

打开「模型与接入教程」，选择自己的密钥，就能看到该密钥对应的模型目录。没有密钥时，先到API 密钥创建一把并选择管理员提供的分组。目录里列出不表示模型刚刚通过测试，实际调用还取决于上游状态、权限与额度。

点击模型卡片，复制完整模型 ID。不要猜模型名称，也不要照抄旧教程里的模型。每个用户应使用自己的密钥，不共享管理员密钥。

第二步：准备三项连接信息

通用 Base URL：https://keahi.cc/v1
API 密钥：从自己的密钥页复制，不是网站登录密码。
模型 ID：从当前密钥的模型目录中选择并完整复制。

不要把首页网址 /home 填进 API 地址。部分客户端自动添加 /v1，不要拼成 /v1/v1。复制含密钥的配置时不要公开截图或转发。

第三步：普通聊天，使用 Cherry Studio

Cherry Studio 是 Windows、macOS、Linux 上的图形界面聊天软件。从官网下载并安装，不需要会写代码。下面适用于 OpenAI 分组；其他分组应使用匹配的协议。

打开「设置 → 模型服务」，点击「添加」，选择 OpenAI 类型，名称填 keahi。按钮名称可能随软件版本略有变化。
API 密钥填你在本站复制的密钥；Cherry Studio 的 API 地址填根地址 https://keahi.cc，它会补全接口路径。打开服务商启用开关。
点击「获取模型列表／管理模型」，添加刚才选中的模型。没有自动显示时，手动添加，把模型 ID 原样粘贴到 keahi 提供商下面。
返回聊天或助手页面，新建对话，选择 keahi 和模型，发送「你好」。收到回答就接入成功。发送消息会扣除额度，本教程不会替你自动调用。
回到本站使用记录，查看模型、token 与扣费。

已有其他聊天软件？选择「OpenAI 兼容／自定义服务商」，按软件说明填写三项信息即可。不要将本站密钥填到要求登录 ChatGPT 的密码框。

「使用密钥」与「导入工具」怎么选？

「接入教程」会展示模型目录、可复制的地址和密钥、聊天软件步骤；「进阶」才是 Codex CLI、OpenCode 等编程工具的配置文件。CLI 表示在终端输入命令使用的工具，必须先安装，不是网页聊天按钮。

CC-Switch 是帮编程工具切换接口配置的可选电脑软件，不是模型，也不自带本站聊天窗口。安装 CC-Switch及目标编程工具后，点击本站「导入工具」，阅读说明，允许浏览器打开应用，在 CC-Switch 中确认导入、选中 keahi，再重启目标工具。不认识这些工具就用上面的普通聊天步骤。

导入按钮会把地址和密钥交给本机应用。没有弹出时检查安装和协议关联，或改用手动填写；网页无法可靠判断你是否安装成功。

报错时怎么办？

401：检查密钥是否完整、有无多余空格、是否已停用。
404／找不到模型：核对模型 ID、分组，以及地址中是否重复了 /v1；仍失败请联系管理员核实上游。
429：频率或额度限制，稍后再试，不要连续发送。
503：服务繁忙或上游不可用，按提示等待再试。

保留错误提示和请求编号给管理员排查，不要公开完整 API 密钥。

开发者：直接调用接口

将 YOUR_API_KEY 和 YOUR_MODEL 替换为你自己的密钥和目录内的模型 ID。执行会产生真实调用和用量。

curl "https://keahi.cc/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL","messages":[{"role":"user","content":"Hello"}]}'

Chat Completions：https://keahi.cc/v1/chat/completions；Responses：https://keahi.cc/v1/responses。模型可用性和价格以实际分组为准。