安装
一行命令完成安装,自动校验并加入 PATH。
curl … install.sh | bash00 · Demo
控制台创建 Key → Kimi API 首次调用 → Kimi Code CLI 接入 → 用量与计费,双主线完整演示。
01 · Quickstart
Kimi API 完全兼容 OpenAI 格式:一个 Key、一个 base_url,即可调用全系旗舰模型。
所有调用均通过 API Key 鉴权。按业务创建独立 Key,便于分账、审计与轮换。
Key 仅完整展示一次。请勿硬编码进代码或提交至代码仓库;如泄露请立即在控制台撤销。
推荐将 Key 写入环境变量 CSI_API_KEY,与代码彻底分离,杜绝泄露风险。
export CSI_API_KEY="sk-csi-xxxxxxxx"
setx CSI_API_KEY "sk-csi-xxxxxxxx"
Kimi API 兼容 OpenAI API 格式,直接使用 OpenAI 官方 SDK 即可;也可不经 SDK,直接调用 HTTP API。
pip install --upgrade 'openai>=1.0'
npm install openai@latest
# 无需安装任何依赖
# 直接以 HTTP 调用 https://maas.jointpilot.com/v1
将 base_url 指向 https://maas.jointpilot.com/v1,模型默认从 kimi-k3 开始;编程场景可换用 kimi-k2.7-code-highspeed,通用场景可换用 kimi-k2.6。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["CSI_API_KEY"],
base_url="https://maas.jointpilot.com/v1",
)
completion = client.chat.completions.create(
model="kimi-k3",
messages=[{"role": "user", "content": "你好,请用一句话介绍中软国际"}],
reasoning_effort="high",
)
print(completion.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.CSI_API_KEY,
baseURL: "https://maas.jointpilot.com/v1",
});
const completion = await client.chat.completions.create({
model: "kimi-k3",
messages: [{ role: "user", content: "你好,请用一句话介绍中软国际" }],
reasoning_effort: "high",
});
console.log(completion.choices[0].message.content);
curl https://maas.jointpilot.com/v1/chat/completions \
-H "Authorization: Bearer $CSI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kimi-k3",
"messages": [{"role": "user", "content": "你好,请用一句话介绍中软国际"}]
}'
02 · Kimi Code
运行在终端中的 AI 编程 Agent — 直接使用控制台创建的 API Key 完成接入。
一行命令完成安装,自动校验并加入 PATH。
curl … install.sh | bash进入你的项目目录,输入命令启动交互界面。
kimi输入 /login,选择「Kimi Platform(API Key · 企业接入)」,粘贴控制台创建的 Key。
/login校验通过后自动拉取可用模型,编程场景推荐 kimi-k2.7-code-highspeed。
kimi-k2.7-code-highspeed查看接入状态,然后直接下达第一个任务。
/status# 安装(macOS / Linux;Windows 请使用 PowerShell 安装方式,见官方文档)
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
# 启动并登录(选择 Kimi Platform · 粘贴 API Key · 选择模型)
kimi
> /login
# 验证接入,然后下达第一个任务
> /status
> 请查看当前项目,并简要说明目录结构
已在使用其他登录方式?无需退出程序,在会话中重新执行 /login 即可切换到 CSI MaaS 企业 Key;更换 Key 同理。遇到问题请先看下方 常见问题。
03 · Models
不确定如何选择时,默认从 kimi-k3 开始;按场景切换只需替换 model 字段。
迄今能力最强:1M token 超长上下文与视觉理解,适合知识工作、深度推理与编程 Agent 等复杂场景。
输入 ¥2 起 · 输出 ¥100 / 1M tokens
面向代码生成、代码修改与编程 Agent:更高输出速度,是 Kimi Code CLI 与 IDE 插件的理想搭档。
输入 ¥1.3 起 · 输出 ¥27 / 1M tokens
通用场景的均衡之选:文档总结与写作、客服与业务助手等高频任务,兼顾能力与成本效率。
输入 ¥1.1 起 · 输出 ¥27 / 1M tokens
04 · FAQ
接入、调用、计费与 Kimi Code CLI 的高频问题。未覆盖的问题请联系专属支持。
请依次检查:Key 是否复制完整、是否混入多余空格;Key 是否已被撤销或过期;账户余额是否充足。
在 Kimi Code CLI 中,还需确认所选平台与 Key 来源一致(企业 Key 请选择「Kimi Platform(API Key · 企业接入)」)。仍失败时,请在控制台重新创建 Key 后重试。
平台按账户套餐限制每秒/每分钟的调用频率。建议在客户端实现指数退避重试(如 1s → 2s → 4s),并控制并发。
企业客户如需更高配额,请通过 联系我们 提交扩容申请。
控制台「用量统计」支持按天与按模型查看 Token 消耗;「费用中心」支持在线充值、账单查询与发票申请,余额实时到账。
首次读取按「缓存未命中」价格计费,重复上下文按「缓存命中」价格计费(命中价格显著更低)。多轮对话与长文档场景会自动受益,无需额外配置。详见 API 定价一览。
/login 需要在 CLI 空闲时执行。如果正在生成内容或执行任务,请等待任务结束,或先按 Esc / Ctrl-C 中断后重试。
若登录后没有显示可用模型,请重新执行 /login;仍无法加载时,先升级 Kimi Code CLI 再检查账户状态。
Key 在控制台撤销前持续有效。建议按业务创建独立 Key 并定期轮换:先新建 Key 并切换业务流量,确认稳定后再撤销旧 Key,避免服务中断。