如何获取 Kimi K3 API Key(2026年7月)
Kimi K3 是月之暗面最新旗舰:2.8 万亿参数、100 万 Token 上下文、7月27日开放权重。本指南涵盖注册、创建密钥、首次 API 调用、常见报错排查及定价对比。
1)Kimi K3 是什么?
2026 年 7 月 16 日,月之暗面在世界人工智能大会(WAIC)上正式发布 Kimi K3,参数规模达 2.8 万亿,是目前全球参数最大的开源 AI 模型。K3 基于 KDA(Kimi Delta Attention)混合线性注意力架构,原生支持视觉理解,上下文窗口达 100 万 Token。
基准测试显示 K3 在编程、推理和长上下文任务上性能对标 Claude Opus 级别。月之暗面官方承诺将于 2026 年 7 月 27 日前发布完整模型权重,任何人均可下载、本地运行和自由微调。
2)注册月之暗面开放平台
访问 platform.moonshot.cn,使用手机号或微信账号注册。新用户通常可获得约 15 元体验额度,足够测试数十万 Token。
需要完成实名认证才能解锁完整配额和充值功能,这是国内 AI 平台的标准流程。注册后可先用赠送额度进行测试,验证完成前不影响基础使用。
3)创建 API Key
登录后,点击左侧菜单「API Key 管理」,点击「新建」,填写描述性名称(例如项目名),点击确定创建。
Key 只在创建后完整显示一次,请立即复制并保存到密码管理器或密钥系统中,之后无法再次查看完整内容。
- 访问 platform.moonshot.cn/console/api-keys
- 点击「新建」→ 填写名称 → 点击确定
- 立即复制 Key,创建后不再显示完整内容
4)发起第一次 Kimi K3 API 请求
Kimi K3 API 兼容 OpenAI Chat Completions 格式,Base URL 为 https://api.moonshot.cn/v1,模型 ID 为 kimi-k3。如果已在使用 OpenAI SDK,只需替换 base URL 和 API Key 即可。
将 MOONSHOT_API_KEY 设置为服务端环境变量,仅在后端调用 API,不要在前端代码、移动端或公开仓库中暴露密钥。
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["MOONSHOT_API_KEY"],
base_url="https://api.moonshot.cn/v1",
)
response = client.chat.completions.create(
model="kimi-k3",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Summarize the key features of Kimi K3."}
]
)
print(response.choices[0].message.content)Python — 使用 OpenAI SDK,替换 base URL 指向月之暗面
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.MOONSHOT_API_KEY,
baseURL: "https://api.moonshot.cn/v1",
});
const response = await client.chat.completions.create({
model: "kimi-k3",
messages: [
{ role: "system", content: "You are a helpful assistant." },
{ role: "user", content: "What is Kimi K3's context window size?" }
]
});
console.log(response.choices[0].message.content);JavaScript / Node.js — 同样的 OpenAI 兼容方式
curl https://api.moonshot.cn/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MOONSHOT_API_KEY" \
-d '{
"model": "kimi-k3",
"messages": [
{"role": "user", "content": "Hello, Kimi K3!"}
]
}'cURL — 快速验证 Key 是否正常工作
5)常见报错与解决方法
调用 Kimi API 时的报错大多属于三类:身份验证失败(401)、超出限流(429)、上下文长度超限(400)。以下是各类报错的排查和修复方法。
401 错误几乎都是 Key 传入方式有问题。检查 Authorization 请求头是否为 Bearer <空格> <key>,以及 MOONSHOT_API_KEY 是否因复制粘贴带入了多余的空格。
- 401 Unauthorized → 检查 MOONSHOT_API_KEY 已设置,且前后无多余空格
- 401 Unauthorized → 确认请求头格式为 Authorization: Bearer <空格> <key>
- 429 Too Many Requests → 添加指数退避重试;在 platform.moonshot.cn/console/limits 查看配额
- 400 Bad Request(上下文过长)→ Kimi K3 支持最多 100 万 Token;输入超限时需分段
- 400 Bad Request(模型无效)→ 模型 ID 必须为 kimi-k3(全小写,连字符)
6)定价对比——K3 vs K2.5 vs Claude Sonnet 5
Kimi K3 定价为:输入 $3/M Tokens(缓存未命中)、$0.30/M Tokens(缓存命中),输出 $15/M Tokens。100 万 Token 上下文窗口统一定价,不因输入长度分级加收。
此定价与 Claude Sonnet 5 持平,明显高于 Kimi K2.5(输入 $0.60/M、输出 $2.50/M)。月之暗面有意将 K3 定位为前沿旗舰,而非性价比产品。对成本敏感的场景,K2.5 仍然可用。
- Kimi K3:$3 输入(冷)/ $0.30 输入(缓存)/ $15 输出(每百万 Tokens)
- Kimi K2.5:$0.60 输入 / $2.50 输出(每百万 Tokens)
- Claude Sonnet 5:$3 输入 / $15 输出(每百万 Tokens)
- K3 独特优势:100 万 Token 上下文窗口统一定价,不因长度加收额外费用
常见问题
Kimi K3 的开源权重什么时候可以下载?
月之暗面官方宣布完整模型权重将于 2026 年 7 月 27 日前发布,技术报告也将随权重同步公开。发布前可通过官方 API 使用 K3。
Kimi K3 兼容 OpenAI SDK 吗?
兼容。月之暗面 API 遵循 OpenAI Chat Completions 格式,将 base URL 改为 https://api.moonshot.cn/v1,设置 MOONSHOT_API_KEY,模型 ID 使用 kimi-k3,现有 OpenAI SDK 代码基本无需修改。
使用完整 100 万 Token 上下文窗口会额外收费吗?
不会。Kimi K3 按 Token 统一计费,不因上下文长度加收额外费用,在前沿模型中属于少见的定价方式。
不完成实名认证可以使用 K3 吗?
新用户可先用注册赠送额度(约 15 元)测试,无需立即实名。完整配额和充值功能需要完成实名认证后才能解锁。
相关供应商
参考来源
- 月之暗面 Kimi K3 官方公告(2026年7月16日)Moonshot AI · 核验日期 2026-07-21
- Kimi K3 API Key 控制台Moonshot AI Console · 核验日期 2026-07-21
- Kimi K3 定价文档($3/$15 per M tokens,缓存 $0.30)Moonshot AI Docs · 核验日期 2026-07-21
- 新华社:Kimi K3 全球最大开源模型报道Moonshot AI Docs · 核验日期 2026-07-21