快速接入
大部分情况你只需要改两个地方:base_url 和 API Key。模型名沿用你原来的写法,先拿一个模型跑通,再去模型广场挑别的。
① 复制 base_url → ② 在「令牌」页建一个 Key → ③ 发一条请求看返回里的 usage。第三步入账了,就说明链路和计费都通了。
一、两个值怎么填
| 项 | 填什么 | 注意 |
|---|---|---|
| Base URL | https://api.91kun.top/v1 |
多数客户端填到 /v1 为止;有些客户端会自动补 /v1,那就只填 https://api.91kun.top。填重了会变成 /v1/v1,表现为 404。 |
| API Key | 站内「令牌」页新建 | Key 只在创建时完整显示一次,先复制再关页面。忘了就删掉重建,不影响余额。 |
| 模型名 | 见模型广场 | 用广场上显示的完整模型 ID,别自己简写。gpt-5.5 和 gpt-5.5-x 是两个东西。 |
二、一键导入(省掉手填)
站内令牌页对下列客户端提供一键导入,能自动把地址和 Key 写进客户端配置。路径:登录 → 令牌 → 对应客户端按钮。
| 客户端 | 说明 |
|---|---|
| Cherry Studio | 跳转后自动写入服务商与 Key |
| CC Switch | 用于 Claude Code / Codex 的配置切换 |
| DeepChat | 自动安装服务商配置 |
| AionUI | 自动添加服务商 |
| Lobe Chat | 官方示例页,参数写在 URL 里 |
| AI as Workspace | 自动写入服务商(strict 兼容模式) |
| OpenCat | 以「加入团队」方式导入 |
| AMA 问天 | 写入服务地址与 Key |
有些浏览器会拦截自定义协议(cherrystudio:// 这类),表现为点了没反应。这时手动按上面第一章填三个值即可,效果一样。
三、curl 验证(不依赖任何客户端)
想先确认 Key 是好的,用这条最快。把 sk-你的Key 和模型名换掉:
curl https://api.91kun.top/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的Key" \
-d '{
"model": "deepseek-v4-flash",
"messages": [{"role":"user","content":"说一句你好"}]
}'
返回里重点看三段:
| 字段 | 看什么 |
|---|---|
model | 是不是你请求的那个模型(用来确认没被替换) |
usage | prompt / completion 各用了多少 token —— 这是对账的依据 |
finish_reason | 正常是 stop;length 表示被长度截断 |
流式(SSE)
加 "stream": true 即为流式。注意最后一块之后会有 data: [DONE];有些 SDK 会把 [DONE] 当 JSON 解析而报错,这是客户端问题,不是接口问题。
四、报错对照
以下是本站接口真实返回的格式,对照 message 看即可:
| 现象 | 真实返回 / 原因 | 怎么办 |
|---|---|---|
| HTTP 401 | {"error":{"message":"Invalid token ...","type":"new_api_error"}} |
Key 没带上、写错了、或已被删除。注意别把 Key 前后带空格或引号。 |
| HTTP 404 | 路径不对 | 九成是 base_url 写成 /v1/v1(客户端又自动补了一次 /v1)。 |
| 模型不存在 | 鉴权通过后才会校验模型名 | 先把 Key 问题排掉,再看模型名是否与模型广场完全一致。 |
| 报错里的 request id | 形如 request id: 2026... |
售后沟通时把这个 id 一起发出来,能直接定位到那一次调用。 |
在群里或任何公开场合求助时,不要把完整 Key 发出来。发请求、返回和 request id 就够了。
五、钱花在哪了
计费是按官方定价乘分组倍率,官方价本身公开,你可以自己乘一遍核对。日志页能看到每一次调用的模型、token 用量和扣费,两边对一遍就知道有没有出入。
另外分成多个倍率分组,低倍率分组的缓存命中没法保证,这点先讲在前面。介意的话先小额测。
按量余额 1 元起充,先充 1 元,挑一个便宜模型(比如 gemini-2.5-flash-lite 或 glm-5.3-flash),跑一段两三千字的真实任务,然后去日志页核对扣费。这一步五分钟,比自己算便宜不便宜可靠得多。
六、还没写到的
各客户端的逐步截图教程、错误码完整列表还在补。卡在具体某一步的话,站内页脚有售后群。被问得最多的问题会被优先写成文档。