Kimi K3.1 Pro

请求 ID k3.1-pro

协议

POST /v1/chat/completions · Chat Completions示例
POST /v1/messages · Anthropic Messages示例
POST /v1/messages/count_tokens · Count Tokens示例
POST /v1/responses · OpenAI Responses示例
POST /v1/responses/compact · Responses Compact示例

认证

请求需要 API Key。在控制台的 API Key 管理获取密钥。发送 JSON 请求时，设置 Content-Type: application/json。

Authorization: Bearer YOUR_API_KEY
Anthropic Messages · x-api-key: YOUR_API_KEY

请求参数

`POST /v1/chat/completions`

参数	类型	是否必填	说明
`model`	`string`	必填	填写模型 ID `k3.1-pro`。
`messages`	`object[]`	必填	按会话顺序发送消息。每条消息包含 `role` 和 `content`。
`messages[].content`	`string / object[]`	视条件	消息正文。可用纯文本或协议定义的内容块数组。
`messages[].content[]`	`object`	视条件	图片输入使用 `type: image_url` 的内容块。可用图片格式取决于所选接入点。
`stream`	`boolean`	选填	`true` 请求 SSE 流式响应，`false` 请求普通 JSON。以所选接入点支持的模式为准。
`max_completion_tokens`	`integer`	视条件	限制生成 token 数，包含模型适用的推理 token。仅在所选接入点支持此字段时使用。
`max_tokens`	`integer`	视条件	兼容字段，限制输出 token 数。按所选接入点的要求，在此字段与 `max_completion_tokens` 中选一个。
`temperature`	`number`	视条件	控制采样随机性。可用取值以及该字段是否生效，取决于模型和接入点。
`top_p`	`number`	视条件	按累计概率限制采样候选。仅在所选模型和接入点支持时使用。
`response_format`	`object`	视条件	请求结构化输出时可设 `type: json_object`，或在支持 JSON Schema 时设 `type: json_schema` 并提供 `json_schema`。
`reasoning_effort`	`string`	视条件	请求的推理强度。有效档位和是否能关闭推理取决于模型及所选接入点。
`tools`	`object[]`	视条件	供模型调用的工具定义。工具类型与参数格式以所选协议和接入点支持的能力为准。
`tool_choice`	`string / object`	视条件	控制工具选择。强制或指定工具只在所选接入点明确支持时使用。

`POST /v1/messages`

参数	类型	是否必填	说明
`model`	`string`	必填	填写模型 ID `k3.1-pro`。
`messages`	`object[]`	必填	按会话顺序发送 `user` 和 `assistant` 消息。系统指令放在顶层 `system`。
`messages[].content`	`string / object[]`	必填	消息正文。可用纯文本或协议定义的内容块数组。
`messages[].content[]`	`object`	视条件	图片输入使用 `type: image` 的内容块，图片数据放在 `source`。可用格式取决于所选接入点。
`system`	`string / object[]`	选填	系统指令。可用文本或文本块数组。
`max_tokens`	`integer`	必填	输出 token 的上限。可用上限因模型和接入点而异。
`stream`	`boolean`	选填	`true` 请求 SSE 流式响应，`false` 请求普通 JSON。以所选接入点支持的模式为准。
`temperature`	`number`	视条件	控制采样随机性。可用取值以及该字段是否生效，取决于模型和接入点。
`top_p`	`number`	视条件	按累计概率限制采样候选。仅在所选模型和接入点支持时使用。
`tools`	`object[]`	视条件	供模型调用的工具定义。工具类型与参数格式以所选协议和接入点支持的能力为准。
`tool_choice`	`object`	视条件	控制工具选择。强制或指定工具只在所选接入点明确支持时使用。

`POST /v1/messages/count_tokens`

参数	类型	是否必填	说明
`model`	`string`	必填	填写模型 ID `k3.1-pro`。
`messages`	`object[]`	必填	按会话顺序发送 `user` 和 `assistant` 消息。系统指令放在顶层 `system`。
`messages[].content`	`string / object[]`	必填	消息正文。可用纯文本或协议定义的内容块数组。
`messages[].content[]`	`object`	视条件	图片输入使用 `type: image` 的内容块，图片数据放在 `source`。可用格式取决于所选接入点。
`system`	`string / object[]`	选填	系统指令。可用文本或文本块数组。
`tools`	`object[]`	视条件	需要计入输入 token 的工具定义。传入与实际 Messages 请求相同的工具。

`POST /v1/responses`

参数	类型	是否必填	说明
`model`	`string`	必填	填写模型 ID `k3.1-pro`。
`input`	`string / object[]`	必填	输入文本，或按顺序排列的输入项数组。消息项使用 `role` 和 `content`。
`input[].content[]`	`object`	视条件	图片输入使用 `type: input_image` 的内容块。可用图片格式取决于所选接入点。
`instructions`	`string`	选填	模型应遵循的指令，用于设定任务和输出要求。
`max_output_tokens`	`integer`	选填	输出 token 的上限。可用上限因模型和接入点而异。
`stream`	`boolean`	选填	`true` 请求 SSE 流式响应，`false` 请求普通 JSON。以所选接入点支持的模式为准。
`store`	`boolean`	视条件	支持此字段时，`false` 请求不保留此响应以供后续检索。
`text.format`	`object`	视条件	结构化输出使用 `text.format`，例如 `type: json_schema`。只在所选接入点支持该格式时使用。
`temperature`	`number`	视条件	控制采样随机性。可用取值以及该字段是否生效，取决于模型和接入点。
`top_p`	`number`	视条件	按累计概率限制采样候选。仅在所选模型和接入点支持时使用。
`reasoning.effort`	`string`	视条件	请求的推理强度。有效档位和是否能关闭推理取决于模型及所选接入点。
`tools`	`object[]`	视条件	供模型调用的工具定义。工具类型与参数格式以所选协议和接入点支持的能力为准。
`tool_choice`	`string / object`	视条件	控制工具选择。强制或指定工具只在所选接入点明确支持时使用。

`POST /v1/responses/compact`

参数	类型	是否必填	说明
`model`	`string`	必填	填写模型 ID `k3.1-pro`。
`input`	`string / object[]`	必填	要压缩的上下文。可以传文本，或按原顺序传入会话输入项。可用格式取决于接入点。

请求示例

先将 API Key 设置为本机环境变量 ICODEEASY_API_KEY，并选择支持直接 HTTP 调用的接入点。接入点要求特定客户端时，按对应客户端指南配置。

Chat Completions

bash

curl -sS 'https://api.icodeeasy.cc/v1/chat/completions' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "k3.1-pro",
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ],
  "stream": false
}'

Anthropic Messages

bash

curl -sS 'https://api.icodeeasy.cc/v1/messages' \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "k3.1-pro",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

Count Tokens

bash

curl -sS 'https://api.icodeeasy.cc/v1/messages/count_tokens' \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "k3.1-pro",
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

OpenAI Responses

bash

curl -N -sS 'https://api.icodeeasy.cc/v1/responses' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "k3.1-pro",
  "instructions": "You are a helpful assistant.",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Explain how a rainbow forms in one sentence."
        }
      ]
    }
  ],
  "stream": true,
  "store": false
}'

Responses Compact

bash

curl -sS 'https://api.icodeeasy.cc/v1/responses/compact' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "k3.1-pro",
  "input": "Explain how a rainbow forms in one sentence."
}'

读取响应

Chat Completions · 从 choices[].message.content 读取文本。流式响应通过 SSE 的 choices[].delta 返回增量。 JSON · SSE
Anthropic Messages · 从 content[] 中读取类型为 text 的块。流式响应按顺序处理 SSE 内容块事件。 JSON · SSE
Count Tokens · 从 input_tokens 读取输入 token 数。
OpenAI Responses · 流式响应中，从 response.output_text.delta 事件的 delta 字段拼接文本，并处理完成与失败事件。 SSE

完整接入指南

能力与限制

streaming · 支持
tool_calling · 支持
image_input · 支持
video_input · 支持

兼容别名与退役重定向

kimi-k3.1-pro → k3.1-pro (别名)
kimi, kimi-k2.5, kimi-k2.6, kimi-k2.7, kimi-k2.8, kimi-2.8, kimi-k2.7-code, kimi-for-coding → k3.1-pro (退役重定向)

模型能力目录 · 查看定价

Kimi Code 配置指南：API Key、K3.1 Pro 与 Claude Code

在 Kimi Code CLI 或 Claude Code 中配置 Kimi K3.1 Pro，区分持久与临时设置、Windows 会话和 Base URL，并排查 401、模型切换及旧名问题。

Chat Completions 对话接口

用 OpenAI Chat 格式发送一组消息。先查看模型和接入点是否支持 Chat 协议，再按下方格式发起请求。

Anthropic Messages 消息接口

用 Anthropic Messages 格式发送消息。此页适用于直接发送 HTTP 请求，Claude Code 的设置步骤在相关指南中。

注册并获取 API Key