> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anyfast.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kimi K3.1 Pro

> 通过 AnyFast OpenAI 兼容接口调用 Kimi K3.1 Pro 和 Kimi K3.1 Pro Highspeed。

Kimi K3.1 Pro 是月之暗面 K3.1 系列的旗舰模型，面向长周期编码、3D 创作、金融研究和端到端智能体工作流。官方将其定位为 3 万亿级参数模型，支持原生视觉理解和 1,048,576 token 上下文窗口。

Kimi K3.1 Pro Highspeed 保持相同的模型定位和上下文窗口。月之暗面公开说明其输出速度约为标准版的 2～3 倍。需要平衡价格和速度时使用标准版；对响应延迟更敏感时使用高速版。

> [!NOTE]
>
> 公开模型 ID 为 `kimi-k3.1-pro` 和 `kimi-k3.1-pro-highspeed`。模型是否已为你的 AnyFast 项目开通，以项目模型列表为准。本页依据当前 Kimi API 契约编写，生产调用前请确认项目中已启用对应 ID。

## 模型对比

| 模型 | 定位 | 上下文窗口 | 速度 | 推理 |
| - | - | -: | - | - |
| `kimi-k3.1-pro` | 面向编码、3D、金融和长周期智能体的标准旗舰版 | 1,048,576 tokens | 标准 | 始终开启；`low`、`high` 或 `max` |
| `kimi-k3.1-pro-highspeed` | 保持同等能力目标的高速版 | 1,048,576 tokens | 官方描述约为标准版 2～3 倍 | 始终开启；`low`、`high` 或 `max` |

两个模型使用相同的请求格式，支持文本、图片和视频输入、函数工具、结构化输出、流式输出、Partial Mode，以及符合条件时的自动前缀缓存。切换模型时只需修改 `model` 字段。

## 快速示例

```bash cURL theme={null}
curl https://www.anyfast.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kimi-k3.1-pro",
    "reasoning_effort": "high",
    "messages": [
      {"role": "user", "content": "请说明如何安全审查一个大型代码库。"}
    ]
  }'
```

```python Python theme={null}
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://www.anyfast.ai/v1",
)

completion = client.chat.completions.create(
    model="kimi-k3.1-pro-highspeed",
    reasoning_effort="high",
    messages=[
        {"role": "user", "content": "请说明如何安全审查一个大型代码库。"}
    ],
)

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

## 推理强度

K3.1 Pro 始终进行推理。通过顶层 `reasoning_effort` 设置 `low`、`high` 或 `max`，默认值为 `max`。不要向这两个模型传入 K2.x 的 `thinking` 对象。长对话开始后再切换强度可能导致前缀缓存无法复用。

```python theme={null}
completion = client.chat.completions.create(
    model="kimi-k3.1-pro",
    reasoning_effort="max",
    messages=[
        {"role": "user", "content": "请为这个服务设计一套可靠的迁移方案。"}
    ],
)
```

## 多模态输入

将文本、图片或视频放在带类型的 `content` 数组中。AnyFast 支持 `image_url` 或 `video_url` 中的公开 URL 和 Base64 Data URI。

```json theme={null}
{
  "model": "kimi-k3.1-pro",
  "messages": [
    {
      "role": "user",
      "content": [
        {"type": "image_url", "image_url": {"url": "https://example.com/diagram.png"}},
        {"type": "text", "text": "请总结这张图。"}
      ]
    }
  ]
}
```

## 工具调用与多轮对话

在顶层定义函数工具，并使用 `tool_choice` 的 `auto`、`none` 或 `required`。执行工具后，将完整 assistant 消息和每个 `tool_call_id` 对应的 `role: "tool"` 结果追加到下一轮请求。

多轮请求必须保留 AnyFast 返回的完整 assistant 消息，包括 `reasoning_content` 和 `tool_calls`，不要只拼接可见文本。

## 参数与限制

| 参数 | 类型 | 必需 | 说明 |
| - | - | - | - |
| `model` | string | 是 | `kimi-k3.1-pro` 或 `kimi-k3.1-pro-highspeed` |
| `messages` | array | 是 | 支持文本、图片、视频和工具消息的对话历史 |
| `reasoning_effort` | string | 否 | `low`、`high` 或 `max`，默认为 `max` |
| `max_completion_tokens` | integer | 否 | 默认 131,072，最大 1,048,576；输入与输出总量不能超过 100 万 token 上下文 |
| `stream` | boolean | 否 | 是否启用 SSE 流式输出，默认为 `false` |
| `stream_options` | object | 否 | 设置 `include_usage: true` 后，在最后一个流式数据块返回用量 |
| `response_format` | object | 否 | `text`、`json_object` 或 `json_schema` |
| `tools` | array | 否 | 提供给模型的函数定义 |
| `tool_choice` | string | 否 | `auto`、`none` 或 `required` |
| `stop` | string / array | 否 | 最多五个停止字符串，每个不超过 32 字节 |
| `prompt_cache_key` | string | 否 | 稳定的会话或任务标识，有助于复用前缀缓存 |
| `safety_identifier` | string | 否 | 稳定的终端用户标识，建议使用单向哈希而不是直接传个人信息 |

> [!NOTE]
>
> K3 系列采样参数是固定值：`temperature` 为 `1.0`，`top_p` 为 `0.95`，`n` 为 `1`，`presence_penalty` 和 `frequency_penalty` 为 `0`。请勿显式传入这些参数。

> [card] [API 参考](https://docs.anyfast.ai/zh/api-reference/model-api/moonshot/kimi-k3-1-pro.md)
>
> 查看两个 K3.1 Pro 模型 ID 的请求和响应定义。

> [card] [Kimi 官方文档](https://platform.kimi.com/docs/guide/kimi-k3-1-pro-quickstart)
>
> 查看官方模型指南、API 示例和限制说明。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.