深空 API文档

快速接入

大部分情况你只需要改两个地方:base_url 和 API Key。模型名沿用你原来的写法,先拿一个模型跑通,再去模型广场挑别的。

最后更新:2026-09-26
三步跑通

① 复制 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是不是你请求的那个模型(用来确认没被替换)
usageprompt / 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

在群里或任何公开场合求助时,不要把完整 Key 发出来。发请求、返回和 request id 就够了。

五、钱花在哪了

计费是按官方定价乘分组倍率,官方价本身公开,你可以自己乘一遍核对。日志页能看到每一次调用的模型、token 用量和扣费,两边对一遍就知道有没有出入。

另外分成多个倍率分组,低倍率分组的缓存命中没法保证,这点先讲在前面。介意的话先小额测。

建议的第一次测试

按量余额 1 元起充,先充 1 元,挑一个便宜模型(比如 gemini-2.5-flash-lite 或 glm-5.3-flash),跑一段两三千字的真实任务,然后去日志页核对扣费。这一步五分钟,比自己算便宜不便宜可靠得多。

六、还没写到的

各客户端的逐步截图教程、错误码完整列表还在补。卡在具体某一步的话,站内页脚有售后群。被问得最多的问题会被优先写成文档。

当前价格、模型和限制以当天页面为准。