Guide · 使用手册

从注册到上线 一次看懂接入全流程

覆盖控制台操作、Kimi API 四步接入、Kimi Code CLI 与用量计费的企业级使用指南,附 2 分钟完整演示动画。

00 · Demo

两分钟,看完全部流程

控制台创建 Key → Kimi API 首次调用 → Kimi Code CLI 接入 → 用量与计费,双主线完整演示。

约 2 分钟 · 进入画面自动播放,可点击进度条跳幕、暂停或全屏。 在新窗口打开演示 ↗

01 · Quickstart

Kimi API 四步快速接入

Kimi API 完全兼容 OpenAI 格式:一个 Key、一个 base_url,即可调用全系旗舰模型。

  1. STEP 01

    创建 API Key

    所有调用均通过 API Key 鉴权。按业务创建独立 Key,便于分账、审计与轮换。

    • 登录 CSI MaaS 控制台
    • 进入「API Keys」,点击「新建 API Key」
    • 以业务命名(如 prod-backend),创建后立即复制保存

    Key 仅完整展示一次。请勿硬编码进代码或提交至代码仓库;如泄露请立即在控制台撤销。

  2. STEP 02

    配置环境变量

    推荐将 Key 写入环境变量 CSI_API_KEY,与代码彻底分离,杜绝泄露风险。

    • 建议写入 shell 配置文件(~/.bashrc / ~/.zshrc)持久生效
    • Windows 使用 setx 后需重新打开终端
    终端
    export CSI_API_KEY="sk-csi-xxxxxxxx"
  3. STEP 03

    安装 SDK

    Kimi API 兼容 OpenAI API 格式,直接使用 OpenAI 官方 SDK 即可;也可不经 SDK,直接调用 HTTP API。

    • Python 3.8+ 或 Node.js 18+
    • OpenAI SDK 1.0.0 及以上版本
    终端
    pip install --upgrade 'openai>=1.0'
  4. STEP 04

    发起第一次调用

    base_url 指向 https://maas.jointpilot.com/v1,模型默认从 kimi-k3 开始;编程场景可换用 kimi-k2.7-code-highspeed,通用场景可换用 kimi-k2.6

    • K3 通过 reasoning_effort 配置推理强度(low / high / max,默认 max)
    • 成功响应示例:200 OK · 流式逐字返回 · 返回 tokens 用量
    main.py
    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)

02 · Kimi Code

Kimi Code CLI 五步上手

运行在终端中的 AI 编程 Agent — 直接使用控制台创建的 API Key 完成接入。

01

安装

一行命令完成安装,自动校验并加入 PATH。

curl … install.sh | bash
02

启动

进入你的项目目录,输入命令启动交互界面。

kimi
03

登录

输入 /login,选择「Kimi Platform(API Key · 企业接入)」,粘贴控制台创建的 Key。

/login
04

选择模型

校验通过后自动拉取可用模型,编程场景推荐 kimi-k2.7-code-highspeed。

kimi-k2.7-code-highspeed
05

验证

查看接入状态,然后直接下达第一个任务。

/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 字段。

KIMI K3 推荐

旗舰模型kimi-k3

迄今能力最强:1M token 超长上下文与视觉理解,适合知识工作、深度推理与编程 Agent 等复杂场景。

1,048,576 tokens 视觉理解 reasoning_effort

输入 ¥2 起 · 输出 ¥100 / 1M tokens

KIMI K2.7-CODE

编程高速kimi-k2.7-code-highspeed

面向代码生成、代码修改与编程 Agent:更高输出速度,是 Kimi Code CLI 与 IDE 插件的理想搭档。

262,144 tokens 代码能力 高输出速度

输入 ¥1.3 起 · 输出 ¥27 / 1M tokens

KIMI K2.6

通用均衡kimi-k2.6

通用场景的均衡之选:文档总结与写作、客服与业务助手等高频任务,兼顾能力与成本效率。

262,144 tokens 通用能力 高性价比

输入 ¥1.1 起 · 输出 ¥27 / 1M tokens

04 · FAQ

常见问题

接入、调用、计费与 Kimi Code CLI 的高频问题。未覆盖的问题请联系专属支持。

API Key 校验失败怎么办?

请依次检查:Key 是否复制完整、是否混入多余空格;Key 是否已被撤销或过期;账户余额是否充足。

在 Kimi Code CLI 中,还需确认所选平台与 Key 来源一致(企业 Key 请选择「Kimi Platform(API Key · 企业接入)」)。仍失败时,请在控制台重新创建 Key 后重试。

调用返回 429(限流)如何处理?

平台按账户套餐限制每秒/每分钟的调用频率。建议在客户端实现指数退避重试(如 1s → 2s → 4s),并控制并发。

企业客户如需更高配额,请通过 联系我们 提交扩容申请。

如何查看用量、账单与充值?

控制台「用量统计」支持按天与按模型查看 Token 消耗;「费用中心」支持在线充值、账单查询与发票申请,余额实时到账。

上下文缓存如何计费?

首次读取按「缓存未命中」价格计费,重复上下文按「缓存命中」价格计费(命中价格显著更低)。多轮对话与长文档场景会自动受益,无需额外配置。详见 API 定价一览

Kimi Code CLI 执行 /login 没有反应?

/login 需要在 CLI 空闲时执行。如果正在生成内容或执行任务,请等待任务结束,或先按 Esc / Ctrl-C 中断后重试。

若登录后没有显示可用模型,请重新执行 /login;仍无法加载时,先升级 Kimi Code CLI 再检查账户状态。

API Key 会过期吗?如何安全轮换?

Key 在控制台撤销前持续有效。建议按业务创建独立 Key 并定期轮换:先新建 Key 并切换业务流量,确认稳定后再撤销旧 Key,避免服务中断。

让大模型能力,快速变成业务能力

即刻开启企业级 MaaS 接入与 Token 服务。