Moonshot API 基础 URL:将代码指向别处
Moonshot API 基础 URL 只是你的 OpenAI 风格客户端中的一个字符串,更改它即可将相同的代码指向不同的提供商。本页面展示了该字符串在 Python、Node.js、curl 和常用工具中的位置,以及如何将其指向替代接口。
更新于


要点
- 基础 URL 是单个设置;请求正文保持 OpenAI 聊天格式。
- 切换时需更改三项:基础 URL、API 密钥、模型 ID。
- 我们的接口是 https://api.kimiapikey.com/v1,模型 ID 为 uncensored。
- 它是一个独立托管的模型,并非 Moonshot 的官方服务,因此请重新测试你的提示词。
基础 URL 的实际作用
OpenAI 兼容客户端通过基础 URL 和路径两部分构建每个请求。SDK 会将它们连接起来,因此对 chat.completions.create 的调用会变成向 <base_url>/chat/completions 发送 POST 请求。遵循此格式的提供商(包括 Moonshot)会在其文档中公布自己的基础 URL。请在那里查找,而不是从论坛帖子中复制,因为这是你无法猜测的唯一值。
因此,切换提供商只需进行三项编辑,无需其他操作:
- 基础 URL,决定请求发送的位置。
- API 密钥,由每个提供商单独颁发,仅在其服务器上有效。
- 模型 ID,因为每个提供商对其模型的命名方式不同。
消息、角色、流式输出、工具和 JSON 模式的结构保持一致,这就是迁移过程简短的原因。任何依赖于特定提供商功能(如内置网页搜索工具)的内容都需要单独处理。
将这三个值保存在一个配置块或每个提供商的一个环境文件中也有帮助。当基础 URL、密钥和模型 ID 并排显示时,切换回旧提供商只需更改一行,并避免新密钥与旧地址配对的不完整迁移状态。
Python:openai 包
在 Python 中,创建客户端时设置基础 URL。此示例连接到本站的接口:
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": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)
如果你希望代码中不包含设置,请使用环境变量。当你调用 OpenAI() 且不带参数时,SDK 会读取 OPENAI_BASE_URL 和 OPENAI_API_KEY,因此部署可以在不更改代码的情况下切换提供商。请注意,这也意味着 shell 中残留的变量可能会覆盖你在文件中写入的值。
Node 和 curl
官方 JavaScript 包使用相同的选项名称,采用驼峰命名法:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.kimiapikey.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Hello" }],
stream: false,
});
console.log(resp.choices[0].message.content);
如果完全没有 SDK,基础 URL 只是地址的前缀:
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":"Hello"}]}'
同一端点也接受 POST /v1/responses,而 GET /v1/models 列出其提供的服务。在所有情况下,认证均通过在 Authorization 请求头中使用 Bearer token 实现。
编辑器和聊天前端
GUI 工具在不同的标签下暴露基础 URL:“API base”、“Override OpenAI Base URL”、“Custom endpoint” 或 “Provider URL”。你粘贴的值与上述代码中的字符串相同,以 /v1 结尾。除非工具要求完整的 URL,否则不要粘贴完整的 /chat/completions 地址。
保存后,如果工具未获取列表,请手动添加模型 ID。某些编辑器会针对固定提供商验证密钥并拒绝自定义值,在这种情况下,请先寻找开启自定义或 OpenAI 兼容模式的设置。在 Cursor 中使用 Kimi 风格 API 密钥 一文详细介绍了其中一种工具。
切换提供商时发生的变化
格式匹配并不意味着行为匹配。在将生产流量迁移之前,请逐一检查以下要点:
- 输出风格。 不同的模型写作方式不同。运行你的真实提示词,而不是示例。
- 上下文大小。 此端点的上下文窗口为 100,000 token,包含提示词和补全部分。如果你的当前设置发送更长的提示词,请先修剪它们。
- 限制。 完整密钥允许 8 个并发请求和每分钟 300 个请求。超过任一限制,你将收到 HTTP 429,代码为
rate_limited或concurrency。 - 功能。 支持 SSE 流式输出、函数调用和 JSON 模式。不支持图像、音频和视频生成、嵌入和微调;这是一个纯文本 API。
- 命名。 该服务运行一个开放权重模型,旨在为合法的成人用途提供无内容拒绝的回答。它不是 Moonshot 的官方 API,也不是跨供应商的路由器。
一种中立的比较方法是将相同的十个提示词通过两个接口分别发送并记录日志,然后并排阅读答案。这需要几分钟,并省去猜测。
基础 URL 错误及其表现
切换后的大多数故障来自地址,而非密钥。以下是每种失误的表现形式及其修复方法。
| 错误 | 症状 | 修复方法 |
|---|---|---|
仅主机,无 /v1 | 每次调用返回 404 | 在末尾添加 /v1 |
| 粘贴了完整路径 | 错误中显示路径重复的 404 | 将地址截断回 /v1 |
| 尾部斜杠加手动路径连接 | URL 中的双斜杠 | 让 SDK 拼接路径 |
| 旧密钥,新 URL | 401 | 使用新提供商颁发的密钥 |
| 旧 URL,新密钥 | 来自旧提供商的 401 | 在仓库和 shell 中搜索旧地址 |
http:// 而非 https:// | 重定向或连接错误 | 全程使用 HTTPS |
查找残留项的快速方法是在项目和部署设置中搜索旧主机名。查看 .env 文件、CI 变量、Docker compose 文件和任何编辑器设置,因为单个遗忘的副本就足以将部分流量发送到旧提供商。
切换后的流式输出和工具
设置 stream: true,回复将以服务器发送事件的形式到达,并在末尾报告 token 使用情况。工具调用使用常规的 tools 和 tool_choice 字段,流式输出 tool_calls 并将结果作为带有 role: "tool" 的消息发送回去。如果你的代码已经为旧提供商处理了这些内容,它应该继续有效;在完全切换之前,请运行一次流式调用和一次工具调用进行确认。请记住,流式请求会占用并发槽位,直到流结束。
切换前的成本检查
此处的计费按 token 计算:每 1M 输入 token $0.15,每 1M 输出 token $0.50,从预付额度中扣除,无订阅。失败或被拒绝的请求不收费,且额度永不过期。对于其他提供商的费率,请查看其当前定价页面,因为这些会发生变化。
一个工作示例。假设一个请求包含 2,000 个输入 token 和 500 个输出 token:
- 输入:2,000 / 1,000,000 x $0.15 = $0.0003
- 输出:500 / 1,000,000 x $0.50 = $0.00025
- 总计:每次请求 $0.00055,因此 1,000 次请求的费用为 $0.55
最低充值金额为 $20,大额充值享有额外奖励:$50 起 +5%,$100 起 +10%,$200 起 +15%。仅支持加密货币(TRC20 上的 USDT、Base 上的 USDC),不再接受银行卡支付。详细信息请查看 定价页面,Kimi 专属说明见 Kimi API 密钥定价。
获取密钥并运行首次调用
使用 Google 或电子邮件和密码注册,然后打开 API 密钥页面。新用户只需点击一下即可领取 $0.50 试用额度,每人限领一次,有效期 7 天,无需信用卡。试用期间的密钥限制为 2 个并发请求和每分钟 60 个请求,这对于测试运行来说已经足够了。
将密钥粘贴到上面的 Python 代码片段中,运行它,并确认你收到了文本回复。文档 列出了所有参数,响应头 X-Request-Id 和 X-Balance-USD 有助于调试和余额跟踪。发送给服务的提示词不会用于训练。
更多指南
常见问题
该模型与 Moonshot 的官方 Kimi 相同吗?
不,我们托管的是一个经过调整以实现无审查的开放权重模型。它不是 GPT、Claude、Gemini、Grok、DeepSeek 或其他供应商的模型。这是一个运行在我们自己服务器上的独立模型。
你们对我的数据进行训练吗?
不。你的提示词和补全内容不会用于训练。我们重视隐私和透明度,因此你的数据仍归你所有。
速率限制是多少?
每个密钥每分钟限制为 300 个请求。最大请求体大小为 8 MB。这些限制旨在确保所有用户的稳定性能。
内容政策是什么?
该模型在成人、争议和创意主题方面无审查。但是,我们会屏蔽涉及未成年人的性内容。这是一个硬性限制,始终适用,无论你的订阅层级如何。
问答
更改 Base URL 时需要修改代码吗?
通常只需更改三个值:Base URL、API 密钥和模型 ID。只要新提供商支持,消息格式、流式输出和函数调用保持不变。
Base URL 必须以 /v1 结尾吗?
此接口支持:https://api.kimiapikey.com/v1. SDK 会自动添加 /chat/completions,因此请勿包含它。
这是 Moonshot 的官方 API 吗?
不是。它是一个位于 OpenAI 兼容 API 之后的独立托管开放权重模型。它不是 Moonshot 的服务,也不是跨供应商的路由器。
在哪里找到模型 ID?
使用密钥调用 GET /v1/models。在此接口上,模型 ID 为 uncensored。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。