在 Cursor 中使用 Kimi 风格 API 密钥:设置指南
Cursor 可以连接到任何兼容 OpenAI 的接口,因此将其连接到此 API 只需四个字段和大约两分钟。本指南涵盖确切的值、证明密钥有效的测试以及你最可能遇到的错误。
更新于

要点
- Cursor 需要三个值:你的密钥、基础 URL https://api.kimiapikey.com/v1 和模型名称
uncensored。 - 先用 curl 测试密钥,以便轻松区分是 Cursor 端问题还是 API 端问题。
- 代理式编辑会发送大量提示词,因此请留意输入 token:每 1M 输入 $0.15,每 1M 输出 $0.50。
- 试用密钥允许 2 个并发请求,Cursor 的代理可能会超出此限制。完整密钥允许 8 个。
简短回答
如果你正在搜索如何在 cursor 中使用 kimi api 密钥,首先要知道的是,由其他提供商签发的密钥仅适用于该提供商自己的接口。本站的密钥适用于本站的接口,Cursor 接受它是因为该接口遵循 OpenAI 聊天补全格式。你粘贴密钥,将 Cursor 指向不同的基础 URL,并添加一个自定义模型名称。
完整的设置顺序如下:
- 创建账户并从API 密钥页面复制你的密钥。
- 打开 Cursor,进入设置,然后选择模型。
- 将密钥粘贴到 OpenAI API 密钥字段中。
- 开启基础 URL 覆盖并输入
https://api.kimiapikey.com/v1。 - 添加一个名为
uncensored的自定义模型并在聊天中选择它。
本文的其余部分将解释每个步骤,提供在编辑器外测试连接的方法,并列出通常会出现的问题。
此密钥是什么以及不是什么
本站出售一个开放权重模型的访问权限,由独立提供商运行,经过调优可在合法成人用途中无内容拒绝地回答。它不是 Moonshot、Kimi 或其他任何供应商的官方 API,也不是将你的请求转发给他人模型的网关。网站名称反映的是人们搜索的内容,而非服务运营方。如果你已经持有来自其他供应商的密钥,请继续使用该供应商的接口。这两个密钥不可互换。
你获得的是标准的 OpenAI 风格 API:POST /v1/chat/completions 和 GET /v1/models,Bearer 令牌认证,100,000 token 上下文窗口,流式输出,函数调用和 JSON 模式。仅支持文本。不支持图像生成、嵌入和微调,这在编辑器中很重要,因为 Cursor 中依赖这些功能的功能将不会使用此接口。Kimi API 密钥说明更详细地介绍了命名和替代方案。
对于编码来说,“无审查”具有实际意义。模型不会因为在任务中途遇到变量名或测试夹具看起来敏感就停止。用于你拥有系统的安全工具、充满杂乱字符串的日志解析器、爬虫、小说生成器和审核测试集是其他地方容易触发拒绝的工作类型。硬性限制仍然存在:绝禁止涉及未成年人的性内容。
Cursor 中的逐步设置
1. 获取密钥和试用额度
使用 Google 或电子邮件和密码注册。在 API 密钥页面,你可以一键领取 $0.50 的免费试用额度。无需绑定银行卡,有效期 7 天,每人限领一次。这足以完成几百次普通聊天请求,因此你可以在支付任何费用之前完成本指南。
2. 打开模型设置
在 Cursor 中,打开设置并找到模型部分。菜单标签在不同版本中会有所移动,因此请寻找名为 OpenAI API 密钥的字段以及用于覆盖 OpenAI 基础 URL 的开关或字段。这是两个重要的设置。
3. 填写三个值
| Cursor 字段 | 说明 |
|---|---|
| OpenAI API 密钥 | 来自仪表板的密钥 |
| 覆盖 OpenAI 基础 URL | https://api.kimiapikey.com/v1 |
| 自定义模型名称 | uncensored |
准确输入基础 URL。它以/v1结尾,没有尾部斜杠,也没有/chat/completions,因为客户端会自行添加路径。粘贴包含完整路径的 URL 会产生 404 错误,且错误消息很少说明原因。
4. 选择模型并发送消息
打开聊天面板,从模型列表中选择uncensored,并询问一个小问题,例如“编写一个解析 ISO 日期的函数”。如果回复以流式输出显示,则设置完成。如果 Cursor 显示错误,不要随机更改设置。转到下一部分并直接测试接口。
5. 了解覆盖的副作用
基础 URL 覆盖通常适用于你在 Cursor 中使用的每个 OpenAI 风格模型,而不仅仅是自定义模型。如果稍后切换回标准 OpenAI 模型,请先关闭覆盖,否则请求会带着此接口不提供的模型名称发送到这里。
在归咎编辑器之前测试密钥
终端两分钟可节省一小时的猜测。此请求执行 Cursor 所做的操作:发送带有 Bearer 令牌的聊天补全。
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the word ready."}],
"max_tokens": 20
}'
包含choices数组的 JSON 正文意味着密钥、URL 和模型名称均正确。还要检查响应标头。X-Balance-USD显示你的剩余额度,X-Request-Id值得保留,以便在需要追踪请求时使用。
使用官方 OpenAI SDK 在 Python 中的相同检查:
from openai import OpenAI
client = OpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ready."}],
max_tokens=20,
)
print(resp.choices[0].message.content)
你也可以使用GET /v1/models列出模型。Cursor 和类似客户端在按下验证按钮时有时会调用它,因此成功的模型调用是一个好兆头。如果 curl 有效但 Cursor 无效,则问题出在编辑器设置中,下表涵盖了通常的问题。
当模型在编辑器中编写代码时会发生什么变化
侧边栏聊天成本很低。带有几百 token 上下文的简短问题成本不到一分钱。附加文件、搜索结果和对话历史的编辑器功能成本更高,因为每个请求都会再次携带所有内容。模型具有在提示词和回复之间共享的 100,000 token 窗口,如果你附加一个大文件夹,Cursor 会毫不犹豫地填满大部分窗口。
这里有一个真实的计算。假设一个请求携带 40,000 个输入 token,模型回复 1,500 个 token:
- 输入:40,000 / 1,000,000 x $0.15 = $0.006
- 输出:1,500 / 1,000,000 x $0.50 = $0.00075
- 总计:每次请求 $0.00675,因此 100 次此类请求成本为 $0.675
对于一个繁忙的下午来说,这远低于一美元,但输入端占主导地位,所以节省费用的习惯是附加更少的文件,而不是发送更短的提示词。当话题改变时开始新的聊天,因为旧的历史记录在每一步都会再次付费。
API 支持函数调用,这是代理式编辑器功能所依赖的。模型决定调用工具,你的客户端运行它并将结果作为 role: "tool" 消息返回。任何模型驱动多步代理的效果取决于模型本身,所以在让它执行重构之前,请先在小任务上尝试一下。API 背后的一个开放权重模型意味着你获得一种行为,而不是一个选择菜单。
在 Cursor 自己的模型上运行的 Cursor 功能(如其选项卡补全)通常不由自定义密钥切换。请检查 Cursor 的当前文档,了解哪些功能接受自定义 OpenAI 风格接口,因为该列表在版本之间会发生变化。
常见错误及修复方法
| 症状 | 可能原因 | 修复方法 |
|---|---|---|
| 404 或“未找到” | 基础 URL 包含接口路径,或缺少/v1 | 准确使用https://api.kimiapikey.com/v1 |
| 401 未授权 | 粘贴的密钥中有额外空格或换行,或密钥已过期 | 从仪表板重新复制密钥并再次粘贴 |
| 未找到模型 | 模型名称拼写不同 | 使用 uncensored,小写,无其他内容 |
429 错误,代码为 concurrency | 你的密钥同时发出的请求过多 | 等待正在进行的请求完成,或使用完整密钥(支持 8 个并发) |
429 错误,代码为 rate_limited | 超过每分钟配额 | 请降低频率;试用密钥每分钟允许 60 次请求,完整密钥每分钟 300 次 |
429 错误,带有 Retry-After: 5 响应头 | 临时过载 | 五秒后重试 |
| 验证按钮失败,但 curl 命令有效 | 编辑器使用其已知晓的模型名称进行测试 | 跳过验证步骤,直接发送真实的聊天消息 |
并发错误值得注意,因为它常让试用密钥用户感到意外。试用密钥允许 2 个并发请求,而代理同时启动多个操作时,即使你没有主动操作,也可能超出该限制。流式输出也会占用其槽位,直到流结束,因此长回答会一直占用一个槽位。完整密钥允许 8 个并发请求和每分钟 300 次请求,这对于单个开发者来说已足够舒适。
失败和被拒绝的请求不会收费,因此错误后重试不会产生额外费用。你可以在 文档页面 上查看完整限制。
试用额度耗尽后付费
没有订阅。你可以使用 $20 到 $500 之间的任何整额金额充值预付额度,请求以每 100 万输入 token $0.15 和每 100 万输出 token $0.50 的速度消耗额度。额度永不过期,所以一个月没有编码成本也无需付费。$50 或以上的充值享有奖励:$50 起 +5%,$100 起 +10%,$200 起 +15%。你可以通过加密货币(TRC20 上的 USDT、Base 上的 USDC)支付。定价页面在一个地方列出了当前数字。
使用之前提到的 40,000 输入、1,500 输出的请求,$20 的充值大约可覆盖 2,960 次此类请求($20 / $0.00675)。大多数编辑器请求更小,因此实际可执行次数更高。你的提示词不会用于训练,当粘贴的代码属于客户时,这一点很重要。
完成设置后,一个合理的初始任务是你可以快速审查的小任务:为现有函数编写单元测试、带有长注释的正则表达式,或重写一个噪声较多的文件。如果结果符合你的工作流,请增加额度。如果不符合,你仅花费了几美分的试用额度来验证。
更多指南
常见问题
该模型与 Moonshot 的官方 Kimi 相同吗?
不,我们托管的是一个经过调整以实现无审查的开放权重模型。它不是 GPT、Claude、Gemini、Grok、DeepSeek 或其他供应商的模型。这是一个运行在我们自己服务器上的独立模型。
你们对我的数据进行训练吗?
不。你的提示词和补全内容不会用于训练。我们重视隐私和透明度,因此你的数据仍归你所有。
速率限制是多少?
每个密钥每分钟限制为 300 个请求。最大请求体大小为 8 MB。这些限制旨在确保所有用户的稳定性能。
内容政策是什么?
该模型在成人、争议和创意主题方面无审查。但是,我们会屏蔽涉及未成年人的色情内容。这是一个硬性限制,始终适用,无论你的订阅层级如何。
问答
我能否将 Moonshot 或 Kimi 的密钥配合此 基础 URL 放入 Cursor?
不能。密钥仅适用于签发该密钥的提供商的接口。请在此处使用仪表板中的密钥,或保留另一个密钥及其提供商的 URL。
我在 Cursor 中应输入什么模型名称?
输入 uncensored,小写。这是该 API 提供的唯一模型 ID,输入其他名称会返回模型未找到错误。
它是否支持 Cursor 的代理模式?
该 API 支持函数调用,这是代理功能所必需的。模型完成长多步任务的可靠性因情况而异,因此建议先在小任务上测试,再执行大任务。
为什么试用密钥会出现 429 错误?
试用密钥允许 2 个并发请求和每分钟 60 次请求。完整密钥允许 8 个并发请求和每分钟 300 次请求。出现 Retry-After: 5 响应头表示短暂的过载,你可以稍后重试。
我的代码会被用于训练吗?
不可以。发送到 API 的提示词不会用于训练。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。