Kimi K2.7 Code API 接入指南

先说结论:一个 base_url,两个模型字符串

Kimi K2 目前在 kkaiapi 上有两个可调的 ID:kimi-k2.7-code,今年 6 月发布的编程专精款;kimi-k2.6,4 月发布的通用款。base_url 填 https://api.kkaiapi.com/v1,按任务选 ID,请求体是同一套标准 /v1/chat/completions 格式,不需要月之暗面的账号或专属 SDK。 ID 拼写要精确:kimi-k2.7-code 带点和 -code 后缀,kimi-k2.6 没有后缀,是两个独立模型,打错字直接返回模型不存在。

curl https://api.kkaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的kkaiapi密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k2.7-code",
    "messages": [{"role": "user", "content": "写一条 bash 单行命令,找出 git 仓库里最大的文件"}]
  }'

两个 ID 到底是什么

Kimi K2.7-Code 在 2026 年 6 月 12 日发布,按月之暗面公告与发布报道,定位是编程专精:权重在 Hugging Face 上以 Modified MIT 协议开源,MoE 架构参数规模约 1 万亿总参数,每个 token 激活约 320 亿,上下文 25.6 万 token。官方给出的效率宣传是相比 K2.6 推理 token 少约三分之一,在月之暗面自己维护的 Kimi Code Bench v2 上提升 21.8%,这是官方给出的基准测试成绩,当成厂商口径看待。 Kimi K2.6 是 4 月发布的通用款,K2.7-Code 就是从它分支出来的,官方定位是长程 Agent 任务:发布材料提到过单次自主编程任务能跑数小时、多 Agent 协同可到数百个子 Agent 规模。日常代码之外的分析、写作、混合型 Agent 场景,K2.6 仍然是更合适的默认选择。 两个 ID 在 kkaiapi 上上下文都是 25.6 万 token,价格也完全一样,所以选哪个纯粹是任务契合度问题,不涉及成本权衡。

Python 与 JavaScript 快速接入

两个官方 OpenAI SDK 在创建客户端时都能传自定义 base_url,model 字段原样传字符串,同一个客户端对象可以前一行调 kimi-k2.7-code,后一行换成 claude-sonnet-5,方便直接对比。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KKAIAPI_KEY"],
    base_url="https://api.kkaiapi.com/v1",
)

resp = client.chat.completions.create(
    model="kimi-k2.7-code",
    messages=[
        {"role": "system", "content": "你是一个严谨的编程助手。"},
        {"role": "user", "content": "把这段循环改写成列表推导式,并说明取舍:..."},
    ],
    max_tokens=4000,
)
print(resp.choices[0].message.content)
print(resp.usage)

长程 Agent 任务怎么控制成本

K2 系列的招牌能力是长链路工具调用,官方宣传过单次任务可以连续调用工具数百次不需要人工干预,K2.6 的发布材料把这个能力延伸到多小时的自主编程会话。这类长任务一旦跑起来,成本核算的单位要从"每次请求"换成"每次完整任务"。 三个习惯能让一次跑几小时的 Agent 任务成本可预期:按每一步的 completion_tokens 而不是按整个会话来监控,K2.7-Code 官方宣传的"推理 token 减少约三分之一"本身就是一个 completion_tokens 的说法,自己的用量日志一个下午就能验证;每一步的 max_tokens 都留够余量,思考中途被截断会让一整个计划报废;给每个 Agent 实验单独开一个 Key,用量记录直接就是这次实验的成本台账。

两个 ID 怎么选,一张表说清

价格相同,选型只看任务契合度。

价格与上下文

Kimi 两个 ID 在 kkaiapi 上价格完全一致,都是 25.6 万 token 上下文,和月之暗面官方发布的 K2.7 一代窗口一致。这个窗口小于目录里部分其他家族的百万级窗口,长 Agent 会话如果会积累巨量仓库状态,要么做摘要压缩,要么把这部分步骤路由到更长窗口的模型。

验证接入与排查首次调用

先查一次模型列表,确认两个 Kimi ID 都能调到,拼写以列表为准。 401 多半是 Key 没导出到当前 shell;404 常见于 base_url 漏了 /v1;模型不存在多是拼写问题,kimi-k2.7-code 既带点又带 -code 后缀,kimi-k2.6 没有后缀;Agent 任务里 finish_reason 是 length,说明 max_tokens 对一个会先思考的模型来说设小了,调大后再评判输出质量。

curl -s https://api.kkaiapi.com/v1/models \
  -H "Authorization: Bearer sk-你的kkaiapi密钥" | grep kimi

常见问题