# Kimi API 开放平台

> Kimi K3 是 Kimi 面向长程编程与端到端知识工作的旗舰模型，1M token 上下文，综合智能达到领先水平。Kimi API 开放平台提供 Kimi K3、Kimi K2.7 Code、Kimi K2.6 等大模型 API，支持超长上下文、多模态理解与 Tool Calling。

- [快速开始](https://platform.kimi.com/docs/get-api-key.md): 从创建 API Key 到完成第一次 Kimi API 调用。
- [模型列表](https://platform.kimi.com/docs/models.md): 查看 Kimi 开放平台当前可用的多模态与编程模型，以及已下线模型的迁移提示。
- [Kimi K3](https://platform.kimi.com/docs/guide/kimi-k3-quickstart.md): 了解 Kimi K3 的长程编程、知识工作、深度推理、视觉理解与 100 万 token 上下文能力。
- [Kimi K2.7 Code](https://platform.kimi.com/docs/guide/kimi-k2-7-code-quickstart.md): 了解 Kimi K2.7 Code 及高速版的编程、多模态、思考模式、工具调用与 256K 上下文能力。
- [Kimi K2.6](https://platform.kimi.com/docs/guide/kimi-k2-6-quickstart.md): 了解 Kimi K2.6 的文本、图片与视频理解、思考模式、工具调用和 256K 上下文能力。
- [思考模型](https://platform.kimi.com/docs/guide/use-thinking-models.md): 了解 Kimi 思考模式的模型选择、`reasoning_content`、多轮保留策略、工具调用和 token 计费。
- [推理强度](https://platform.kimi.com/docs/guide/use-reasoning-effort.md): 使用 `reasoning_effort` 在 `low`、`high` 和 `max` 之间调节 Kimi K3 的推理深度、延迟与 token 消耗。
- [配置多轮对话参数](https://platform.kimi.com/docs/guide/engage-in-multi-turn-conversations-using-kimi-api.md): 在无状态的 Kimi API 中维护消息历史、控制上下文长度，并正确构建多轮对话请求。
- [使用 Kimi API 的流式输出功能](https://platform.kimi.com/docs/guide/utilize-the-streaming-output-feature-of-kimi-api.md): 使用 Kimi API SSE 流式输出降低首 token 等待时间，解析增量响应并获取最终用量数据。
- [使用 Kimi API 的 JSON Mode](https://platform.kimi.com/docs/guide/use-json-mode-feature-of-kimi-api.md): 使用 `response_format` 启用 Kimi API JSON Mode，通过提示词和代码安全获取、解析结构化 JSON 输出。
- [使用 Kimi API 的 Partial Mode](https://platform.kimi.com/docs/guide/use-partial-mode-feature-of-kimi-api.md): 使用 Kimi API Partial Mode 续写给定文本、固定回复开头、继续被截断的输出或保持角色一致性。
- [配置 Kimi 视觉模型](https://platform.kimi.com/docs/guide/use-kimi-vision-model.md): 为 Kimi 多模态模型构建图片和视频输入，支持 base64、URL、文件上传与多图片对话。
- [使用 Kimi API 的 Context Caching 功能](https://platform.kimi.com/docs/guide/use-context-caching-feature-of-kimi-api.md): 了解 Kimi API 自动上下文缓存的命中条件、计费、用量字段与适用场景，以降低成本和延迟。
- [动态加载工具](https://platform.kimi.com/docs/guide/use-dynamic-tool-loading.md): 按需将工具定义追加到 Kimi 对话中，减少 token 消耗、提高工具选择准确性并保留前缀缓存。
- [使用 Kimi API 完成工具调用（tool_calls）](https://platform.kimi.com/docs/guide/use-kimi-api-to-complete-tool-calls.md): 定义、注册和执行 Kimi API `tool_calls`，回传工具结果并处理流式工具调用。
- [联网搜索最佳实践](https://platform.kimi.com/docs/guide/web-search-best-practice.md): 按场景选择搜索接口、控制成本、写有效查询词、配置参数，提升联网搜索结果质量。
- [使用 $web_search 内置工具联网搜索](https://platform.kimi.com/docs/guide/use-web-search.md): 通过 Kimi API 集成联网搜索，并根据模型选择官方工具或内置 `$web_search` 调用方式。
- [如何在 Kimi API 中使用官方工具](https://platform.kimi.com/docs/guide/use-official-tools.md): 查看 Kimi 开放平台可用的官方工具，并了解如何在 Chat Completions API 中配置和调用它们。
- [工具调用约束](https://platform.kimi.com/docs/guide/use-tool-choice.md): 使用 `tool_choice` 让 Kimi 自动选择、强制或禁止工具调用，并结合工具定义提高可靠性。
- [Kimi K3 API 工具调用最佳实践](https://platform.kimi.com/docs/guide/kimi-k3-tool-calling-best-practice.md): 工具数量较多时，结合动态加载、tool_choice 与推理强度设计工具调用流程。
- [使用 response_format 控制模型输出格式](https://platform.kimi.com/docs/guide/response_format.md): 使用 `response_format` 启用 JSON Mode 或 Structured Output，并处理模式、结构和 Partial Mode 限制。
- [自动断线重连](https://platform.kimi.com/docs/guide/auto-reconnect.md): 为 Kimi API 流式请求实现断线重连，并结合 Partial Mode 从中断处继续生成。
- [使用 Kimi API 进行文件问答](https://platform.kimi.com/docs/guide/use-kimi-api-for-file-based-qa.md): 使用 Kimi API 上传文件、抽取内容并将其加入对话，实现单文件或多文件问答。
- [使用 Batch API 批量处理任务](https://platform.kimi.com/docs/guide/use-batch-api.md): 通过 Batch API 上传 JSONL 请求、创建和查询批处理任务，并下载大规模异步推理结果。
- [在 Kimi Code CLI 中使用 Kimi API Platform](https://platform.kimi.com/docs/guide/kimi-code-cli.md): 使用 Kimi API Platform API Key 接入、切换和更新 Kimi Code CLI。
- [在 Codex 中使用 Kimi K3](https://platform.kimi.com/docs/guide/codex-kimi.md): 通过 Kimi Responses API 将 Codex 直连 Kimi K3：配置 API Key、编辑 `~/.codex/config.toml`，并分别在桌面端与 CLI 中验证连接。
- [在 OpenClaw 中连接 Kimi](https://platform.kimi.com/docs/guide/use-kimi-in-openclaw.md): 使用 OpenClaw 和 Kimi API 构建跨平台 AI 智能体。按照指南安装 OpenClaw 并配置 Kimi API 密钥。
- [在 Claude Code 中使用 Kimi](https://platform.kimi.com/docs/guide/claude-code-kimi.md): 介绍如何将 Kimi API 接入 Claude Code，并完成模型选择与配置验证。
- [在 OpenCode 中使用 Kimi 模型](https://platform.kimi.com/docs/guide/open-code.md): 安装 OpenCode，通过内置认证接入中国区 Kimi 开放平台，并使用 Kimi K3 及其推理强度档位。
- [在 Hermes Agent 中使用 Kimi K3](https://platform.kimi.com/docs/guide/use-kimi-in-hermes-agent.md): 安装 Hermes Agent，接入中国区 Kimi 开放平台，并启用 Kimi K3 的文本、图片和视频理解能力。
- [在 Playground 中配置 ModelScope MCP 服务器](https://platform.kimi.com/docs/guide/configure-the-modelscope-mcp-server.md): 在 Kimi Playground 中同步并启用 ModelScope 托管的 MCP 服务，让模型调用已配置的工具。
- [MoonPalace - Moonshot AI 月之暗面 Kimi API 调试工具](https://platform.kimi.com/docs/guide/use-moonpalace.md): 安装并使用 MoonPalace 跨平台调试 Kimi API，管理对话、参数、文件、工具调用和上下文缓存。
- [使用 Playground 调试模型](https://platform.kimi.com/docs/guide/use-playground-to-debug-the-model.md): 在 Kimi Playground 中比较模型、调整参数、测试工具调用，并将调试结果转换为 API 请求。
- [建立并认证你的组织](https://platform.kimi.com/docs/guide/org-best-practice.md): 建立并实名认证 Kimi 开放平台组织，配置 IP 白名单，并管理成员、项目与 API Key。
- [快速开始](https://platform.kimi.com/docs/hosted-agents/quickstart.md): 预构建、可配置的托管智能体运行平台，适合 Agent 长程任务与异步工作。
- [使用控制台](https://platform.kimi.com/docs/hosted-agents/console.md): 通过 Kimi 托管智能体控制台创建智能体、配置技能和插件、准备环境并创建会话。
- [通过 hakimi 创建托管智能体](https://platform.kimi.com/docs/hosted-agents/hakimi.md): 下载 hakimi 技能包并安装到 Kimi Code、Codex、Claude Code 等 agent，用自然语言创建托管智能体、配置执行环境并启动第一个会话。
- [迁移到托管智能体](https://platform.kimi.com/docs/hosted-agents/migration.md): 从基于模型推理 API 自建的智能体循环，迁移到托管智能体。
- [创建与管理智能体](https://platform.kimi.com/docs/hosted-agents/agents.md): 创建、更新、版本管理和归档托管智能体的配置对象。
- [权限策略](https://platform.kimi.com/docs/hosted-agents/permissions.md): 为托管智能体配置工具权限：禁用不需要的工具，并查看每次工具调用的评估结果。
- [技能](https://platform.kimi.com/docs/hosted-agents/skills.md): 为托管智能体挂载版本化技能包，按需扩展智能体能力。
- [接入 MCP](https://platform.kimi.com/docs/hosted-agents/mcp.md): 在智能体上声明 MCP 服务，通过凭据库注入访问凭据，让托管智能体调用第三方 MCP 工具。
- [插件](https://platform.kimi.com/docs/hosted-agents/plugins.md): 在智能体中引用官方插件：浏览插件目录、理解版本固定规则，并在控制台或 API 中完成配置。
- [工具](https://platform.kimi.com/docs/hosted-agents/tools.md): 查看托管智能体的内置工具清单、使用限制与按需加载方式。
- [执行环境](https://platform.kimi.com/docs/hosted-agents/environments.md): 配置执行环境（云沙箱）的预装依赖、网络访问策略和初始化脚本。
- [沙箱规格参考](https://platform.kimi.com/docs/hosted-agents/sandbox-reference.md): 托管智能体云沙箱的操作系统、预装运行时和工具、文件系统、访问权限及网络访问规则。
- [启动会话](https://platform.kimi.com/docs/hosted-agents/sessions.md): 创建会话以运行智能体，绑定所需的执行环境和资源，并发送首条消息启动任务。
- [会话管理](https://platform.kimi.com/docs/hosted-agents/session-operations.md): 查看和更新会话，取消当前轮次，并管理会话生命周期。
- [事件流](https://platform.kimi.com/docs/hosted-agents/event-stream.md): 订阅会话和线程的 SSE 事件流，读取历史事件，并在断线后继续接收智能体输出。
- [凭据库](https://platform.kimi.com/docs/hosted-agents/vaults.md): 保存第三方服务凭据，在创建会话时绑定凭据库，并管理凭据的授权、轮换和归档。
- [文件](https://platform.kimi.com/docs/hosted-agents/files.md): 上传文件、在会话中绑定文件，并浏览或下载会话文件。
- [记忆](https://platform.kimi.com/docs/hosted-agents/memory.md): 创建可跨会话使用的记忆库，管理其中的文件，并按版本检查和恢复内容。
- [梦境](https://platform.kimi.com/docs/hosted-agents/dreams.md): 为记忆库配置自动整理条件，查看运行记录，并按文件版本核对和恢复变更。
- [多智能体编排](https://platform.kimi.com/docs/hosted-agents/multiagent-orchestration.md): 配置智能体之间的任务委派，在同一个会话中运行子线程，并观察多智能体执行状态和事件。
- [定时运行智能体](https://platform.kimi.com/docs/hosted-agents/triggers.md): 使用 cron 定时或手动运行智能体，查看运行记录并管理触发器生命周期。
- [PPT 生成智能体设计](https://platform.kimi.com/docs/hosted-agents/official-ppt-agent.md): 拆解官方 PPT 助手的模型、系统提示词、技能与插件配置，以及如何照同样思路自建产出型智能体。
- [金融投研智能体设计](https://platform.kimi.com/docs/hosted-agents/official-investment-research-agent.md): 拆解官方金融投资分析助手的多智能体架构、路由规则与投研插件配置，以及如何按照同样思路自建投研智能体。
- [常见问题](https://platform.kimi.com/docs/hosted-agents/faq.md): 托管智能体常见问题：资源概念与区别、版本与并发、会话运行与故障、文件与记忆库、控制台能力边界。
- [更新日志](https://platform.kimi.com/docs/hosted-agents/changelog.md): 托管智能体 API 的调用方可见变更记录：新增能力、行为变更与契约声明更新。
- [API 概述](https://platform.kimi.com/docs/api/overview.md): 查看 Kimi API 的服务地址、认证方式、请求格式、兼容性和主要接口入口。
- [模型参数参考](https://platform.kimi.com/docs/api/models-overview.md): 对比 Kimi 各模型系列在 Chat Completions API 中的默认参数、可调范围与使用约束。
- [常见错误码说明](https://platform.kimi.com/docs/api/errors.md): 查询 Kimi API 的 HTTP 状态码、错误类型、常见原因和对应的排查处理方法。
- [Chat Completions API](https://platform.kimi.com/docs/api/chat.md): 创建对话补全：向 Kimi 模型发送消息并获取回复，支持流式输出、工具调用与视觉输入。
- [Responses API](https://platform.kimi.com/docs/api/responses.md): 创建一次模型响应。传入文本或图片，生成文本或 JSON 输出；也可以让模型调用你定义的函数工具，或使用服务端执行的联网搜索。
- [Messages API](https://platform.kimi.com/docs/api/messages.md): 以 Anthropic Messages API 兼容的格式调用 Kimi 模型，支持流式输出、工具调用、图片输入、思考与结构化输出。
- [列出模型](https://platform.kimi.com/docs/api/list-models.md): 列出当前可用的模型及其 ID。
- [计算 Token](https://platform.kimi.com/docs/api/estimate.md): 在发送请求前估算输入内容的 Token 数量。
- [查询余额](https://platform.kimi.com/docs/api/balance.md): 查询当前账户的可用余额。
- [校验请求签名](https://platform.kimi.com/docs/api/signatures-verify.md): 校验 Kimi API 返回的请求签名，证明请求确实由 Kimi API 处理且请求的是指定模型，而非被转发到其他服务。
- [联网搜索 Basic](https://platform.kimi.com/docs/api/tools-search.md): 通过 /v1/tools/search 接口发起网页搜索，返回结构化搜索结果。
- [联网搜索 Pro](https://platform.kimi.com/docs/api/tools-search-pro.md): 通过 /v1/tools/search_pro 接口发起网页搜索，支持站点与时间范围约束，并返回结构化正文片段。
- [网页抓取](https://platform.kimi.com/docs/api/tools-fetch.md): 通过 /v1/tools/fetch 接口抓取指定 URL 的网页内容，返回页面标题与 Markdown 格式正文。
- [上传文件](https://platform.kimi.com/docs/api/files-upload.md): 上传文件用于文本内容抽取、图片理解或视频理解，支持 pdf、doc、txt 等文本类格式。
- [列出文件](https://platform.kimi.com/docs/api/files-list.md): 列出当前账户已上传的文件。
- [获取文件信息](https://platform.kimi.com/docs/api/files-retrieve.md): 获取指定文件的元信息。
- [删除文件](https://platform.kimi.com/docs/api/files-delete.md): 删除指定的已上传文件。
- [获取文件内容](https://platform.kimi.com/docs/api/files-content.md): 获取以 file-extract 用途上传的文件的提取文本内容。
- [创建批处理任务](https://platform.kimi.com/docs/api/batch-create.md): 创建批处理任务，以更低价格异步批量处理请求。
- [列出批处理任务](https://platform.kimi.com/docs/api/batch-list.md): 列出当前账户的批处理任务。
- [获取批处理任务详情](https://platform.kimi.com/docs/api/batch-retrieve.md): 获取指定批处理任务的详情与进度。
- [取消批处理任务](https://platform.kimi.com/docs/api/batch-cancel.md): 取消一个进行中的批处理任务。
- [列出智能体](https://platform.kimi.com/docs/api-reference/智能体/列出智能体.md): 返回调用方的智能体，默认最新在前，除非 `order` 为 `created_at`。已归档的智能体不会出现在列表中。
- [创建智能体](https://platform.kimi.com/docs/api-reference/智能体/创建智能体.md): 创建智能体及其首个不可变版本（`"1"`）。
- [获取智能体](https://platform.kimi.com/docs/api-reference/智能体/获取智能体.md): 返回单个智能体及其最新版本。已归档的智能体仍可读取。
- [更新智能体](https://platform.kimi.com/docs/api-reference/智能体/更新智能体.md): 修改请求体中提供的字段，并创建一个新的不可变智能体版本。
- [归档智能体](https://platform.kimi.com/docs/api-reference/智能体/归档智能体.md): 归档智能体。已归档的智能体仍可读取，但不能更新，也不能用于开启新会话。已有会话不受影响。
- [列出智能体版本](https://platform.kimi.com/docs/api-reference/智能体/列出智能体版本.md): 返回智能体的不可变版本，最新在前。每一项都是该版本捕获的完整配置。
- [列出产物](https://platform.kimi.com/docs/api-reference/产物/列出产物.md): 列出调用方可见的产物，最近交付的在前。每个条目为该产物的最新版本。用 `session_id` 筛选单个会话的产物。
- [获取产物](https://platform.kimi.com/docs/api-reference/产物/获取产物.md): 返回单个产物的元数据。未指定 `version` 时返回最新版本，指定时返回该确切版本。
- [删除产物](https://platform.kimi.com/docs/api-reference/产物/删除产物.md): 永久删除一个产物及其全部版本。已上报该产物的事件不会撤回。
- [下载产物内容](https://platform.kimi.com/docs/api-reference/产物/下载产物内容.md): 下载产物内容。未指定 `version` 时下载最新版本。
- [列出产物版本](https://platform.kimi.com/docs/api-reference/产物/列出产物版本.md): 列出一个产物的全部版本，最新在前。每个条目为该版本的完整产物。
- [列出环境](https://platform.kimi.com/docs/api-reference/环境/列出环境.md): 返回调用方的环境，最新在前。除非 `include_archived` 为 true，否则不包含已归档的环境。
- [创建环境](https://platform.kimi.com/docs/api-reference/环境/创建环境.md): 创建一个环境，将其配置冻结为不可变版本 `"1"`，并开始构建。
- [获取环境](https://platform.kimi.com/docs/api-reference/环境/获取环境.md): 返回单个环境，包括其最新版本的构建状态。已归档的环境仍可读取。
- [删除环境](https://platform.kimi.com/docs/api-reference/环境/删除环境.md): 永久删除一个已归档的环境及其全部版本。
- [更新环境](https://platform.kimi.com/docs/api-reference/环境/更新环境.md): 仅修改请求体中出现的字段。`null` 值视为未提供，传入空对象或空数组可清空对应集合。
- [归档环境](https://platform.kimi.com/docs/api-reference/环境/归档环境.md): 归档一个环境。已归档的环境拒绝更新，也不能承载新会话。现有会话不受影响。
- [列出文件](https://platform.kimi.com/docs/api-reference/文件/列出文件.md): 列出已上传的文件。不带 `kimi-api-version` 请求头的请求列出整个组织的文件列表；`2026-09-01-beta` 请求列出项目下的文件。不带 `page_size` 时返回完整列表。通过 `POST /v1/sessions/{id}/resources` 将文件挂载到会话。
- [上传文件](https://platform.kimi.com/docs/api-reference/文件/上传文件.md): 以 multipart 表单数据上传一个文件，并返回其文件记录。
- [获取文件](https://platform.kimi.com/docs/api-reference/文件/获取文件.md): 返回单个文件的元数据。
- [删除文件](https://platform.kimi.com/docs/api-reference/文件/删除文件.md): 删除一个文件，并释放其名称供后续上传使用。`batch` 文件只能由上传它的用户删除，否则返回 403。
- [获取文件内容](https://platform.kimi.com/docs/api-reference/文件/获取文件内容.md): 返回文件按其处理用途可用的内容。
- [列出记忆库](https://platform.kimi.com/docs/api-reference/记忆库/列出记忆库.md): 返回调用方的记忆库，最新在前。除非 `include_archived` 为 true，否则不包含已归档的记忆库。
- [创建记忆库](https://platform.kimi.com/docs/api-reference/记忆库/创建记忆库.md): 创建项目作用域的记忆库。
- [获取记忆库](https://platform.kimi.com/docs/api-reference/记忆库/获取记忆库.md): 返回单个记忆库的元数据。已归档的记忆库仍可读取。
- [删除记忆库](https://platform.kimi.com/docs/api-reference/记忆库/删除记忆库.md): 永久删除已归档的记忆库及其全部文件和版本历史。
- [更新记忆库](https://platform.kimi.com/docs/api-reference/记忆库/更新记忆库.md): 重命名记忆库或修改其描述。请求体中未出现的字段保持当前值。
- [归档记忆库](https://platform.kimi.com/docs/api-reference/记忆库/归档记忆库.md): 归档一个记忆库。归档不可撤销。
- [列出记忆](https://platform.kimi.com/docs/api-reference/记忆库/列出记忆.md): 返回记忆库当前的文件，最新在前，不含文件内容。已删除的文件不在其中。已归档的记忆库仍可读取。
- [创建记忆](https://platform.kimi.com/docs/api-reference/记忆库/创建记忆.md): 在记忆库中创建一个文件，并记录为第一个版本。
- [获取记忆](https://platform.kimi.com/docs/api-reference/记忆库/获取记忆.md): 返回单个文件的元数据和当前的 base64 编码内容。已删除的文件返回 404。已归档的记忆库仍可读取。
- [删除记忆](https://platform.kimi.com/docs/api-reference/记忆库/删除记忆.md): 删除文件并记录一个 `deleted` 版本。文件的版本历史仍可读取。对已删除的文件再次删除返回 404。
- [更新记忆](https://platform.kimi.com/docs/api-reference/记忆库/更新记忆.md): 修改文件的路径、内容或两者，并把更改记录为新版本。
- [列出记忆版本](https://platform.kimi.com/docs/api-reference/记忆库/列出记忆版本.md): 返回文件的版本历史，仅含元数据。默认最旧在前，`order` 为 `desc` 时最新在前。已删除文件的版本仍可列出。
- [获取记忆版本](https://platform.kimi.com/docs/api-reference/记忆库/获取记忆版本.md): 返回单个版本的元数据及其历史内容的 base64 编码。`deleted` 版本以及已删除正文的版本不返回内容。
- [删除记忆版本正文](https://platform.kimi.com/docs/api-reference/记忆库/删除记忆版本正文.md): 永久删除一个历史版本的正文，仅保留其元数据。已删除的正文无法恢复。
- [获取梦境策略](https://platform.kimi.com/docs/api-reference/记忆库/获取梦境策略.md): 返回单个记忆库的梦境策略。
- [更新梦境策略](https://platform.kimi.com/docs/api-reference/记忆库/更新梦境策略.md): 整体替换单个记忆库的梦境策略。
- [列出插件](https://platform.kimi.com/docs/api-reference/插件/列出插件.md): 返回可用于智能体配置的已上架插件，按 ID 升序排列。`query` 对名称、描述和关键词做大小写不敏感匹配。
- [获取插件](https://platform.kimi.com/docs/api-reference/插件/获取插件.md): 返回单个已上架插件，包括其捆绑的 MCP 服务器与技能。未上架的插件返回 404。
- [列出会话](https://platform.kimi.com/docs/api-reference/会话/列出会话.md): 返回调用方的会话，最近更新的排在最前，除非 `order` 另有指定。列表项省略 `resources` 绑定。请使用 `GET /v1/sessions/{id}` 获取。
- [创建会话](https://platform.kimi.com/docs/api-reference/会话/创建会话.md): 创建运行选定智能体版本的会话，初始状态为 `idle`。
- [获取会话](https://platform.kimi.com/docs/api-reference/会话/获取会话.md): 返回单个会话，包含其资源绑定和协调者的智能体快照（含系统提示词）。
- [删除会话](https://platform.kimi.com/docs/api-reference/会话/删除会话.md): 永久删除一个已归档的会话及其资源绑定。
- [更新会话](https://platform.kimi.com/docs/api-reference/会话/更新会话.md): 修改会话的标题或智能体覆盖配置。仅 `title` 与 `agent_overrides` 可修改，请求体中未出现的字段保持原值。
- [归档会话](https://platform.kimi.com/docs/api-reference/会话/归档会话.md): 归档会话：将其终止并取消其线程。运行中的会话无法归档（400 `failed_precondition_error`）——先发送 `user.interrupt` 事件将其停止。已归档的会话拒绝更新和新事件，但仍可读取。
- [列出会话事件](https://platform.kimi.com/docs/api-reference/会话/列出会话事件.md): 分页返回会话的事件历史，最旧的在前——即协调者线程的事件。仅供流式传输的 `agent.delta` 事件从不出现在历史中。
- [向会话发送事件](https://platform.kimi.com/docs/api-reference/会话/向会话发送事件.md): 接收用户事件作为会话输入，返回 202。
- [列出待处理事件](https://platform.kimi.com/docs/api-reference/会话/列出待处理事件.md): 按到达顺序返回会话排队中的输入事件。列表不分页。
- [撤回待处理事件](https://platform.kimi.com/docs/api-reference/会话/撤回待处理事件.md): 在投递前移除一个排队中的输入事件。`event_id` 已投递、已撤回或从未排队时，返回 400。
- [流式获取会话事件（SSE）](https://platform.kimi.com/docs/api-reference/会话/流式获取会话事件（sse）.md): 通过 Server-Sent Events 打开会话的实时事件流。
- [列出会话文件系统中的文件](https://platform.kimi.com/docs/api-reference/会话/列出会话文件系统中的文件.md): 列出会话文件系统中一个目录的直接子项：目录在前，随后文件按名称排序。列表不递归。
- [下载会话文件系统中的文件](https://platform.kimi.com/docs/api-reference/会话/下载会话文件系统中的文件.md): 下载会话文件系统中的一个文件。`path` 为必填，取列表结果中的路径。
- [列出会话资源](https://platform.kimi.com/docs/api-reference/会话/列出会话资源.md): 返回绑定到会话的资源，每项都带有服务端分配的绑定 `id`。
- [添加会话资源](https://platform.kimi.com/docs/api-reference/会话/添加会话资源.md): 将一个已上传的文件绑定到会话，并返回该绑定。
- [获取会话资源](https://platform.kimi.com/docs/api-reference/会话/获取会话资源.md): 返回会话的一个资源绑定。
- [移除会话资源](https://platform.kimi.com/docs/api-reference/会话/移除会话资源.md): 从会话中移除一个资源绑定。对于文件，工作区中的链接会一并移除。
- [列出会话的线程](https://platform.kimi.com/docs/api-reference/会话/列出会话的线程.md): 返回会话的线程：协调者在前，随后按创建顺序列出子线程，每个线程都带有固定的智能体快照。
- [获取会话的线程](https://platform.kimi.com/docs/api-reference/会话/获取会话的线程.md): 返回会话的一个线程，包含其固定的智能体快照。
- [归档会话的线程](https://platform.kimi.com/docs/api-reference/会话/归档会话的线程.md): 归档一个空闲的子线程（对协调者或非空闲的线程返回 400 `failed_precondition_error`）。
- [列出线程事件](https://platform.kimi.com/docs/api-reference/会话/列出线程事件.md): 分页返回单个线程的事件历史，最旧的在前。会话级接口返回协调者线程的历史。`order` 取 `*_desc` 时最新在前，此时 `page_token` 继续向更早的事件翻页。
- [流式获取线程事件（SSE）](https://platform.kimi.com/docs/api-reference/会话/流式获取线程事件（sse）.md): 通过 Server-Sent Events 订阅一个线程的实时公开事件流。帧格式与游标语义均与会话事件流相同。
- [列出技能](https://platform.kimi.com/docs/api-reference/技能/列出技能.md): 返回调用方项目的技能与已启用的官方技能，按创建时间升序排列。已归档的技能不会列出。
- [创建技能](https://platform.kimi.com/docs/api-reference/技能/创建技能.md): 通过 `.zip` 或 `.skill` 包上传创建项目拥有的技能及其第一个不可变版本。
- [获取技能](https://platform.kimi.com/docs/api-reference/技能/获取技能.md): 返回单个技能。已归档的技能返回 404。
- [删除技能](https://platform.kimi.com/docs/api-reference/技能/删除技能.md): 删除一个项目拥有的技能——等同于 `POST /v1/skills/{id}/archive`。
- [归档技能](https://platform.kimi.com/docs/api-reference/技能/归档技能.md): 归档一个项目拥有的技能。`DELETE /v1/skills/{id}` 是该操作的别名。
- [列出技能版本](https://platform.kimi.com/docs/api-reference/技能/列出技能版本.md): 返回技能的不可变版本，最新在前。已归档技能的版本仍可列出。
- [获取技能版本内容](https://platform.kimi.com/docs/api-reference/技能/获取技能版本内容.md): 下载指定确切版本的原始 SKILL.md 指令（`version` 必须是数字版本号，不能是 `latest`）。响应始终为 `text/markdown`。已归档的技能返回 404。
- [列出触发器](https://platform.kimi.com/docs/api-reference/触发器/列出触发器.md): 返回调用方的触发器，最新在前。不设置 `status` 时不包含已归档的触发器。`policy_type` 按策略类型筛选，`agent_id` 按所属 Agent 筛选。
- [创建触发器](https://platform.kimi.com/docs/api-reference/触发器/创建触发器.md): 创建一个处于活跃状态的触发器，为智能体启动会话。
- [获取触发器](https://platform.kimi.com/docs/api-reference/触发器/获取触发器.md): 返回单个触发器。cron 策略处于活跃状态时包含即将到来的运行时间。
- [更新触发器](https://platform.kimi.com/docs/api-reference/触发器/更新触发器.md): 仅修改请求体中出现的字段。传入空对象或空数组可清空集合，`null` 值视为未提供。状态变更通过暂停、恢复与归档操作进行。
- [归档触发器](https://platform.kimi.com/docs/api-reference/触发器/归档触发器.md): 永久归档触发器：归档后不再触发，`reuse_session` 绑定被释放，运行记录保留。
- [暂停触发器](https://platform.kimi.com/docs/api-reference/触发器/暂停触发器.md): 停止计划运行。进行中的运行不受影响，仍可手动运行。暂停已暂停的触发器为空操作。平台管理的触发器（`origin_type` 已设置）会被拒绝。
- [运行触发器](https://platform.kimi.com/docs/api-reference/触发器/运行触发器.md): 立即触发一次触发器——包括已暂停的触发器——并同步执行，返回终态的触发器运行记录（`completed`、`failed` 或 `skipped`）。
- [列出触发器运行](https://platform.kimi.com/docs/api-reference/触发器/列出触发器运行.md): 返回一个触发器的运行记录，最新在前。用 `has_error` 可只筛出失败的运行。
- [获取触发器运行](https://platform.kimi.com/docs/api-reference/触发器/获取触发器运行.md): 返回单次触发器运行。属于其他触发器的运行返回 404。
- [恢复触发器](https://platform.kimi.com/docs/api-reference/触发器/恢复触发器.md): 恢复已暂停触发器的计划运行。调度从当前时刻重新开始——暂停期间错过的运行不会补跑。平台管理的触发器（`origin_type` 已设置）会被拒绝。
- [列出凭据库（Vault）](https://platform.kimi.com/docs/api-reference/凭据库/列出凭据库（vault）.md): 返回调用方的凭据库（Vault），最新者在前。除非 `include_archived` 为 true，否则不包含已归档的凭据库。
- [创建凭据库（Vault）](https://platform.kimi.com/docs/api-reference/凭据库/创建凭据库（vault）.md): 创建一个凭据库（Vault），用于将凭据分组以绑定到会话。
- [检查凭据覆盖情况](https://platform.kimi.com/docs/api-reference/凭据库/检查凭据覆盖情况.md): 按请求顺序，报告每个请求的 MCP 服务器 URL 分别在哪些凭据库（Vault）中持有活跃凭据。
- [获取凭据库（Vault）](https://platform.kimi.com/docs/api-reference/凭据库/获取凭据库（vault）.md): 返回一个凭据库（Vault）的元数据。已归档的凭据库（Vault）仍可读取。
- [删除凭据库（Vault）](https://platform.kimi.com/docs/api-reference/凭据库/删除凭据库（vault）.md): 永久删除一个已归档的凭据库（Vault）及其全部凭据。
- [更新凭据库（Vault）](https://platform.kimi.com/docs/api-reference/凭据库/更新凭据库（vault）.md): 重命名凭据库（Vault）或替换其元数据。请求体中未出现的字段保持当前值。
- [归档凭据库（Vault）](https://platform.kimi.com/docs/api-reference/凭据库/归档凭据库（vault）.md): 归档凭据库（Vault）及其全部活跃凭据，并清除其秘密值。已归档的凭据不再对会话可用。
- [列出凭据](https://platform.kimi.com/docs/api-reference/凭据库/列出凭据.md): 返回凭据库（Vault）中的凭据，最新者在前，秘密值不返回。除非 `include_archived` 为 true，否则不包含已归档的凭据。
- [创建凭据](https://platform.kimi.com/docs/api-reference/凭据库/创建凭据.md): 在凭据库（Vault）中存储一条凭据。秘密值为只写：仅在请求中接受，静态加密存储，且在任何响应中都不返回。
- [批量创建凭据](https://platform.kimi.com/docs/api-reference/凭据库/批量创建凭据.md): 以原子方式创建 1–20 条凭据：任一条目校验失败则全部不创建。
- [获取凭据](https://platform.kimi.com/docs/api-reference/凭据库/获取凭据.md): 返回一条凭据的非秘密设置。秘密值不返回。已归档的凭据仍可读取。
- [删除凭据](https://platform.kimi.com/docs/api-reference/凭据库/删除凭据.md): 永久删除一条已归档的凭据。凭据必须先归档（否则返回 400 `failed_precondition_error`）。需要保留记录时请使用归档。
- [更新凭据](https://platform.kimi.com/docs/api-reference/凭据库/更新凭据.md): 重命名凭据或轮换其秘密设置。
- [归档凭据](https://platform.kimi.com/docs/api-reference/凭据库/归档凭据.md): 归档凭据，清除其秘密值并释放其唯一键，可用于新建替代凭据。已归档的凭据不再对会话可用，但仍可读取。
- [创建 OAuth 会话](https://platform.kimi.com/docs/api-reference/凭据库/创建-oauth-会话.md): 为一个 MCP 服务器发起 OAuth 授权流程，并返回需在浏览器中打开的 URL。完成授权会在凭据库（Vault）中创建一条 `mcp_oauth` 凭据。
- [获取 OAuth 会话](https://platform.kimi.com/docs/api-reference/凭据库/获取-oauth-会话.md): 返回 OAuth 授权流程的当前状态：进行中为 `pending`。成功为 `authorized`，并携带已创建的 `credential_id`。失败为 `failed`，并携带人类可读的 `error`。未知或已过期的 OAuth 会话返回 404。
- [模型推理价格说明](https://platform.kimi.com/docs/pricing/chat.md): 了解 Kimi 模型推理的 token 计费单位、输入输出计费方式、缓存优惠和各模型价格入口。
- [批量推理定价](https://platform.kimi.com/docs/pricing/batch.md): 查看 Kimi BatchJob 批量推理的输入、输出和缓存命中 token 价格及计费说明。
- [联网搜索定价](https://platform.kimi.com/docs/pricing/tools.md): 查看 Kimi 联网搜索与网页抓取工具的调用价格、计费单位和使用说明。
- [托管智能体定价](https://platform.kimi.com/docs/pricing/hosted-agents.md): 查看 Kimi 托管智能体（Hosted Agents）的沙箱、模型推理和插件定价。
- [充值与限速](https://platform.kimi.com/docs/pricing/limits.md): 查看 Kimi 开放平台的充值要求、账户等级与 RPM、TPM、TPD 限速，以及提升额度的方式。
- [模型列表](https://platform.kimi.com/docs/models.md): 查看 Kimi 开放平台当前可用的多模态与编程模型，以及已下线模型的迁移提示。
- [Kimi K3](https://platform.kimi.com/docs/guide/kimi-k3-quickstart.md): 了解 Kimi K3 的长程编程、知识工作、深度推理、视觉理解与 100 万 token 上下文能力。
- [Kimi K2.7 Code](https://platform.kimi.com/docs/guide/kimi-k2-7-code-quickstart.md): 了解 Kimi K2.7 Code 及高速版的编程、多模态、思考模式、工具调用与 256K 上下文能力。
- [Kimi K2.6](https://platform.kimi.com/docs/guide/kimi-k2-6-quickstart.md): 了解 Kimi K2.6 的文本、图片与视频理解、思考模式、工具调用和 256K 上下文能力。
- [加入开发者反馈社群！](https://platform.kimi.com/docs/api/join-the-community.md): 加入 Kimi 开发者反馈群，与开发者交流、反馈问题并分享 Build with Kimi 项目。
- [账号与财务](https://platform.kimi.com/docs/guide/account-and-payments.md): 查看 Kimi 开放平台的充值、余额、赠送金、发票、账单和企业实名认证等账号与财务问题。
- [问题排查](https://platform.kimi.com/docs/guide/troubleshooting.md): 排查 Kimi API 账号、计费、认证、模型参数、输出长度、限速和网络连接等常见问题。
- [如何解决重复调用问题](https://platform.kimi.com/docs/guide/tool-call-repeat.md): 排查 tool_calls 消息布局，并在业务侧检测重复工具调用，通过系统提示词提醒模型停止对同一工具的重复调用。
- [主要概念](https://platform.kimi.com/docs/introduction.md): 了解 Kimi API 的模型、Prompt、Token、上下文长度、流式输出、工具调用和多模态等基础概念。
- [与 Kimi 其他产品对比](https://platform.kimi.com/docs/guide/product-plans.md): Kimi API 开放平台是按量计费模式、无订阅制方案，与 Kimi 会员、Kimi Code 等产品不同，请注意区分。
- [什么是零数据保留（ZDR）？](https://platform.kimi.com/docs/guide/zero-data-retention.md): 了解 Kimi 开放平台面向企业客户提供的零数据保留（ZDR）模式。
- [基于 PDF 内容进行问答](https://platform.kimi.com/docs/guide/ask-questions-about-pdf-content.md): 使用 Kimi API 实现基于 PDF 内容的问答，附真实运行输出。
- [AI 可读文档](https://platform.kimi.com/docs/guide/ai-readable-docs.md): 通过 llms.txt、llms-full.txt、OpenAPI Schema 和单页 Markdown，将 Kimi 开放平台文档提供给 AI 编程助手、企业机器人或 RAG 系统。
- [Prompt 最佳实践](https://platform.kimi.com/docs/guide/prompt-best-practice.md): 通过清晰指令、示例、角色和输出约束编写更稳定、可控的 Kimi 系统提示与用户提示。
- [基准测试最佳实践](https://platform.kimi.com/docs/guide/benchmark-best-practice.md): 使用推荐参数、采样次数、流式请求和重试策略，对 Kimi 模型进行可复现的基准评测。
- [使用控制台进行批量推理](https://platform.kimi.com/docs/guide/use-batch-inference.md): 在 Kimi 开放平台控制台中创建、监控并下载批量推理任务结果，无需编写代码。
- [用 Kimi K3 搭建 Agent](https://platform.kimi.com/docs/guide/use-kimi-k3-to-setup-agent.md): 以行业信息整理为例，组合 Kimi K3、官方联网搜索和自定义工具，构建可运行的 Agent。
- [Muon 优化器的首次大规模训练实践](https://platform.kimi.com/docs/changelog/moonlight.md): 历史技术文章：了解 Moonlight 项目如何通过权重衰减和更新比例调整，将 Muon 优化器扩展到大模型训练。
- [MoBA：面向长文本大模型的混合块注意力机制](https://platform.kimi.com/docs/changelog/moba.md): 历史技术文章：了解 MoBA 如何将专家混合思想应用于稀疏注意力，以提高长文本模型的训练与推理效率。
- [Kimi 开放平台服务协议](https://platform.kimi.com/docs/agreement/modeluse.md): 了解 Kimi 开放平台的账号、API 使用、计费、数据与合规规则及双方权利义务。
- [Kimi 开放平台隐私政策](https://platform.kimi.com/docs/agreement/userprivacy.md): 了解 Kimi 开放平台如何收集、使用、存储、共享和保护个人信息，以及用户的数据权利。
- [Kimi 用户服务协议](https://platform.kimi.com/docs/agreement/userservice.md): 了解 Kimi 用户服务的账号管理、使用规范、知识产权、责任限制与争议解决条款。
- [Kimi 开放平台充值协议](https://platform.kimi.com/docs/agreement/payment.md): 了解 Kimi 开放平台充值、余额使用、退款、发票与相关风险提示。
- [平台新功能发布记录](https://platform.kimi.com/docs/changelog/index.md): 查看 Kimi 开放平台的历史功能发布、模型上线、产品优化与问题修复记录。

## OpenAPI Specs

- [openapi](/docs/hosted-agents/openapi.yaml)
- [openapi](/docs/openapi.json)

## Optional

- [开发工作台](https://platform.kimi.com/playground)