Kimi K3.1 Pro

模型简介

Kimi K3.1 Pro 是全新 K3.1 系列的第一个模型，也是我们迄今能力最强的 3 万亿级参数模型，支持 100 万上下文。K3.1 Pro 在代码、3D 创作、金融研究和其他长程 Agent 能力上的提升尤为显著。我们同步推出高速版模型 Kimi K3.1 Pro Highspeed，同等智能，输出速度约 2~3 倍。完整模型权重将于 11 月 4 日前发布。

持续突破前沿

在 Kimi K3.1 Pro 的研发中，我们大幅增加了强化学习（RL）环节的算力投入。为了支撑数百个下游领域的大规模联合训练，我们优化了技术栈的每一层，包括 RL 框架、长上下文推理、训练效率、沙箱基础设施、调度系统，以及用于环境质量检查的共享平台等，确保每一份新增的 RL 算力都能转化为稳定、高效的回报。

在代码、Agent 和知识类基准上，K3.1 Pro 达到或接近最强闭源模型的水平。Terminal-Bench 4.0 通过真实环境中资源受限的终端任务考察编程智能体的能力，每项任务均设有严格的专项测试。K3.1 Pro 在此项评估中得分 65.7%，超过 GPT-6 Astra（58.2%），与 Claude Opus 5.5（66.4%）仅有微弱差距。Kimi Code Bench 3.0 Long-horizon 是我们内部的基准测试，覆盖多种工程领域，重点考察编程智能体的多步执行、工具调用和端到端问题解决能力。K3.1 Pro 在此项测试中得分 61.2%，高于 K3 的 55.95%。

快速开始

代码

各种规模的编码任务，Kimi K3.1 Pro 都能完成：小到在真实代码库里修复一个问题，大到从零搭建一个完整项目。它也为游戏和网页体验带来更考究的视觉风格，并且知道如何用合适的外部专业工具把它们做出来。 K3.1 Pro 能熟练使用 Unity、Unreal Engine、Godot 等游戏引擎，并结合网络搜索与 3D 生成，做出完整的体验。它产出的前端页面、Three.js 交互场景和 3D 资产，在构图、排版、动效和细节打磨上都有明显提升。以下案例均由 K3.1 Pro 端到端完成：

3D 建模

Kimi K3.1 Pro 模型擅长 3D 创作与空间推理。给它一段文字描述、一张草图或一张参考图，它能推断出物体的形状、比例和空间关系，并将其重建为可用的 3D 模型。Kimi K3.1 Pro 可以不依赖 MCP 连接器，直接编写并运行 Blender、SolidWorks、Rhino 等专业建模软件脚本，完成素材构建、几何与材质细化、场景搭建，最后将成果接入 Three.js 场景或游戏引擎。

K3.1 Pro 擅长参数化建模，例如机械零件、建筑模型、多参数可配置的产品和定制家具。无需依赖 MCP 连接器，它可以直接编写并运行 Blender、CAD 等专业建模工具的脚本，完成素材的构建与细化，修改单个部件，并调整几何、材质与场景布局。以下案例均由 Kimi K3.1 Pro 端到端完成，可直接用于品牌宣传片、游戏和交互式网页体验。

快速开始

金融

凭借更强的推理与工具调用能力，Kimi K3.1 Pro 能够端到端交付完整的金融工作流。在外部基准上，K3.1 Pro 在 Office QA Pro v2 和 SpreadsheetBench 2 上均取得最佳成绩，两项均超过 Opus 5.5、Fable 5.1 和 GPT 6 Astra。Office QA Pro v2 考察基于真实金融文档的复杂财务数据分析，涉及检索、跨文档核对与多步数值推理；SpreadsheetBench 2 评估端到端的电子表格工作流，包括财务建模、跨表公式依赖与错误诊断。在衡量完整投资工作流（从标的筛选到盈利能力分析）的 Frontier Finance 上，K3.1 Pro 相比 K3 也有提升。

金融分析和投资研究对事实准确性有很高要求。为此，我们针对高难度真实工作场景和高难度提示词，对 K3.1 Pro 的事实准确性进行了专项优化。在用户标记过事实错误的一组去标识化对话测试中，相较于 k3，新模型的单项事实陈述错误率从 23.35% 降至 6.85%；包含至少一处事实错误的回答比例仅为前代的约 46.4%。（这是一项针对事实准确性的压力测试，样本刻意聚焦模型容易出错的情形，所报告的错误率不代表日常使用中的整体水平。）

访问条件

Kimi K3.1 Pro 是旗舰模型：在开放平台完成充值（最低充值金额 10 元）后即可解锁调用。新用户注册认证赠送的 15 元代金券不可用于 Kimi K3.1 Pro。累计充值金额同时决定账户等级与速率限制（并发、RPM、TPM、TPD），详见充值与限速。

立即开始

以下示例需要 Python 3.9+ 和 OpenAI SDK。先安装 SDK，并初始化一次客户端；后续 Python 示例复用 client。

python3 -m pip install --upgrade 'openai>=1.0'

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="https://api.moonshot.cn/v1",
)

基础调用

K3.1 Pro 提供高速版本 kimi-k3.1-pro-highspeed，模型 ID 与价格见产品定价。

Python
cURL

completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=[{"role": "user", "content": "用一句话介绍 Kimi K3.1 Pro。"}],
)

print(completion.choices[0].message.content)

curl https://api.moonshot.cn/v1/chat/completions \
  --header "Authorization: Bearer $MOONSHOT_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "kimi-k3.1-pro",
    "messages": [{"role": "user", "content": "用一句话介绍 Kimi K3.1 Pro。"}]
  }'

推理强度

K3.1 Pro 始终开启思考模式，并支持通过请求顶层 reasoning_effort 配置推理强度。推理强度支持 low / high / max 三档（默认 max）。用法见推理强度。

completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    reasoning_effort="max",
    messages=[{"role": "user", "content": "证明根号 2 是无理数。"}],
)

print(completion.choices[0].message.content)

多轮对话和工具调用时，将 API 返回的完整 assistant message 原样加入下一次请求，不要只保留 content。

流式输出

流式响应分别提供推理增量 reasoning_content 和最终答案增量 content。更多细节见流式输出。

stream = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=[{"role": "user", "content": "解释为什么天空是蓝色的。"}],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta
    reasoning = getattr(delta, "reasoning_content", None)
    if reasoning:
        print(reasoning, end="", flush=True)
    if delta.content:
        print(delta.content, end="", flush=True)

视觉输入

视觉消息的 content 必须是对象数组，而不是序列化后的字符串。完整格式与限制见视觉输入。

本地图片
视频文件

import base64
from pathlib import Path

image_data: str = base64.b64encode(Path("image.png").read_bytes()).decode()
completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image_url",
                    "image_url": {"url": f"data:image/png;base64,{image_data}"},
                },
                {"type": "text", "text": "描述这张图片。"},
            ],
        }
    ],
)

print(completion.choices[0].message.content)

from pathlib import Path

video = client.files.create(file=Path("video.mp4"), purpose="video")
try:
    completion = client.chat.completions.create(
        model="kimi-k3.1-pro",
        messages=[
            {
                "role": "user",
                "content": [
                    {
                        "type": "video_url",
                        "video_url": {"url": f"ms://{video.id}"},
                    },
                    {"type": "text", "text": "概括这个视频。"},
                ],
            }
        ],
    )
    print(completion.choices[0].message.content)
finally:
    client.files.delete(video.id)

结构化输出

使用 json_schema 和 strict: true 约束最终 message.content，只解析该字段，不解析 reasoning_content。

姓名与年龄 schema

import json

completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=[
        {"role": "user", "content": "小林今年 28 岁。提取姓名和年龄。"}
    ],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "person",
            "strict": True,
            "schema": {
                "type": "object",
                "properties": {
                    "name": {"type": "string"},
                    "age": {"type": "integer"},
                },
                "required": ["name", "age"],
                "additionalProperties": False,
            },
        },
    },
)

person: dict[str, object] = json.loads(
    completion.choices[0].message.content or "{}"
)
print(person)

详见结构化输出。

Partial Mode

在消息末尾添加 partial=True 的 assistant message，让模型从指定文本前缀继续生成。最终展示时需要自行拼接前缀。

prefix: str = "结论："
completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=[
        {"role": "user", "content": "用一句话说明保持接口兼容的重要性。"},
        {"role": "assistant", "content": prefix, "partial": True},
    ],
)

print(prefix + (completion.choices[0].message.content or ""))

详见 Partial Mode 。

自定义工具与 `tool_choice`

首轮用 tool_choice="required" 强制至少调用一个工具。执行每个调用后，回传完整 assistant message，并用对应的 tool_call_id 逐条追加工具结果。

最小天气 Agent Loop

import json
from typing import Any

tools: list[dict[str, Any]] = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "查询城市天气",
            "parameters": {
                "type": "object",
                "properties": {"city": {"type": "string"}},
                "required": ["city"],
            },
        },
    }
]
messages: list[Any] = [
    {"role": "user", "content": "北京今天天气怎么样？"}
]

first = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=messages,
    tools=tools,
    tool_choice="required",
)
assistant_message = first.choices[0].message
messages.append(assistant_message)

for tool_call in assistant_message.tool_calls or []:
    arguments: dict[str, str] = json.loads(tool_call.function.arguments)
    result: str = json.dumps(
        {"city": arguments["city"], "weather": "晴", "temperature_c": 24},
        ensure_ascii=False,
    )
    messages.append(
        {"role": "tool", "tool_call_id": tool_call.id, "content": result}
    )

final = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=messages,
    tools=tools,
)
print(final.choices[0].message.content)

详见工具调用约束。

动态加载工具

把完整工具定义放进一条不含 content 的 system message，即可从该位置起加载工具。

动态加载计算器

from typing import Any

dynamic_messages: list[dict[str, Any]] = [
    {"role": "user", "content": "计算 23 乘以 47。"},
    {
        "role": "system",
        "tools": [
            {
                "type": "function",
                "function": {
                    "name": "calculate",
                    "description": "计算一个算术表达式",
                    "parameters": {
                        "type": "object",
                        "properties": {
                            "expression": {
                                "type": "string",
                                "description": "待计算的算术表达式",
                            }
                        },
                        "required": ["expression"],
                    },
                },
            }
        ],
    },
]
completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=dynamic_messages,
)

print(completion.choices[0].message.tool_calls)

工具定义必须包含完整的 name、description 和 parameters。
声明从该 message 所在位置起生效。
后续请求仍需在历史中携带该 message，服务端不会保存声明。

详见动态加载工具。

1M 上下文与 TTL 缓存

上下文缓存对普通模型请求自动生效，无需手动创建缓存：满足条件的前缀写入缓存后，命中部分按缓存命中价格计费，写入会产生一次性的缓存写入费用。TTL 支持 5m（默认）与 1h，建议按业务请求间隔选择——连续追问等间隔较短的场景用默认 5m 即可；间隔可能超过 5 分钟时，传 prompt_cache_options.ttl 选择 1h 档，避免缓存过期后重复写入。缓存按块存储，不足一整块的部分无法写入缓存，会计为缓存未命中。

from pathlib import Path

knowledge: str = Path("knowledge-base.md").read_text(encoding="utf-8")

for question in ["总结关键结论。", "列出三个实施风险。"]:
    completion = client.chat.completions.create(
        model="kimi-k3.1-pro",
        messages=[
            {"role": "system", "content": knowledge},
            {"role": "user", "content": question},
        ],
    )
    print(completion.choices[0].message.content)

如何选择 TTL、提高命中率并验证用量，详见上下文缓存。

官方工具

官方工具通过 Formula 接入：

从 Formula 的 /tools 接口获取工具定义。
将定义加入 Chat Completions 请求的 tools。
收到 tool_calls 后，将对应函数名和参数提交到 Formula 的 /fibers 接口。
将完整 assistant message 和 Fiber 输出作为对应的 tool message 加入历史。
再次调用 Chat Completions，直到模型返回最终答案。

完整客户端与接口契约见官方工具。联网搜索工具正在更新，近期不建议使用。

重要限制

推理强度通过请求顶层 reasoning_effort 配置，支持 low / high / max（默认 max）；K3.1 Pro 始终开启思考模式。
max_completion_tokens 默认 131072，最大可设置为 1048576。
temperature=1.0、top_p=0.95、n=1、presence_penalty=0、frequency_penalty=0 为固定值，建议不要显式传入。
多轮对话和工具调用必须原样回传完整 assistant message。
视觉输入不支持公网图片 URL；请使用 base64 或 ms://<file-id>，并确保 content 是对象数组。
联网搜索正在更新，近期不建议用于生产流程。

常见问题

Kimi K3.1 Pro 如何计费？

Kimi K3.1 Pro 上下文长度为 1M tokens，计费不按上下文长度分段，所有用量均按量付费。计费项包括：缓存写入（区分 TTL 5min / TTL 1h 两档）、输入（区分缓存命中与未命中）和输出，均按统一单价计费，详见 Kimi K3.1 Pro 定价。

新用户赠送的 15 元代金券可以体验 Kimi K3.1 Pro 吗？

不可以。模型发布后，国内注册并完成认证的用户获赠的 15 元代金券不可用于体验 Kimi K3.1 Pro，请充值后解锁使用。

Kimi K3.1 Pro 的思维链怎么关？

目前关不了，K3.1 Pro 始终开启思考模式。如果觉得思考过程太长，可以将 reasoning_effort 设置为 low 降低推理强度，详见推理强度。

Kimi K3.1 Pro 定价

查看输入与输出价格。

推理强度

配置 reasoning_effort。

视觉输入

发送图片与视频。

结构化输出

使用严格 JSON Schema。

Partial Mode

从指定前缀继续生成。

工具调用约束

控制模型是否调用工具。

动态加载工具

按需注入工具定义。

工具调用最佳实践

组合工具调用能力。

官方工具

接入 Formula 工具。

开始使用

模型能力

工具调用

核心工作流

生态集成

调试与运维

模型简介

持续突破前沿

代码

3D 建模

金融

访问条件

立即开始

基础调用

推理强度

流式输出

视觉输入

结构化输出

Partial Mode

自定义工具与 `tool_choice`

动态加载工具

1M 上下文与 TTL 缓存

官方工具

重要限制

常见问题

相关文档

Kimi K3.1 Pro 定价

推理强度

视觉输入

结构化输出

Partial Mode

工具调用约束

动态加载工具

工具调用最佳实践

官方工具

​模型简介

​持续突破前沿

​代码

​3D 建模

​金融

​访问条件

​立即开始

​基础调用

​推理强度

​流式输出

​视觉输入

​结构化输出

​Partial Mode

​自定义工具与 tool_choice

​动态加载工具

​1M 上下文与 TTL 缓存

​官方工具

​重要限制

​常见问题

​相关文档

Kimi K3.1 Pro 定价

推理强度

视觉输入

结构化输出

Partial Mode

工具调用约束

动态加载工具

工具调用最佳实践

官方工具

模型简介

持续突破前沿

代码

3D 建模

金融

访问条件

立即开始

基础调用

推理强度

流式输出

视觉输入

结构化输出

Partial Mode

自定义工具与 `tool_choice`

动态加载工具

1M 上下文与 TTL 缓存

官方工具

重要限制

常见问题

相关文档