跳转到主要内容

​
服务地址

https://api.moonshot.cn
Kimi 开放平台提供兼容 OpenAI 协议的 HTTP API，您可以直接使用 OpenAI SDK 接入。 使用 SDK 时，base_url 设置为 https://api.moonshot.cn/v1；直接调用 HTTP 端点时，完整路径如 https://api.moonshot.cn/v1/chat/completions。

​
兼容 OpenAI

我们的 API 在请求/响应格式上兼容 OpenAI Chat Completions API。这意味着：
  • 可以直接使用 OpenAI 官方 SDK（Python / Node.js）
  • 支持大多数兼容 OpenAI 的第三方工具和框架（LangChain、Dify、Coze 等）
  • 只需将 base_url 指向 https://api.moonshot.cn/v1 即可切换
部分参数为 Kimi 专有扩展：thinking 参数需要通过 SDK 的 extra_body 传递；partial 是写在 messages 中 assistant 消息上的字段（"partial": true），不是顶层请求参数。详见工具调用和 Partial Mode。

​
认证

所有 API 请求需要在 HTTP 头中携带 API Key： 
Authorization: Bearer $MOONSHOT_API_KEY
API Key 可在 Kimi 开放平台控制台 创建和管理。
API Key 是敏感信息，请妥善保管。不要在客户端代码、公开仓库或日志中暴露。建议通过环境变量管理。

​
SDK 安装

pip install --upgrade 'openai>=1.0'
初始化客户端： 
from openai import OpenAI

client = OpenAI(
    api_key="$MOONSHOT_API_KEY",
    base_url="https://api.moonshot.cn/v1",
)
Python 版本需 ≥ 3.7.1，Node.js 版本需 ≥ 18，OpenAI SDK 版本需 ≥ 1.0.0。
python -c 'import openai; print("version =", openai.__version__)'

​
通用请求头

请求头值说明
Content-Typeapplication/json请求体格式
AuthorizationBearer $MOONSHOT_API_KEY认证令牌

​
错误处理

请求失败时返回 JSON 格式的错误响应，包含 error.type 和 error.message 字段。常见的 HTTP 状态码包括 400（请求错误）、401（认证失败）、429（速率限制）、500（服务端错误）等。 完整的错误类型、错误消息和排障建议，请参阅错误说明。

​
API 端点一览

端点方法说明
/v1/chat/completionsPOST创建对话补全
/v1/modelsGET列出模型
/v1/tokenizers/estimate-token-countPOST计算 Token
/v1/users/me/balanceGET查询余额
/v1/filesPOST上传文件
/v1/filesGET列出文件
/v1/files/{file_id}GET获取文件信息
/v1/files/{file_id}DELETE删除文件
/v1/files/{file_id}/contentGET获取文件内容

​
下一步

快速开始

发送第一个 API 请求

模型总览

了解各模型的能力和参数差异

工具调用

让模型调用外部函数

创建对话补全

完整的端点参数参考