Kimi API 兼容 OpenAI Chat Completions 格式，通过替换 baseURL 和 API Key 即可从 OpenAI 或 DeepSeek 迁移过来。本页列出所有可用端点、认证方式和 SDK 快速接入方法。

Kimi API 接口总览

认证

所有请求需在 HTTP Header 中携带 Bearer Token：

Authorization: Bearer $MOONSHOT_API_KEY

API 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，无需安装额外依赖。