Kimi API 兼容 OpenAI Chat Completions 格式，通过替换 baseURL 和 API Key 即可从 OpenAI 或 DeepSeek 迁移过来。本页列出所有可用端点、认证方式和 SDK 快速接入方法。
Kimi API 接口总览
认证
所有请求需在 HTTP Header 中携带 Bearer Token：
Authorization: Bearer $MOONSHOT_API_KEYAPI Key 在控制台申请。请勿将 Key 提交到代码仓库，推荐通过环境变量传入。
SDK 快速接入
Kimi API 完全兼容 OpenAI SDK，只需修改 baseURL：
# Python
from openai import OpenAI
client = OpenAI(
api_key="$MOONSHOT_API_KEY",
base_url="https://api.moonshot.cn/v1",
)// TypeScript / Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.MOONSHOT_API_KEY,
baseURL: "https://api.moonshot.cn/v1",
});从 DeepSeek API 迁移同理：两者都兼容 OpenAI SDK，切换时只改
baseURL和 Key 即可。
可用端点
| 端点 | 方法 | 说明 |
|---|---|---|
/v1/chat/completions |
POST | 聊天补全，核心接口 |
/v1/models |
GET | 列出可用模型 |
/v1/tokenizers/estimate-token-count |
POST | 预估 token 数量 |
/v1/files |
POST/GET | 上传/列出文件 |
/v1/files/{file_id} |
GET/DELETE | 获取/删除文件 |
/v1/files/{file_id}/content |
GET | 获取文件内容 |
/v1/batches |
POST/GET | 创建/列出批量任务 |
/v1/batches/{batch_id} |
GET | 查询批量任务状态 |
/v1/batches/{batch_id}/cancel |
POST | 取消批量任务 |
常见错误码
| 状态码 | 含义 | 处理建议 |
|---|---|---|
| 400 | 请求参数错误 | 检查请求体格式和必填字段 |
| 401 | 认证失败 | 检查 API Key 是否正确、是否有效 |
| 429 | 速率限制 | 降低并发，使用指数退避重试 |
| 500 | 服务端错误 | 等待重试，如持续出现联系支持 |
| 504 | 请求超时（2小时） | 拆分请求或使用流式输出 |
详细错误码列表见 错误码文档。
常见问题
Q: Kimi API 的 baseURL 是什么？
A: https://api.moonshot.cn/v1，与 OpenAI 的 https://api.openai.com/v1 对应。
Q: 如何从 OpenAI 迁移到 Kimi API？
A: 参考迁移指南，核心步骤：1）替换 baseURL；2）替换 API Key；3）将模型名改为 kimi-k2.6 等 Kimi 模型 ID。
Q: 有没有官方的 Kimi SDK？
A: 官方推荐直接使用 OpenAI SDK，无需安装额外依赖。