来源已核对Kimi API Platform 官方文档
Kimi K3.1 Pro API 快速入门：模型 ID、base_url 与 OpenAI SDK 调用
接入 Kimi K3.1 Pro 时使用模型 ID kimi-k3.1-pro、base_url=https://api.moonshot.ai/v1 和 OpenAI SDK 的 Chat Completions 接口；该旗舰模型需至少成功充值 $1 才能解锁，累计充值金额决定账户层级及并发、RPM、TPM、TPD 限制。
内容类型配置指南
输入旗舰模型 kimi-k3.1-pro；官方页面另列高速变体 kimi-k3.1-pro-highspeed，其价格和可用性需单独核对。、Python 3.9+、openai>=1.0、Kimi API Chat Completions，以及使用同一 OpenAI 兼容端点的客户端。
状态Python 3.9+、openai>=1.0、Kimi API Chat Completions，以及使用同一 OpenAI 兼容端点的客户端。
API 配置
来源已核对Kimi API Platform 官方文档
Kimi K3.1 Pro 推理档位与参数配置：reasoning_effort 的 low、high、max
Kimi K3.1 Pro 始终进行推理，使用 Chat Completions 请求顶层的 reasoning_effort 设置推理档位；可选值为 low、high、max，默认值为 max。
内容类型配置指南
输入官方页面明确覆盖 kimi-k3.1-pro；页面将该字段称为 K3 的顶层推理字段，未列出其他模型版本的兼容性清单。、Kimi API 的 Chat Completions 接口，以及能够透传顶层 reasoning_effort 字段的兼容客户端。
状态Kimi API 的 Chat Completions 接口，以及能够透传顶层 reasoning_effort 字段的兼容客户端。
API 配置reasoning
来源已核对Kimi API Platform 官方文档
Kimi K3.1 Pro 图片与视频输入配置：Base64、文件 ID 与多模态消息结构
Kimi K3.1 Pro 的视觉请求把用户消息的 content 写成 JSON 数组；图片可用 Base64 image_url，视频应先上传后用 ms://<file-id> 的 video_url 引用。
内容类型配置指南
输入kimi-k3.1-pro；官方页面同时列出 kimi-k3、kimi-k2.6、kimi-k2.7-code 和 kimi-k2.7-code-highspeed，并说明这些模型可理解视频。、Kimi API 的 Chat Completions；官方示例使用 Python OpenAI SDK 和 https://api.moonshot.ai/v1。
状态Kimi API 的 Chat Completions；官方示例使用 Python OpenAI SDK 和 https://api.moonshot.ai/v1。
API 配置视觉原型
来源已核对Kimi API Platform 官方文档
Kimi K3.1 Pro JSON Schema 结构化输出配置：strict、MFJS 与最终内容解析
Kimi K3.1 Pro 使用 response_format.type="json_schema" 和 strict=true 约束字段、类型及嵌套结构；客户端只解析 choices[0].message.content，不要把 reasoning_content 或整个响应对象当作 JSON 正文。
内容类型配置指南
输入kimi-k3.1-pro。、Kimi API Chat Completions；官方示例使用 Python OpenAI SDK 和 https://api.moonshot.ai/v1。
状态Kimi API Chat Completions；官方示例使用 Python OpenAI SDK 和 https://api.moonshot.ai/v1。
API 配置信息抽取
来源已核对Kimi API Platform 官方文档
Kimi K3.1 Pro 多轮消息与工具历史：完整保留 reasoning_content
Kimi K3.1 Pro 的多轮对话和工具调用必须把 API 返回的完整 assistant 消息原样放回 messages，包括 reasoning_content；客户端不能只保存最终答案。
内容类型工作流
输入kimi-k3.1-pro。本文的历史保留要求以官方页面对该模型的说明为准。、Kimi API Chat Completions，以及能保留并透传 assistant 原始字段的客户端或 Agent。
状态Kimi API Chat Completions，以及能保留并透传 assistant 原始字段的客户端或 Agent。
API 配置Agent
来源已核对Kimi API Platform 官方文档
Kimi K3.1 Pro Partial Mode 前缀续写：补齐截断输出与固定角色开场
Kimi K3.1 Pro 的 Partial Mode 要在消息末尾追加 role="assistant"、partial=True 的消息，把希望保留的文本放入 content；API 返回的内容不含这段前缀，客户端必须手动拼回。
内容类型提示方法
输入本页当前示例默认使用 kimi-k3.1-pro；其他模型（例如 kimi-k3.1-pro-highspeed）需要替换 model 并重新核对参数。、Kimi API Chat Completions，以及能保留 assistant 原始字段的 OpenAI 兼容客户端。
状态Kimi API Chat Completions，以及能保留 assistant 原始字段的 OpenAI 兼容客户端。
API 配置写作
来源已核对Kimi API Platform 官方文档
Kimi K3.1 Pro 上下文前缀缓存与 TTL 配置：自动写入、命中与用量核对
Kimi API 会按请求前缀自动复用固定内容；Kimi K3.1 Pro 支持 Cache Write，可用默认 5m 或显式 1h TTL，但必须保持稳定前缀的顺序与文本不变，并按 API 的 usage 字段核对命中和写入。
内容类型配置指南
输入kimi-k3.1-pro；官方 FAQ 明确列出其支持 Cache Write。、Kimi API 的 Chat Completions、Responses；Anthropic Messages 使用对应的顶层 cache_control。
状态Kimi API 的 Chat Completions、Responses；Anthropic Messages 使用对应的顶层 cache_control。
API 配置cost
来源已核对Kimi API Platform 官方文档
Kimi K3.1 Pro 动态工具加载工作流：按需注入工具并保留缓存前缀
Kimi K3.1 Pro 可在对话需要时，通过追加 role="system" 且带 tools 的消息注入完整工具定义；按原样保留已加载定义，能减少工具定义 token，并维持已有前缀缓存。
内容类型工作流
输入kimi-k3.1-pro；文档同时明确支持 kimi-k3。、Kimi API Chat Completions，以及能按消息追加完整工具定义的客户端或后端。
状态Kimi API Chat Completions，以及能按消息追加完整工具定义的客户端或后端。
API 配置Agent
来源已核对Kimi API Platform 官方文档
Kimi K3.1 Pro 工具调用执行循环：Schema、JSON 参数与 tool_call_id 回传
工具调用的闭环是：提交 JSON Schema 工具定义，读取 finish_reason=tool_calls 的调用列表，解析每个 function.arguments，由客户端执行，再用匹配的 tool_call_id 追加 role="tool" 结果，直到模型返回 finish_reason=stop。
内容类型工作流
输入页面当前示例默认使用 kimi-k3.1-pro；页面还提到可替换为 kimi-k3.1-pro-highspeed，但本稿没有把 Highspeed 当作等价实测版本。、Kimi API Chat Completions；官方示例使用 OpenAI Python SDK 或 HTTP 流式响应，由应用自己执行工具。
状态Kimi API Chat Completions；官方示例使用 OpenAI Python SDK 或 HTTP 流式响应，由应用自己执行工具。
API 配置Agent
来源已核对Kimi API Platform 官方文档
Kimi K3.1 Pro Tool Choice 配置：自动、强制与禁用工具调用
Kimi K3.1 Pro 的 tool_choice 可按请求选择自动判断、禁止工具、至少调用一个工具，或指定某个函数；工具搜索常用首轮 required、检索后切回 auto。
内容类型配置指南
输入kimi-k3.1-pro；官方完整请求示例明确使用该模型 ID。、Kimi API Chat Completions；请求由客户端声明 tools 并处理工具结果。
状态Kimi API Chat Completions；请求由客户端声明 tools 并处理工具结果。
API 配置Agent
来源已核对Kimi API Platform（Moonshot AI 官方文档）
Kimi API 官方提示词最佳实践：任务约束与示例提示指南
Kimi 官方建议把任务、背景、角色、输入边界、执行步骤、参考文本、示例和输出约束写清楚；复杂或长对话任务还应分类、摘要或分块处理，以减少模型猜测。
内容类型提示方法
输入Kimi API 文档没有在本页限定具体模型版本；页面顶部有 Kimi K3.1 Pro 上线提示，但正文是通用提示指南。、Kimi API 的 Chat Completions 消息，尤其是 system 与 user 消息；具体客户端仍需按自身接口组装请求。
状态Kimi API 的 Chat Completions 消息，尤其是 system 与 user 消息；具体客户端仍需按自身接口组装请求。
写作研究信息抽取
Tabbit