文档中心

Appearance

✨费用中心控制台

使用 Kimi Code 集成 GenStudio API ​

Kimi Code 是 Moonshot AI 推出的终端 AI 编程助手。它支持在 config.toml 中添加第三方 Provider，可通过 GenStudio 的 OpenAI 兼容 Chat Completions 接口使用 Kimi 编程模型。

本文示例使用 kimi-k2.7-code。该模型按强制思考模型配置：Kimi Code 中应把 thinking 保持开启，并在模型能力中声明 always_thinking。

获取 API 接入信息 ​

在配置之前，先准备 GenStudio API Key 和模型 ID。

GenStudio 通用 LLM API ​

适用于按量付费、包并发服务等场景，可用于大语言模型、生图模型、视频模型等。LLM API 按 Token 计费，请关注账户余额。GenStudio 通用 LLM API 使用平台通用的 Base URL 和 Endpoints。

  • API Key：创建以 sk- 前缀的 API 密钥。详见 GenStudio API 快速集成。

    获取通用 API Key

    信息

    GenStudio 通用 LLM API 服务有 API 频率限制。租户在 GenStudio 的服务等级决定了 API 调用是否计费，以及享受的 API 频率上限。详见 LLM API 计费规则。

  • OpenAI (OpenAI Compatible)

    • Base URL: https://cloud.infini-ai.com/maas/v1
    • Endpoints
      • Create Chat Completion: /chat/completions
      • List Models: /models

通过 API 获取最新可用模型列表 ​

若需获取当前账号可用的模型 ID，建议调用模型列表接口。该接口仅返回当前可用的模型列表，不返回上下文长度、最大输出长度等模型元数据。请使用通用 API Key（sk- 前缀）查询。

language-shell
curl --request GET \
  --url 'https://cloud.infini-ai.com/maas/v1/models' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'

在控制台查看模型能力 ​

如需查看模型的上下文长度、最大输出长度和多模态能力，请前往模型广场查看对应模型卡片。配置 Kimi Code 时需要用到这些信息。

打开模型广场

安装 Kimi Code ​

Kimi Code 支持 macOS、Linux 和 Windows。建议使用官方安装脚本，安装脚本会下载最新版本并把 kimi 可执行文件加入 PATH。

  • macOS / Linux:

    language-bash
    curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

  • Windows PowerShell:

    language-powershell
    irm https://code.kimi.com/kimi-code/install.ps1 | iex

Windows 首次使用前请安装 Git for Windows。Kimi Code 在 Windows 上使用 Git Bash 作为 Shell 环境。

安装完成后运行以下命令验证：

language-bash
kimi --version

配置 Kimi Code ​

Kimi Code 的长期配置文件是 ~/.kimi-code/config.toml。如需迁移数据目录，可设置 KIMI_CODE_HOME；设置后配置文件位置变为 $KIMI_CODE_HOME/config.toml。

选择 Provider 类型 ​

通过 GenStudio 使用 Kimi 模型时，Provider 类型应设置为 kimi。

  • kimi：Kimi Code 的 Kimi / Moonshot OpenAI 兼容适配器。该适配器会发送 Kimi 原生 thinking 参数，并处理 reasoning_content。
  • openai：通用 Chat Completions 适配器。它主要使用 reasoning_effort，不作为本页示例的推荐配置。
  • anthropic：Anthropic Messages 协议适配器。仅在目标接入方式明确使用 Anthropic Messages 时选择。

写入 config.toml ​

将以下内容写入 ~/.kimi-code/config.toml。请把示例中的 API Key 替换为真实密钥。

language-toml
default_model = "genstudio/kimi-k2.7-code"

[providers.genstudio]
type = "kimi"
base_url = "https://cloud.infini-ai.com/maas/v1"
api_key = "sk-xxxxxxxxxx"

[models."genstudio/kimi-k2.7-code"]
provider = "genstudio"
model = "kimi-k2.7-code"
max_context_size = 262144
max_output_size = 131072
capabilities = ["thinking", "always_thinking", "tool_use", "image_in"]

[thinking]
enabled = true
keep = "all"

字段说明：

  • default_model：Kimi Code 启动后默认使用的模型别名，需与 [models."..."] 的表名一致。
  • type = "kimi"：使用 Kimi Code 的 Kimi Provider。通过 GenStudio 接入 kimi-k2.7-code 时优先使用该类型。
  • base_url：填写 GenStudio OpenAI Compatible Base URL，不要追加 /chat/completions。
  • api_key：填写以 sk- 开头的 GenStudio 通用 API Key。
  • model：发送给 GenStudio API 的真实模型 ID。
  • max_context_size：示例使用 256K 上下文。生产配置请以模型广场中的当前模型卡片为准。
  • max_output_size：限制 Kimi Code 每次请求发送的完成 Token 上限。kimi-k2.7-code 在 GenStudio API 中的最大输出上限为 131072；使用本页的 256K 上下文配置时，请同时设置该字段。
  • capabilities：声明 Kimi Code 可以为该模型启用的能力。always_thinking 表示该模型不能关闭思考；image_in 表示允许图片输入；tool_use 表示允许工具调用。
  • thinking.keep = "all"：保持工具调用和多轮会话中的推理上下文连续。使用 kimi-k2.7-code 时不要把 preserved thinking 作为可关闭能力来配置。

警告

Kimi Code 不会自动读取终端里 export GENSTUDIO_API_KEY=... 得到的普通 Shell 环境变量作为 Provider 凭据。长期使用时，请把 API Key 写入 config.toml 的 Provider 配置，或使用 Kimi Code 支持的临时 KIMI_MODEL_* 覆盖方式。

不把 API Key 写入长期配置 ​

如果只想在当前终端临时使用 GenStudio，可使用 Kimi Code 的 KIMI_MODEL_* 覆盖方式。该方式不会写回 config.toml，关闭终端后需要重新设置。

language-bash
export KIMI_MODEL_NAME="kimi-k2.7-code"
export KIMI_MODEL_PROVIDER_TYPE="kimi"
export KIMI_MODEL_BASE_URL="https://cloud.infini-ai.com/maas/v1"
export KIMI_MODEL_API_KEY="sk-xxxxxxxxxx"
export KIMI_MODEL_MAX_CONTEXT_SIZE="262144"
export KIMI_MODEL_MAX_COMPLETION_TOKENS="131072"
export KIMI_MODEL_CAPABILITIES="thinking,always_thinking,tool_use,image_in"
kimi

长期使用仍建议维护 config.toml，便于在不同项目中保持同一组模型、权限和 thinking 配置。

启动与验证 ​

进入项目目录后启动 Kimi Code：

language-bash
cd your-project
kimi

启动后发送一条简单请求，确认模型可以正常响应：

language-text
用一句话介绍当前项目的目录结构。

如果需要确认当前模型，可在 Kimi Code 中打开模型选择器：

language-text
/model

验证清单：

  • /model 中能看到 genstudio/kimi-k2.7-code。
  • 发送测试消息后能收到正常回复。
  • 状态栏或模型选择器显示 thinking 已开启。
  • 需要图片输入时，读取图片文件不会提示当前模型缺少 image_in 能力。

Thinking 与工具调用配置 ​

kimi-k2.7-code 是强制思考模型。通过 Kimi Code 接入时，请保持 [thinking] enabled = true，并在模型能力中保留 always_thinking。

在工具调用和多轮编码任务中，Kimi Code 会把模型返回的 reasoning_content 作为推理内容处理，并在后续请求中按 Kimi Provider 的请求形态回传。thinking.keep = "all" 用于保持历史推理内容，适合长任务、自动修复和多轮工具调用。

使用该模型时，不要把关闭 thinking 作为常规工作流。若需要测试非思考请求，请改用支持显式关闭 thinking 的 Kimi 模型，并按对应模型能力重新配置 capabilities。

添加更多模型 ​

如需使用 GenStudio 上的其他 Kimi 模型，在 config.toml 中追加模型别名即可。模型 ID 应与 GenStudio /models 接口返回的模型 ID 一致。

language-toml
[models."genstudio/kimi-k2.6"]
provider = "genstudio"
model = "kimi-k2.6"
max_context_size = 262144
max_output_size = 131072
capabilities = ["thinking", "tool_use", "image_in"]

请按目标模型的模型卡片调整 max_context_size 和 max_output_size。如果目标模型支持关闭 thinking，不要声明 always_thinking。如果目标模型不支持图片输入，请移除 image_in。如果业务需要视频输入，请先确认目标模型和当前 GenStudio 接入方式支持本地视频内容，再添加 video_in。

故障排除 ​

Kimi Code 启动后仍在使用默认 Kimi Code 模型 ​

  • 检查 default_model 是否等于 genstudio/kimi-k2.7-code。
  • 检查 [models."genstudio/kimi-k2.7-code"] 是否存在，且 provider = "genstudio"。
  • 如果使用 KIMI_MODEL_* 临时覆盖，确认当前终端中没有同时传入 -m 命令行模型参数。

API Key 无效或请求返回未授权 ​

  • 确认 api_key 使用的是 GenStudio 通用 API Key，且以 sk- 开头。
  • 确认 API Key 已启用，账户余额和服务等级满足当前调用。
  • 检查 base_url 是否为 GenStudio OpenAI Compatible Base URL，且没有追加 /chat/completions。

请求返回 400 status code ​

检查 [models."genstudio/kimi-k2.7-code"] 是否设置 max_output_size = 131072。Kimi Code 会根据模型配置为请求设置完成 Token 上限；使用 256K 上下文配置时，需要用 max_output_size 将完成上限限制在 GenStudio API 接受的范围内。

模型无法关闭 thinking ​

kimi-k2.7-code 按强制思考模型处理。请保留 always_thinking 和 [thinking] enabled = true。如果需要关闭 thinking，请选择支持显式关闭 thinking 的 Kimi 模型，并重新配置模型能力。

图片或视频输入不可用 ​

  • 图片输入需要在模型能力中声明 image_in，并确认目标模型支持图片输入。
  • 视频输入需要在模型能力中声明 video_in，并确认目标模型和当前 GenStudio 接入方式支持本地视频内容。
  • 修改能力后，请重启 Kimi Code，使新配置生效。