Kimi API Key 怎么获取？月之暗面 Moonshot API 从注册到调用全流程（2026）

Kimi API Key 获取：你需要知道的前置信息

想通过 API 调用 Kimi，第一步是搞清楚去哪儿拿 Key。

Kimi 的 API 服务由月之暗面（Moonshot AI）运营，入口是 platform.moonshot.cn。你在网上搜到的「Moonshot API」「月之暗面 API」「Kimi API」说的是同一套服务——域名 api.moonshot.cn，协议兼容 OpenAI 格式。

容易踩的坑：Kimi 那个聊天网站（kimi.moonshot.cn）和开发者平台是两套系统，聊天端的账号不等于开发者账号，密钥要在开放平台单独申请。

第一步：注册月之暗面开放平台

打开 platform.moonshot.cn，点右上角「注册」。

几个注意点：

• 手机号验证：目前只支持中国大陆手机号（+86），海外号注册会卡住
• 实名认证：个人认证填身份证就行，企业认证需要营业执照。个人认证足够日常开发使用，API 调用没有功能限制，只是并发配额低一些
• 审核时间：个人认证通常即时通过，企业认证 1-3 个工作日

注册成功后自动跳转到控制台。如果你之前注册过但忘了密码，用手机号走「忘记密码」流程即可。

第二步：创建 API 密钥

进入控制台后，在左侧导航找到「API 密钥」（有的版本叫「API Keys」），点进去。

操作很简单：

1. 点击「创建密钥」按钮
2. 给密钥起个名字（比如「测试环境」「生产项目-A」），方便后续区分
3. 系统生成密钥后会显示一次完整内容——立刻复制保存，页面关了就再也看不到了
4. 建议存到环境变量或密钥管理工具里，别硬编码到代码里

密钥格式类似 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx，以 sk- 开头。

密钥管理的几个实用建议

按项目/环境分开创建密钥，别所有地方用同一个。原因很现实：某个密钥泄露了（比如不小心提交到 GitHub），你只需要删掉那一个，不影响其他服务。

月之暗面平台支持同时持有多个有效密钥，删除某个密钥后用该密钥的请求会立刻失败，不需要等待生效。

第三步：确认免费额度

注册完第一件事，去「账户余额」或「用量统计」页面看一眼免费额度。

月之暗面给新用户的免费额度会随平台活动调整，不是一个固定数字。之前有段时间是送几十块钱等值的 token，足够跑通测试流程和做小规模实验。但这个策略可能随时变，以你注册时平台显示的为准。

免费额度用完后是预付费模式，充值后按实际 token 用量扣费。Kimi K2.5 的定价：

价格以月之暗面官网实时显示为准。想了解跨平台的模型价格对比，参考《Kimi K2.5 API 接入教程》中的价格表。

K2.5 的定价跟老的 moonshot-v1 系列差距很大。K2.5 输入端只要 ¥4/百万 token，v1-128k 要 ¥60，差了 15 倍。没有特殊的兼容性包袱，直接用 K2.5。

Moonshot API 调用：基础用法

拿到 Key，下一步是实际跑通一个请求。

月之暗面 API 兼容 OpenAI 协议。用过 OpenAI SDK 的话，改两个参数就能跑：

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://api.moonshot.cn/v1",
)

把 base_url 从 OpenAI 的地址换成 https://api.moonshot.cn/v1，api_key 填你刚才创建的密钥，完事。

可用的模型 ID

调用时 model 参数填这些值：

大部分场景直接用 kimi-k2.5 就行。性能最强、价格反而最低，没有用旧模型的理由，除非你的代码里写死了旧的模型 ID 暂时不想改。

Streaming 流式调用

实际产品里基本都用流式输出，用户不用等到模型生成完整个回答才看到内容：

stream = client.chat.completions.create(
    model="kimi-k2.5",
    messages=[{"role": "user", "content": "你的问题"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

流式模式下，首个 token 的延迟通常在 300-800ms，国内直连体验很顺畅。

不止月之暗面：通过 API 聚合平台管理多个模型

到这里，如果你只打算用 Kimi 一家的模型，上面的流程就够了。

但实际项目里很少只用一家。日常任务走 Kimi K2.5 省钱，复杂推理切 Claude Opus 4.6，超长文档丢给 Gemini 3.1 Pro。三个平台、三套密钥、三种计费，管理成本不低。

ofox.ai 这类聚合平台干的就是这件事：一个 API Key 调用 Kimi、Claude、GPT、Gemini、DeepSeek 等 100+ 模型，统一 OpenAI 兼容格式，切模型只改 model 参数。支持微信/支付宝充值，某家 API 挂了也能快速切替代方案。

调用方式跟直连月之暗面几乎一样：

client = OpenAI(
    api_key="your-ofox-key",
    base_url="https://api.ofox.ai/v1",
)
# model 改成带厂商前缀的格式
response = client.chat.completions.create(
    model="moonshotai/kimi-k2.5",
    messages=[{"role": "user", "content": "你的问题"}],
)

两种方式不矛盾。可以先在月之暗面官方平台注册测试，确认 Kimi 适合你的场景后，再切到聚合平台统一管理。

更完整的多平台接入方案对比，参考《不用信用卡也能用 AI API：国内开发者付费方案完全指南》。

常见问题和踩坑记录

”Invalid API Key” 怎么回事

九成是密钥复制不完整。sk- 前缀和末尾不能有空格或换行符。建议从控制台重新复制一次，粘贴到纯文本编辑器检查长度，再设到环境变量里。

另一种可能：密钥被删除了但你没同步。如果在控制台做过密钥清理，确认当前使用的密钥还在有效列表里。

429 Too Many Requests

月之暗面对不同认证级别有不同的频率限制（RPM/TPM）。免费额度阶段限制比较严。解决思路：

1. 加重试逻辑，建议用指数退避（第一次等 1 秒，第二次 2 秒，第三次 4 秒）
2. 控制并发数，别一次性发几十个请求
3. 如果业务量确实大，升级到付费计划或通过聚合平台调用，后者通常有更宽裕的配额

国内网络能直连吗

能。api.moonshot.cn 是国内服务器，不用代理。延迟 200-500ms，比 Claude、GPT 等海外模型的网络体验好不少。

moonshot-v1 和 kimi-k2.5 选哪个

直接用 kimi-k2.5。能力比 v1 系列好，价格反而更低。v1 系列算历史版本，还没下线但也不再重点维护了。

图片输入怎么用

Kimi K2.5 支持多模态输入，传图片需要用 base64 编码或者图片 URL。请求格式跟 OpenAI 的 vision 接口一样：

response = client.chat.completions.create(
    model="kimi-k2.5",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "这张截图里的 UI 有什么问题？"},
            {"type": "image_url", "image_url": {"url": "图片URL或base64"}},
        ],
    }],
)

K2.5 在视觉编程（截图→代码）这个场景下表现特别好，可以截一张 UI 设计稿让它直接写 HTML/CSS。

Kimi K2.5 更多的实际使用场景和能力评估，参考《Kimi K2.5 API 接入教程》。

Moonshot API 的其他能力

除了 Chat Completions，还有几个值得了解的接口。

文件上传和解析：直接传 PDF、Word 给模型，省掉自己写文档解析的麻烦。做文档问答系统的时候用得上。

Function Calling 方面，K2.5 的工具调用格式跟 OpenAI 的 tools 参数一致，已有的 function calling 代码基本不用改就能跑。

长上下文场景下还有上下文缓存机制，相同的 system prompt 和历史消息可以复用，减少重复计算。具体的 API 格式，月之暗面官方文档写得比较清楚。

密钥安全

几条基本原则：

1. 绝不要提交到代码仓库。用 .env 文件存密钥，.gitignore 里加上 .env*
2. 开发、测试、生产用不同密钥。出事时能快速隔离
3. 定期轮换。先创建新密钥、部署上去、再删旧的，零停机
4. 留意用量。控制台偶尔看一眼，用量突然飙升可能是密钥泄露

更完整的 API 安全和成本控制策略，参考《如何降低 AI API 成本？7 个实测有效的优化策略》。

回顾

拿 Kimi API Key 本身很快，注册、创建密钥、发请求，十分钟的事。后面真正要操心的是密钥管理和多模型调度。

只用 Kimi 一家，月之暗面官方平台够了。多家模型混着用的话，ofox.ai 这类聚合平台省事不少。

接下来可以看：

• 《Kimi K2.5 API 接入教程》 — 三种接入方式和价格对比
• 《OpenClaw 模型配置完全教程》 — 在 AI 编程工具里配 Kimi
• 《不用信用卡也能用 AI API》 — 国内付费方案