AI 正在改变开发者构建应用、自动化任务和提供更智能数字体验的方式。借助模型 API，无需从零开发模型即可将先进的 AI 能力集成到软件中。Kimi API 为开发者提供强大语言模型，可用于文本生成、编程、推理和文档分析。本指南将介绍 Kimi API、其主要功能、实际应用，以及如何开始使用。
什么是模型 API
模型 API 是一种通过代码让应用访问 AI 模型的接口。应用发送包含文本、图像等输入的结构化请求，并接收由模型生成的结果。托管模型 API 让开发者无需自行训练或运行底层模型，即可使用这些能力。
Kimi API 提供对月之暗面 Kimi 模型的编程访问能力，开发者可将文本生成、多轮对话、编程辅助、文档分析和视觉理解集成到应用中。
通过统一接口，开发者可将 AI 模型连接到网站、软件应用、内部工具和自动化工作流。这既简化了 AI 集成，也无需管理底层模型基础设施。
AI 模型 API 的类型
AI 模型 API 可支持不同类型的输入和任务，具体取决于底层模型及其能力。常见类别包括：
文本生成 API： 根据用户提示词生成、改写、翻译和总结文本。常用于聊天机器人、写作助手和内容创作应用。
嵌入 API： 将文本或其他支持的数据转换为数值向量表示。开发者可将这些嵌入用于语义搜索、推荐系统和检索增强生成（RAG）。
图像生成 API： 根据文本提示词或参考图像生成或编辑图像，适用于设计工具、创意平台等应用。
多模态 API： 在同一次交互中处理文本、图像等多种输入类型。这类 API 可支持视觉问答、图像分析及其他多模态应用。
语音和音频 API： 将语音转换为文本、生成语音音频，或处理语音输入，适用于语音助手和转写工具等应用。
部分 AI 模型支持多种能力，因此这些类别并非相互排斥。例如，支持的 Kimi 模型既能处理文本任务，也能处理视觉输入，让开发者能够构建结合语言理解与图像分析的应用。
模型 API 在 AI 平台中的作用
模型 API 是应用调用 AI 模型时使用的接口。AI API 平台除提供这些接口外，还提供用于管理 API 密钥、计费、使用情况及相关服务的工具。一个平台可能提供自有模型、第三方模型，或两者兼有。
例如，Kimi API 平台提供对月之暗面 Kimi 模型的访问，并配备可创建密钥和监控使用情况的控制台。开发者从应用中调用模型 API，并通过平台管理该访问权限。两者在同一开发工作流中协同使用。
为什么使用 Kimi API
访问 Kimi 的先进模型： Kimi API 让开发者可以使用月之暗面的最新模型，其中包括面向复杂推理、编程和多模态任务的先进模型。这些模型具备更强的问题解决能力、更出色的代码生成能力和长上下文理解能力，可帮助开发者构建能够处理复杂指令、分析大量信息并管理高要求工作流的应用。
兼容 OpenAI API 格式： Kimi API 支持 OpenAI Chat Completions API 格式，开发者可使用兼容的 OpenAI SDK。配置 Kimi API 基础 URL、API 密钥和模型 ID 后，在适配现有应用前，请检查支持的参数及模型特定行为。这种兼容性让在既有开发工作流中集成 AI 模型 API 更加容易。
流式与非流式响应： Kimi API 同时支持流式和非流式响应模式，以满足不同应用需求。非流式请求返回完整响应，而流式响应则通过服务器发送事件（SSE）逐步传送生成内容。
这种灵活性使模型 API 既适用于后台处理，也适用于需要实时反馈的交互式聊天应用。
灵活集成： 开发者可以将 Kimi API 连接到网站、后端服务、自定义应用和自动化工作流。其基于 API 的架构可灵活地将模型 API 能力纳入不同技术环境和开发项目。
如何开始使用 Kimi API
根据你是想使用 Kimi 自有的开发者工具，还是将其模型集成到现有应用中，有多种方式可以开始使用 Kimi API。你可以将 Kimi API 连接到 Kimi Code CLI，用于 AI 辅助软件开发；也可以使用兼容的 SDK 和工具构建自己的应用。
将 Kimi API 与 Kimi Code 配合使用
Kimi Code CLI 是一款基于终端的 AI 编程 agent，可以读取和修改项目文件、运行命令、分析代码，并协助完成软件开发任务。你可以通过 API 密钥将它连接到 Kimi 开放平台 API，并直接在开发环境中使用 Kimi 模型。
第 1 步：创建 Kimi API 账户
访问 Kimi API 平台并注册账户。登录后即可访问开发者控制台，在其中管理 API 密钥并查看 API 使用情况。累计充值满 5 美元可获得 5 美元代金券（开始调用 API 前，最低需充值 1 美元）。请查看充值政策和控制台，了解当前条款。
第 2 步：生成 API 密钥
在控制台中打开 API 密钥管理页面，创建新的 API 密钥。
复制生成的密钥并妥善保存。避免将其硬编码到应用中，或暴露在客户端代码中。
第 3 步：安装 Kimi Code CLI
Kimi Code CLI 是一款基于终端的 AI 编程 agent，支持 Kimi 开放平台 API。
在 macOS 或 Linux 上，使用官方安装脚本进行安装：
在 Windows 上，打开 PowerShell 并运行：
在 Windows 上启动 Kimi Code CLI 前，请确保已安装 Git for Windows。
或者，也可以通过 npm 安装：
通过 npm 安装需要 Node.js 22.19.0 或更高版本。
第 4 步：将 Kimi API 连接到 Kimi Code
进入项目目录并启动 Kimi Code CLI：
在 Kimi Code CLI 的交互界面中输入 /login。选择 Kimi Platform API key，然后粘贴你先前生成的 API key。
本示例在 Kimi Code CLI 中使用 Kimi Platform API key。用量将按适用的 token 费率计入你的 API 账户，与 Kimi Code 订阅包含的额度分开计算。有关当前的安装和身份验证选项，请参阅 Kimi Code CLI 入门指南。
第 5 步：选择模型并开始编程
在 Kimi Code CLI 中输入 /model，打开模型选择器并选择可用模型。
选择模型后，在 CLI 中输入编程任务。例如：
随后，Kimi Code 可以协助检查项目文件、分析代码、提出修改建议，并帮助完成开发任务。
将 Kimi API 集成到其他 SDK 和工具中
如果你正在开发自己的应用，或已经在使用 AI 开发框架，可以通过兼容的 SDK 和工具集成 Kimi 模型，而无需使用 Kimi Code CLI。
Kimi API 兼容 OpenAI API 格式，因此，使用 OpenAI Python 或 Node.js SDK 的应用通常只需更新 API 基础 URL、API key 和模型 ID 即可连接。例如，使用 OpenAI Python SDK：
第 1 步：安装 OpenAI SDK
第 2 步：配置 Kimi API 客户端
在将要运行 Python 的终端中，将 API key 设置为环境变量。在 macOS 或 Linux 上：
在 Windows PowerShell 中：
然后在 Python 中创建客户端：
本示例使用国际 API 端点。如果你使用中国大陆平台，请按照该平台的文档使用 https://api.moonshot.cn/v1，并使用该平台的 API key 和可用模型。请根据你的平台账户和凭据选择相应端点，而非仅按实际所在位置切换。
第 3 步：向 Kimi 模型发送请求
本示例使用 Chat Completions 接口向 Kimi K3.1 Pro 发送消息，并打印生成的响应。你可以通过流式输出、工具调用及其他受支持的 API 功能扩展集成。
其他 SDK 和开发工具
除 OpenAI SDK 外，Kimi API 还可与其他兼容客户端和 AI 编程工具集成。例如，开发者可以使用 Anthropic SDK 和 Anthropic Messages API 格式，或配置 Claude Code、Codex、OpenClaw 等兼容智能体工具，使其与 Kimi 模型配合使用。
不同工具的配置流程各不相同。根据集成方式，你可能需要指定 API key、基础 URL、模型 ID 和 API 协议。配置连接前，请查阅相关工具文档和 Kimi 的 API 兼容性指南。
更多信息请参阅 Kimi API 文档和模型列表。
如何为应用选择 Kimi 模型
选择 Kimi 模型时，需要权衡任务质量、输出速度和 API 总成本。先在应用中具有代表性的任务上测试模型，再比较其结果和 token 用量。
下表概述了各模型适合考虑的场景：
| 模型 | 推荐工作负载 | 选择理由 |
|---|---|---|
| kimi-k3.1-pro | 新应用、复杂编程、研究及长程智能体任务 | 适合新项目的实用起点，在这三款模型中，其标准输入和输出费率最低。 |
| kimi-k3.1-pro-highspeed | 交互式编程及其他用户等待生成结果的工作流 | 具备与 K3.1 Pro 相同的模型能力，输出生成速度约为 2–3 倍。标准输入、输出和缓存写入费率更高。 |
| kimi-k3 | 已使用 K3 测试过的现有应用 | 适合维护已验证的 K3 集成；切换前，请在您自己的任务上评估更新的模型。 |
Kimi API 定价
以下费率适用于国际 API 平台，按每百万 token（1,000,000 token）的美元价格，未含适用税费列示。三款模型均支持 1,048,576 token 的上下文窗口。
| 模型 | 未缓存输入 | 输出 | 缓存命中 | 缓存写入（5 分钟） | 缓存写入（1 小时） |
|---|---|---|---|---|---|
| kimi-k3.1-pro | $2.00 | $10.00 | $0.20 | $2.00 | $4.00 |
| kimi-k3.1-pro-highspeed | $4.00 | $20.00 | $0.20 | $4.00 | $8.00 |
| kimi-k3 | $3.00 | $15.00 | $0.30 | $3.00 | $6.00 |
对于本指南使用的 Chat Completions 接口，输入 token 分为三个互斥的计费类别：未缓存输入、缓存命中和缓存写入。按缓存写入计费的 token 不会同时按未缓存输入费率收费。估算成本时，请使用 API 报告的用量明细。
自动缓存默认对符合条件的前缀使用 5 分钟 TTL；也可使用 1 小时 TTL。缓存命中按缓存命中费率计费，并会续期现有 TTL，无需再次支付写入费用。有关当前费率和计费规则，请查看官方 API 定价页面和上下文缓存指南。
为应用选择模型时，请考虑以下因素：
任务质量：新项目可先从 K3.1 Pro 开始，再测试其是否满足你的准确性和可靠性要求。对于现有的 K3 集成，切换前请先在自己的回归测试中比较其表现。
输入模态：三款模型都支持原生视觉理解。请根据工作流程，确认所选模型支持的输入格式和预处理要求。
上下文长度：三款模型均提供 100 万 token 的上下文窗口。仅凭容量无法区分它们；还应评估检索质量、延迟以及处理长历史记录的成本。
输出速度：如果更快的生成速度很重要，可考虑 K3.1 Pro 高速版。其输出速度约为 2–3×，但这并不保证每项端到端任务都能快 2–3× 完成。
总用量和成本：比较未缓存输入、缓存读取和写入、输出用量以及所有付费工具。在本次比较中，K3.1 Pro 的标准输入和输出费率最低。应根据报告的用量（包括推理 token）估算输出成本，而非仅依据最终答案的长度。
有关当前模型 ID 和功能，请参阅 Kimi API 模型列表。在选择用于生产环境的模型前，请先根据自身工作负载对候选模型进行基准测试。
Kimi API 的常见应用场景
Kimi API 支持多种开发场景，涵盖对话应用、内容生成、文档分析和多模态工作流。开发者可以将 Kimi 模型集成到现有产品中，也可以构建新的基于人工智能的应用，用于完成以下任务：
AI 客服与对话助手：将 Kimi API 集成到客服平台、聊天机器人和虚拟助手中，用于回答问题、说明产品详情和处理常见支持请求。通过在新的 API 请求中附上此前的消息，应用可以保持对话上下文，提供更贴切的回复。这使 Kimi API 适用于客服自动化、交互式学习工具、个性化推荐及其他对话类应用。
AI 写作与内容生成：构建可根据用户指令和上下文信息生成自然语言内容的写作助手与内容创作工具。开发者可使用 Kimi 模型撰写文章、产品描述和营销文案，也可改写、翻译和总结文本。这些能力还能为写作和效率类应用提供问答、结合上下文的解释以及信息提取支持。
文档分析与知识检索：将 Kimi 模型集成到文档处理工作流中，分析长篇材料、总结报告、提取研究发现，并回答与所提供内容相关的问题。开发者还可以将长上下文处理与文档检索系统结合，构建能够处理多源信息的知识型应用。潜在应用包括研究论文分析、内部知识搜索、文档问答和信息整理。
AI 编程助手与开发工具：使用 Kimi API 支持代码生成、调试、代码解释和技术文档等软件开发任务。开发者可以将模型回复集成到代码编辑器、开发平台和内部工程工具中。结合函数调用，Kimi 模型还可与外部开发服务和函数交互，为编程助手及更高级的基于人工智能的开发工作流提供基础。
多模态应用：使用支持的 Kimi 模型，同时处理视觉输入和文本提示词，使应用能够理解图像和视频，并响应自然语言指令。开发者可以结合文本和视觉理解能力，构建图像问答、视觉内容分析、图像与视频理解等涉及多种输入类型的应用。支持的输入格式和功能取决于所选模型。
结语
总之，Kimi API 让开发者无需从零构建模型，即可更轻松地将先进的 AI 能力集成到应用中。从内容生成和文档分析，到编程和多模态任务，它可满足广泛的开发需求。借助灵活的 AI 模型 API，您可以选择合适的模型，构建实用的基于人工智能的应用。
