{
	"openapi": "3.1.0",
	"info": {
		"title": "Moonshot AI API",
		"version": "1.0.0",
		"description": "Moonshot AI / Kimi 大语言模型服务 API"
	},
	"servers": [
		{
			"url": "https://api.moonshot.cn",
			"description": "生产环境"
		}
	],
	"components": {
		"securitySchemes": {
			"bearerAuth": {
				"type": "http",
				"scheme": "bearer",
				"description": "Authorization 请求头需要一个 Bearer 令牌。使用 MOONSHOT_API_KEY 作为令牌。这是一个服务端密钥，请在 [API 密钥页面](https://platform.kimi.com/console/api-keys) 生成。"
			}
		},
		"schemas": {
			"Message": {
				"type": "object",
				"properties": {
					"role": {
						"type": "string",
						"enum": [
							"system",
							"user",
							"assistant",
							"tool"
						],
						"example": "user",
						"description": "消息发送者的角色，支持 system、user、assistant、tool"
					},
					"content": {
						"oneOf": [
							{
								"type": "string"
							},
							{
								"type": "array",
								"items": {
									"oneOf": [
										{
											"title": "text",
											"type": "object",
											"properties": {
												"type": {
													"type": "string",
													"enum": [
														"text"
													]
												},
												"text": {
													"type": "string"
												}
											},
											"required": [
												"type",
												"text"
											]
										},
										{
											"title": "image_url",
											"type": "object",
											"properties": {
												"type": {
													"type": "string",
													"enum": [
														"image_url"
													]
												},
												"image_url": {
													"oneOf": [
														{
															"type": "object",
															"properties": {
																"url": {
																	"type": "string"
																}
															},
															"required": [
																"url"
															]
														},
														{
															"type": "string"
														}
													]
												}
											},
											"required": [
												"type",
												"image_url"
											]
										},
										{
											"title": "video_url",
											"type": "object",
											"properties": {
												"type": {
													"type": "string",
													"enum": [
														"video_url"
													]
												},
												"video_url": {
													"oneOf": [
														{
															"type": "object",
															"properties": {
																"url": {
																	"type": "string"
																}
															},
															"required": [
																"url"
															]
														},
														{
															"type": "string"
														}
													]
												}
											},
											"required": [
												"type",
												"video_url"
											]
										}
									]
								}
							}
						],
						"example": "你好",
						"description": "消息内容。可以是纯文本字符串，也可以是包含 text/image_url/video_url 类型的对象数组（用于多模态输入）"
					},
					"name": {
						"type": "string",
						"default": null,
						"description": "消息发送者的名称（可选）"
					},
					"partial": {
						"type": "boolean",
						"default": false,
						"description": "在最后一条 assistant 消息中设置为 true 以启用 Partial Mode"
					}
				},
				"required": [
					"role",
					"content"
				]
			},
			"ToolDefinition": {
				"type": "object",
				"properties": {
					"type": {
						"type": "string",
						"enum": [
							"function"
						]
					},
					"function": {
						"type": "object",
						"properties": {
							"name": {
								"type": "string",
								"description": "函数名称。必须符合正则表达式：^[a-zA-Z_][a-zA-Z0-9-_]{2,63}$",
								"pattern": "^[a-zA-Z_][a-zA-Z0-9-_]{2,63}$"
							},
							"description": {
								"type": "string",
								"description": "函数功能描述"
							},
							"parameters": {
								"type": "object",
								"description": "函数参数，JSON Schema 格式。需符合 [MFJS（Moonshot Flavored JSON Schema）规范](https://github.com/MoonshotAI/walle/blob/main/docs/mfjs-spec.zh.md)。",
								"additionalProperties": true
							},
							"strict": {
								"type": "boolean",
								"default": true,
								"description": "是否严格按 parameters schema 约束工具调用参数的输出。默认为 true。设为 false 时仅保证输出为合法 JSON 对象，不强制约束内部结构。"
							}
						},
						"required": [
							"name",
							"parameters"
						]
					}
				},
				"required": [
					"type",
					"function"
				]
			},
			"KimiK3DynamicToolMessage": {
				"type": "object",
				"description": "Kimi K3 动态加载工具消息。该消息只能使用 system 角色，通过 tools 字段在当前对话位置声明后续对话可用的工具，且不包含 content 字段。",
				"properties": {
					"role": {
						"type": "string",
						"enum": [
							"system"
						],
						"description": "动态加载工具消息的角色，固定为 system"
					},
					"tools": {
						"type": "array",
						"description": "从该消息位置开始可供模型调用的工具列表",
						"items": {
							"$ref": "#/components/schemas/ToolDefinition"
						}
					}
				},
				"required": [
					"role",
					"tools"
				],
				"additionalProperties": false
			},
			"KimiK3Message": {
				"oneOf": [
					{
						"title": "标准消息",
						"$ref": "#/components/schemas/Message"
					},
					{
						"title": "动态工具消息",
						"$ref": "#/components/schemas/KimiK3DynamicToolMessage"
					}
				],
				"description": "Kimi K3 对话消息。既支持标准消息，也支持不含 content、通过 tools 声明动态工具的 system 消息。"
			},
			"ChatRequestCommon": {
				"type": "object",
				"properties": {
					"logprobs": {
						"type": "boolean",
						"default": false,
						"description": "是否返回输出 Token 的对数概率。设置为 true 时，在响应 message 的 logprobs 字段中返回每个输出 Token 的对数概率信息"
					},
					"top_logprobs": {
						"type": "integer",
						"minimum": 0,
						"maximum": 20,
						"description": "指定在每个 Token 位置返回概率最高的候选 Token 数量（0-20），各候选 Token 附带对数概率。使用此参数时必须将 logprobs 设置为 true"
					},
					"prediction": {
						"type": "object",
						"description": "Predicted Output 配置。当模型响应的大部分内容可以提前预知时（例如重新生成仅有少量修改的文件），可显著降低响应延迟",
						"properties": {
							"type": {
								"type": "string",
								"enum": [
									"content"
								],
								"description": "预测内容类型，当前仅支持 content"
							},
							"content": {
								"oneOf": [
									{
										"type": "string"
									},
									{
										"type": "array",
										"items": {
											"type": "object"
										}
									}
								],
								"description": "需要模型匹配的静态预测内容，例如正在重新生成的文本文件内容。可以是 string，也可以是 array[object]（数组元素仅支持 type 为 text 的文本内容）"
							}
						}
					},
					"max_tokens": {
						"type": "integer",
						"deprecated": true,
						"description": "已弃用，请使用 max_completion_tokens"
					},
					"max_completion_tokens": {
						"type": "integer",
						"description": "聊天补全生成的最大 Token 数量。默认值因模型而异：Kimi K3 默认为 131072，最大可设置为 1048576。如果结果达到最大 Token 数而未结束，finish reason 将为 \"length\"；否则为 \"stop\"。此值为期望返回的 Token 长度，而非输入加输出的总长度。如果输入加 max_completion_tokens 超出模型上下文窗口，将返回 invalid_request_error。"
					},
					"response_format": {
						"type": "object",
						"description": "控制模型输出格式。默认值为 {\"type\": \"text\"}，即纯文本输出。设置为 {\"type\": \"json_object\"} 可启用 JSON 模式，确保输出为合法 JSON 对象（需在 prompt 中引导模型输出 JSON 并指定格式）。设置为 {\"type\": \"json_schema\"} 可启用 Structured Output，按指定的 JSON Schema 约束输出结构（推荐，需配合 json_schema 字段使用）。如果您在使用 JSON Schema 时遇到校验问题，欢迎到 walle GitHub Issues (https://github.com/MoonshotAI/walle/issues) 提交反馈。",
						"properties": {
							"type": {
								"type": "string",
								"enum": [
									"text",
									"json_object",
									"json_schema"
								],
								"description": "输出格式类型。text：默认，纯文本输出；json_object：保证输出为合法 JSON 对象；json_schema：按指定 JSON Schema 约束输出（推荐，需配合 json_schema 字段使用）"
							},
							"json_schema": {
								"type": "object",
								"description": "当 type 为 json_schema 时使用，定义输出应遵循的 JSON Schema",
								"properties": {
									"name": {
										"type": "string",
										"description": "Schema 名称，用于标识"
									},
									"strict": {
										"type": "boolean",
										"default": true,
										"description": "是否严格按 schema 约束输出。默认为 true。为 true 时 schema 需符合 MFJS 规范，不符合会返回错误或 warning；为 false 时仅保证输出为合法 JSON 对象，不强制约束内部结构。"
									},
									"schema": {
										"type": "object",
										"description": "JSON Schema 对象，定义输出应遵循的结构。需符合 MFJS（Moonshot Flavored JSON Schema）规范。可使用 walle CLI 工具自检：go install github.com/moonshotai/walle/cmd/walle@latest && walle -schema '你的schema' -level strict",
										"additionalProperties": true
									}
								},
								"required": [
									"name",
									"schema"
								]
							}
						}
					},
					"stop": {
						"oneOf": [
							{
								"type": "string"
							},
							{
								"type": "array",
								"items": {
									"type": "string"
								},
								"maxItems": 5
							}
						],
						"default": null,
						"description": "停用词，完全匹配时将停止输出。匹配到的词本身不会被输出。最多允许 5 个字符串，每个不超过 32 字节"
					},
					"stream": {
						"type": "boolean",
						"default": false,
						"description": "是否以流式方式返回响应，默认 false"
					},
					"stream_options": {
						"type": "object",
						"description": "流式响应选项",
						"properties": {
							"include_usage": {
								"type": "boolean",
								"default": false,
								"description": "如果设置，将在 data: [DONE] 消息之前额外发送一个 chunk。该 chunk 的 usage 字段显示整个请求的 Token 使用统计，choices 字段为空数组。其他所有 chunk 也会包含 usage 字段，但值为 null。注意：如果流中断，可能无法收到包含总 Token 用量的最终 chunk"
							}
						}
					},
					"tools": {
						"type": "array",
						"description": "模型可调用的工具列表",
						"items": {
							"$ref": "#/components/schemas/ToolDefinition"
						}
					},
					"prompt_cache_key": {
						"type": "string",
						"default": null,
						"description": "用于缓存相似请求的响应以优化缓存命中率。对于 Coding Agent，通常是代表单个会话的 session id 或 task id；退出并恢复会话时应保持不变。对于 Kimi Code Plan，此字段为必填以提高缓存命中率。对于其他多轮对话 Agent，也建议使用此字段"
					},
					"safety_identifier": {
						"type": "string",
						"description": "用于检测可能违反使用政策的用户的稳定标识符。应为唯一标识每个用户的字符串。建议对用户名或邮箱进行哈希处理以避免发送可识别信息"
					},
					"tool_choice": {
						"oneOf": [
							{
								"type": "string",
								"enum": [
									"auto",
									"none",
									"required"
								],
								"description": "auto：模型自行决定是否调用工具；none：不调用工具；required：强制调用工具"
							},
							{
								"type": "object",
								"description": "强制调用指定工具",
								"properties": {
									"type": {
										"type": "string",
										"enum": [
											"function"
										]
									},
									"function": {
										"type": "object",
										"properties": {
											"name": {
												"type": "string",
												"description": "要调用的函数名称"
											}
										},
										"required": [
											"name"
										]
									}
								},
								"required": [
									"type",
									"function"
								]
							}
						],
						"description": "控制模型是否调用工具。`auto`（默认）：模型自行决定是否调用工具；`none`：不调用工具；`required`：强制调用工具；也可传入特定函数对象强制调用指定工具。"
					}
				}
			},
			"ChatRequestBase": {
				"type": "object",
				"properties": {
					"logprobs": {
						"type": "boolean",
						"default": false,
						"description": "是否返回输出 Token 的对数概率。设置为 true 时，在响应 message 的 logprobs 字段中返回每个输出 Token 的对数概率信息"
					},
					"top_logprobs": {
						"type": "integer",
						"minimum": 0,
						"maximum": 20,
						"description": "指定在每个 Token 位置返回概率最高的候选 Token 数量（0-20），各候选 Token 附带对数概率。使用此参数时必须将 logprobs 设置为 true"
					},
					"prediction": {
						"type": "object",
						"description": "Predicted Output 配置。当模型响应的大部分内容可以提前预知时（例如重新生成仅有少量修改的文件），可显著降低响应延迟",
						"properties": {
							"type": {
								"type": "string",
								"enum": [
									"content"
								],
								"description": "预测内容类型，当前仅支持 content"
							},
							"content": {
								"oneOf": [
									{
										"type": "string"
									},
									{
										"type": "array",
										"items": {
											"type": "object"
										}
									}
								],
								"description": "需要模型匹配的静态预测内容，例如正在重新生成的文本文件内容。可以是 string，也可以是 array[object]（数组元素仅支持 type 为 text 的文本内容）"
							}
						}
					},
					"messages": {
						"type": "array",
						"description": "包含迄今为止对话的消息列表。每个元素格式为 {\"role\": \"user\", \"content\": \"你好\"}。role 支持 system、user、assistant、tool 其一，content 不得为空。content 字段可以是 string，也可以是 array[object]（用于多模态输入）",
						"items": {
							"$ref": "#/components/schemas/Message"
						}
					},
					"max_tokens": {
						"type": "integer",
						"deprecated": true,
						"description": "已弃用，请使用 max_completion_tokens"
					},
					"max_completion_tokens": {
						"type": "integer",
						"description": "聊天补全生成的最大 Token 数量。默认值因模型而异：Kimi K3 默认为 131072，最大可设置为 1048576。如果结果达到最大 Token 数而未结束，finish reason 将为 \"length\"；否则为 \"stop\"。此值为期望返回的 Token 长度，而非输入加输出的总长度。如果输入加 max_completion_tokens 超出模型上下文窗口，将返回 invalid_request_error。"
					},
					"response_format": {
						"type": "object",
						"description": "控制模型输出格式。默认值为 {\"type\": \"text\"}，即纯文本输出。设置为 {\"type\": \"json_object\"} 可启用 JSON 模式，确保输出为合法 JSON 对象（需在 prompt 中引导模型输出 JSON 并指定格式）。设置为 {\"type\": \"json_schema\"} 可启用 Structured Output，按指定的 JSON Schema 约束输出结构（推荐，需配合 json_schema 字段使用）。如果您在使用 JSON Schema 时遇到校验问题，欢迎到 walle GitHub Issues (https://github.com/MoonshotAI/walle/issues) 提交反馈。",
						"properties": {
							"type": {
								"type": "string",
								"enum": [
									"text",
									"json_object",
									"json_schema"
								],
								"description": "输出格式类型。text：默认，纯文本输出；json_object：保证输出为合法 JSON 对象；json_schema：按指定 JSON Schema 约束输出（推荐，需配合 json_schema 字段使用）"
							},
							"json_schema": {
								"type": "object",
								"description": "当 type 为 json_schema 时使用，定义输出应遵循的 JSON Schema",
								"properties": {
									"name": {
										"type": "string",
										"description": "Schema 名称，用于标识"
									},
									"strict": {
										"type": "boolean",
										"default": true,
										"description": "是否严格按 schema 约束输出。默认为 true。为 true 时 schema 需符合 MFJS 规范，不符合会返回错误或 warning；为 false 时仅保证输出为合法 JSON 对象，不强制约束内部结构。"
									},
									"schema": {
										"type": "object",
										"description": "JSON Schema 对象，定义输出应遵循的结构。需符合 MFJS（Moonshot Flavored JSON Schema）规范。可使用 walle CLI 工具自检：go install github.com/moonshotai/walle/cmd/walle@latest && walle -schema '你的schema' -level strict",
										"additionalProperties": true
									}
								},
								"required": [
									"name",
									"schema"
								]
							}
						}
					},
					"stop": {
						"oneOf": [
							{
								"type": "string"
							},
							{
								"type": "array",
								"items": {
									"type": "string"
								},
								"maxItems": 5
							}
						],
						"default": null,
						"description": "停用词，完全匹配时将停止输出。匹配到的词本身不会被输出。最多允许 5 个字符串，每个不超过 32 字节"
					},
					"stream": {
						"type": "boolean",
						"default": false,
						"description": "是否以流式方式返回响应，默认 false"
					},
					"stream_options": {
						"type": "object",
						"description": "流式响应选项",
						"properties": {
							"include_usage": {
								"type": "boolean",
								"default": false,
								"description": "如果设置，将在 data: [DONE] 消息之前额外发送一个 chunk。该 chunk 的 usage 字段显示整个请求的 Token 使用统计，choices 字段为空数组。其他所有 chunk 也会包含 usage 字段，但值为 null。注意：如果流中断，可能无法收到包含总 Token 用量的最终 chunk"
							}
						}
					},
					"tools": {
						"type": "array",
						"description": "模型可调用的工具列表",
						"items": {
							"$ref": "#/components/schemas/ToolDefinition"
						}
					},
					"prompt_cache_key": {
						"type": "string",
						"default": null,
						"description": "用于缓存相似请求的响应以优化缓存命中率。对于 Coding Agent，通常是代表单个会话的 session id 或 task id；退出并恢复会话时应保持不变。对于 Kimi Code Plan，此字段为必填以提高缓存命中率。对于其他多轮对话 Agent，也建议使用此字段"
					},
					"safety_identifier": {
						"type": "string",
						"description": "用于检测可能违反使用政策的用户的稳定标识符。应为唯一标识每个用户的字符串。建议对用户名或邮箱进行哈希处理以避免发送可识别信息"
					},
					"tool_choice": {
						"oneOf": [
							{
								"type": "string",
								"enum": [
									"auto",
									"none",
									"required"
								],
								"description": "auto：模型自行决定是否调用工具；none：不调用工具；required：强制调用工具"
							},
							{
								"type": "object",
								"description": "强制调用指定工具",
								"properties": {
									"type": {
										"type": "string",
										"enum": [
											"function"
										]
									},
									"function": {
										"type": "object",
										"properties": {
											"name": {
												"type": "string",
												"description": "要调用的函数名称"
											}
										},
										"required": [
											"name"
										]
									}
								},
								"required": [
									"type",
									"function"
								]
							}
						],
						"description": "控制模型是否调用工具。`auto`（默认）：模型自行决定是否调用工具；`none`：不调用工具；`required`：强制调用工具；也可传入特定函数对象强制调用指定工具。"
					}
				},
				"required": [
					"messages"
				]
			},
			"KimiK3ChatRequest": {
				"title": "kimi-k3",
				"allOf": [
					{
						"$ref": "#/components/schemas/ChatRequestCommon"
					},
					{
						"type": "object",
						"properties": {
							"model": {
								"type": "string",
								"description": "模型 ID",
								"enum": [
									"kimi-k3"
								],
								"default": "kimi-k3"
							},
							"messages": {
								"type": "array",
								"description": "Kimi K3 对话消息列表。除标准消息外，还可在任意对话位置插入 {\"role\": \"system\", \"tools\": [...]} 消息动态加载工具；该动态工具消息不包含 content 字段，并且只影响后续对话。",
								"items": {
									"$ref": "#/components/schemas/KimiK3Message"
								}
							},
							"reasoning_effort": {
								"type": "string",
								"enum": [
									"low",
									"high",
									"max"
								],
								"default": "max",
								"description": "Kimi K3 始终启用思考，并开启 Preserved Thinking。推理强度支持 low、high 和 max，默认为 max。"
							}
						},
						"required": [
							"model",
							"messages"
						]
					}
				]
			},
			"MoonshotV1ChatRequest": {
				"title": "moonshot-v1",
				"allOf": [
					{
						"$ref": "#/components/schemas/ChatRequestBase"
					},
					{
						"type": "object",
						"properties": {
							"model": {
								"type": "string",
								"description": "模型 ID",
								"enum": [
									"moonshot-v1-8k",
									"moonshot-v1-32k",
									"moonshot-v1-128k",
									"moonshot-v1-auto",
									"moonshot-v1-8k-vision-preview",
									"moonshot-v1-32k-vision-preview",
									"moonshot-v1-128k-vision-preview"
								],
								"default": "moonshot-v1-128k"
							},
							"temperature": {
								"type": "number",
								"format": "float",
								"description": "采样温度，范围 0 到 1。较高的值（如 0.7）使输出更随机，较低的值（如 0.2）使输出更集中和确定。默认值为 0.0。",
								"default": 0.0,
								"minimum": 0,
								"maximum": 1
							},
							"top_p": {
								"type": "number",
								"format": "float",
								"description": "另一种采样方法，模型考虑累积概率质量为 top_p 的 Token 结果。例如 0.1 表示仅考虑概率质量前 10% 的 Token。通常建议只修改此参数或 temperature 其中之一。默认值为 1.0。",
								"default": 1.0,
								"minimum": 0,
								"maximum": 1
							},
							"n": {
								"type": "integer",
								"description": "每条输入消息生成的结果数量。默认为 1，不超过 5。当温度非常接近 0 时，只能返回 1 个结果。",
								"default": 1,
								"minimum": 1,
								"maximum": 5
							},
							"presence_penalty": {
								"type": "number",
								"format": "float",
								"description": "存在惩罚，范围 -2.0 到 2.0。正值会根据 Token 是否出现在文本中进行惩罚，增加模型讨论新话题的可能性",
								"default": 0,
								"minimum": -2,
								"maximum": 2
							},
							"frequency_penalty": {
								"type": "number",
								"format": "float",
								"description": "频率惩罚，范围 -2.0 到 2.0。正值会根据 Token 在文本中的现有频率进行惩罚，降低模型逐字重复相同短语的可能性",
								"default": 0,
								"minimum": -2,
								"maximum": 2
							}
						},
						"required": [
							"model"
						]
					}
				]
			},
			"KimiK25ChatRequest": {
				"title": "kimi-k2.5",
				"allOf": [
					{
						"$ref": "#/components/schemas/ChatRequestBase"
					},
					{
						"type": "object",
						"properties": {
							"model": {
								"type": "string",
								"description": "模型 ID",
								"enum": [
									"kimi-k2.5"
								],
								"default": "kimi-k2.5"
							},
							"thinking": {
								"type": "object",
								"description": "控制模型是否启用思考能力。可选参数，默认值为 {\"type\": \"enabled\"}。",
								"properties": {
									"type": {
										"type": "string",
										"enum": [
											"enabled",
											"disabled"
										],
										"description": "启用或禁用思考能力"
									}
								},
								"required": [
									"type"
								],
								"additionalProperties": false
							}
						},
						"required": [
							"model"
						]
					}
				]
			},
			"KimiK26ChatRequest": {
				"title": "kimi-k2.6",
				"allOf": [
					{
						"$ref": "#/components/schemas/ChatRequestBase"
					},
					{
						"type": "object",
						"properties": {
							"model": {
								"type": "string",
								"description": "模型 ID",
								"enum": [
									"kimi-k2.6"
								],
								"default": "kimi-k2.6"
							},
							"thinking": {
								"type": "object",
								"description": "控制 kimi-k2.6 模型是否启用思考能力，以及是否完整保留多轮对话中的 reasoning_content。可选参数，默认值为 {\"type\": \"enabled\"}。",
								"properties": {
									"type": {
										"type": "string",
										"enum": [
											"enabled",
											"disabled"
										],
										"description": "启用或禁用思考能力"
									},
									"keep": {
										"type": [
											"string",
											"null"
										],
										"enum": [
											"all",
											null
										],
										"description": "控制是否保留历史对话轮次（previous turns）的 reasoning_content，从而启用 Preserved Thinking。默认为 `null`，即不保留历史轮次的思考内容。\n\n- `null`（默认）或不传：服务端会忽略历史 turns 的 reasoning_content。\n- `\"all\"`：保留历史 turns 的 reasoning_content 并随上下文一同提供给模型，启用 Preserved Thinking。使用时需把每一轮历史 assistant 消息中的 reasoning_content 原样保留在 messages 中。推荐与 `type: \"enabled\"` 搭配使用。\n- 注意：该参数只影响历史轮次的 reasoning_content；不改变模型在当前 turn 内是否产生/输出思考内容（由 `type` 控制）。关于使用方式的最佳实践，详见 [Preserved Thinking](/guide/use-thinking-models#preserved-thinking)。"
									}
								},
								"required": [
									"type"
								],
								"additionalProperties": false
							}
						},
						"required": [
							"model"
						]
					}
				]
			},
			"KimiK27CodeChatRequest": {
				"title": "kimi-k2.7-code",
				"allOf": [
					{
						"$ref": "#/components/schemas/ChatRequestBase"
					},
					{
						"type": "object",
						"properties": {
							"model": {
								"type": "string",
								"description": "模型 ID。可选 `kimi-k2.7-code` 或其高速版 `kimi-k2.7-code-highspeed`；两者为同一模型、参数完全一致，高速版输出速度约 180 Tokens/s（短上下文场景可达 260 Tokens/s）。",
								"enum": [
									"kimi-k2.7-code",
									"kimi-k2.7-code-highspeed"
								],
								"default": "kimi-k2.7-code"
							},
							"thinking": {
								"type": "object",
								"description": "控制 kimi-k2.7-code 模型是否启用思考能力，以及是否完整保留多轮对话中的 reasoning_content。可选参数，默认值为 {\"type\": \"enabled\", \"keep\": \"all\"}。\n\n与 kimi-k2.6 的差异：\n- `type` 仅支持 `\"enabled\"`。与 kimi-k2.6 不同，不支持 `\"disabled\"` — 传入会报错。该模型始终开启思考。\n- `keep` 仅接受合法值 `\"all\"`；不传或传 `\"all\"` 时服务端均按 `\"all\"` 处理，传入其他非法值会报错。因此该模型始终启用 Preserved Thinking。",
								"properties": {
									"type": {
										"type": "string",
										"enum": [
											"enabled"
										],
										"description": "启用思考能力。对 kimi-k2.7-code 仅接受 `\"enabled\"`；传入 `\"disabled\"` 会报错。这与同时支持 `\"disabled\"` 的 kimi-k2.6 不同。"
									},
									"keep": {
										"type": [
											"string",
											"null"
										],
										"enum": [
											"all",
											null
										],
										"description": "控制是否保留历史对话轮次（previous turns）的 reasoning_content，从而启用 Preserved Thinking。\n\n- 对 kimi-k2.7-code，该参数仅接受合法值 `\"all\"`：传 `\"all\"`、传 `null` 或不传表现完全一致，服务端均按 `\"all\"` 处理 — 始终保留历史轮次的 reasoning_content；传入其他非法值会报错。这与 kimi-k2.6 不同，k2.6 默认为 `null`（除非显式设为 `\"all\"`，否则不保留历史思考）。\n- 由于 Preserved Thinking 始终开启，请把每一轮历史 assistant 消息中的 reasoning_content 原样保留在 messages 中。\n- 注意：该参数只影响历史轮次的 reasoning_content；不改变模型在当前 turn 内是否产生/输出思考内容（由 `type` 控制）。关于使用方式的最佳实践，详见 [Preserved Thinking](/guide/use-thinking-models#preserved-thinking)。"
									}
								},
								"required": [
									"type"
								],
								"additionalProperties": false
							}
						},
						"required": [
							"model"
						]
					}
				]
			},
			"ChatCompletionResponse": {
				"type": "object",
				"properties": {
					"id": {
						"type": "string",
						"description": "补全结果的唯一标识符"
					},
					"object": {
						"type": "string",
						"description": "对象类型",
						"example": "chat.completion"
					},
					"created": {
						"type": "integer",
						"description": "补全创建时的 Unix 时间戳"
					},
					"model": {
						"type": "string",
						"description": "用于补全的模型"
					},
					"choices": {
						"type": "array",
						"description": "补全选项列表",
						"items": {
							"type": "object",
							"properties": {
								"index": {
									"type": "integer"
								},
								"message": {
									"type": "object",
									"properties": {
										"role": {
											"type": "string",
											"enum": [
												"assistant"
											]
										},
										"content": {
											"type": [
												"string",
												"null"
											],
											"description": "助手的消息内容"
										},
										"tool_calls": {
											"type": "array",
											"description": "模型发起的工具调用",
											"items": {
												"type": "object",
												"properties": {
													"id": {
														"type": "string"
													},
													"type": {
														"type": "string",
														"enum": [
															"function"
														]
													},
													"function": {
														"type": "object",
														"properties": {
															"name": {
																"type": "string"
															},
															"arguments": {
																"type": "string",
																"description": "函数参数的 JSON 字符串"
															}
														}
													}
												}
											}
										},
										"reasoning_content": {
											"type": [
												"string",
												"null"
											],
											"description": "推理过程（仅在思考模式启用时返回）"
										}
									}
								},
								"finish_reason": {
									"type": "string",
									"enum": [
										"stop",
										"length",
										"tool_calls"
									]
								}
							}
						}
					},
					"usage": {
						"type": "object",
						"properties": {
							"prompt_tokens": {
								"type": "integer",
								"description": "提示中的 Token 数量"
							},
							"completion_tokens": {
								"type": "integer",
								"description": "补全中的 Token 数量"
							},
							"total_tokens": {
								"type": "integer",
								"description": "使用的总 Token 数量"
							},
							"cached_tokens": {
								"type": "integer",
								"description": "命中缓存的 Token 数量"
							}
						}
					}
				}
			},
			"ChatCompletionChunk": {
				"type": "object",
				"properties": {
					"id": {
						"type": "string",
						"description": "补全结果的唯一标识符"
					},
					"object": {
						"type": "string",
						"description": "对象类型",
						"example": "chat.completion.chunk"
					},
					"created": {
						"type": "integer",
						"description": "补全创建时的 Unix 时间戳"
					},
					"model": {
						"type": "string",
						"description": "用于补全的模型"
					},
					"choices": {
						"type": "array",
						"description": "补全选项列表",
						"items": {
							"$ref": "#/components/schemas/ChoiceDelta"
						}
					},
					"usage": {
						"type": [
							"object",
							"null"
						],
						"description": "Token 使用统计。包含 usage 的最终 chunk 中为对象，其他 chunk 中为 null",
						"properties": {
							"prompt_tokens": {
								"type": "integer",
								"description": "提示中的 Token 数量"
							},
							"completion_tokens": {
								"type": "integer",
								"description": "补全中的 Token 数量"
							},
							"total_tokens": {
								"type": "integer",
								"description": "使用的总 Token 数量"
							},
							"cached_tokens": {
								"type": "integer",
								"description": "命中缓存的 Token 数量"
							}
						}
					}
				}
			},
			"ChoiceDelta": {
				"type": "object",
				"properties": {
					"index": {
						"type": "integer",
						"description": "选项索引"
					},
					"delta": {
						"type": "object",
						"description": "增量内容对象",
						"properties": {
							"role": {
								"type": "string",
								"description": "消息角色（仅在首个 chunk 中出现）"
							},
							"content": {
								"type": "string",
								"description": "消息内容片段"
							},
							"tool_calls": {
								"type": "array",
								"description": "模型发起的工具调用片段",
								"items": {
									"type": "object",
									"properties": {
										"id": {
											"type": "string"
										},
										"type": {
											"type": "string",
											"enum": [
												"function"
											]
										},
										"function": {
											"type": "object",
											"properties": {
												"name": {
													"type": "string"
												},
												"arguments": {
													"type": "string",
													"description": "函数参数的 JSON 字符串"
												}
											}
										}
									}
								}
							}
						}
					},
					"finish_reason": {
						"type": [
							"string",
							"null"
						],
						"enum": [
							"stop",
							"length",
							"tool_calls",
							null
						],
						"description": "停止原因，仅在最后一个 chunk 中出现"
					},
					"usage": {
						"type": "object",
						"description": "Token 使用统计（可选）",
						"properties": {
							"prompt_tokens": {
								"type": "integer",
								"description": "提示中的 Token 数量"
							},
							"completion_tokens": {
								"type": "integer",
								"description": "补全中的 Token 数量"
							},
							"total_tokens": {
								"type": "integer",
								"description": "使用的总 Token 数量"
							}
						}
					}
				}
			},
			"BalanceResponse": {
				"type": "object",
				"properties": {
					"code": {
						"type": "integer",
						"description": "响应码。0 表示成功。"
					},
					"data": {
						"type": "object",
						"properties": {
							"available_balance": {
								"type": "number",
								"format": "float",
								"description": "可用余额（单位：人民币元），包含现金余额和代金券余额。当小于等于 0 时，用户无法调用推理 API",
								"example": 49.58894
							},
							"voucher_balance": {
								"type": "number",
								"format": "float",
								"description": "代金券余额（单位：人民币元），不可为负",
								"example": 46.58893
							},
							"cash_balance": {
								"type": "number",
								"format": "float",
								"description": "现金余额（单位：人民币元），可为负值表示欠费。当为负值时，available_balance 等于 voucher_balance 的值",
								"example": 3.00001
							}
						},
						"required": [
							"available_balance",
							"voucher_balance",
							"cash_balance"
						]
					},
					"scode": {
						"type": "string",
						"description": "状态码",
						"example": "0x0"
					},
					"status": {
						"type": "boolean",
						"description": "请求状态",
						"example": true
					}
				},
				"required": [
					"code",
					"data",
					"scode",
					"status"
				]
			},
			"EstimateTokenRequest": {
				"type": "object",
				"properties": {
					"model": {
						"type": "string",
						"description": "模型 ID",
						"default": "kimi-k3",
						"enum": [
							"kimi-k3",
							"kimi-k2.7-code",
							"kimi-k2.7-code-highspeed",
							"kimi-k2.6",
							"kimi-k2.5",
							"moonshot-v1-8k",
							"moonshot-v1-32k",
							"moonshot-v1-128k",
							"moonshot-v1-auto",
							"moonshot-v1-8k-vision-preview",
							"moonshot-v1-32k-vision-preview",
							"moonshot-v1-128k-vision-preview"
						]
					},
					"messages": {
						"type": "array",
						"description": "包含迄今为止对话的消息列表。每个元素格式为 {\"role\": \"user\", \"content\": \"你好\"}。role 支持 system、user、assistant、tool 其一，content 不得为空",
						"items": {
							"$ref": "#/components/schemas/Message"
						}
					}
				},
				"required": [
					"model",
					"messages"
				]
			},
			"EstimateTokenResponse": {
				"type": "object",
				"properties": {
					"data": {
						"type": "object",
						"properties": {
							"total_tokens": {
								"type": "integer",
								"description": "估算的总 Token 数量",
								"example": 80
							}
						},
						"required": [
							"total_tokens"
						]
					}
				},
				"required": [
					"data"
				]
			},
			"FileObject": {
				"type": "object",
				"properties": {
					"id": {
						"type": "string",
						"description": "文件唯一标识符"
					},
					"object": {
						"type": "string",
						"description": "对象类型",
						"example": "file"
					},
					"bytes": {
						"type": "integer",
						"description": "文件大小（字节）"
					},
					"created_at": {
						"type": "integer",
						"description": "文件创建时的 Unix 时间戳"
					},
					"filename": {
						"type": "string",
						"description": "原始文件名"
					},
					"purpose": {
						"type": "string",
						"description": "上传文件时指定的用途。file-extract：抽取文件内容；image：上传图片，用于视觉理解；video：上传视频，用于视频理解；batch：上传 JSONL 文件，用于批处理任务",
						"enum": [
							"file-extract",
							"image",
							"video",
							"batch"
						]
					},
					"status": {
						"type": "string",
						"description": "文件处理状态",
						"example": "ready"
					},
					"status_details": {
						"type": "string",
						"description": "处理失败或返回警告时的额外状态详情"
					}
				},
				"required": [
					"id",
					"object",
					"bytes",
					"created_at",
					"filename",
					"purpose",
					"status"
				]
			},
			"FileListResponse": {
				"type": "object",
				"properties": {
					"object": {
						"type": "string",
						"example": "list"
					},
					"data": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/FileObject"
						}
					}
				},
				"required": [
					"object",
					"data"
				]
			},
			"FileDeleteResponse": {
				"type": "object",
				"properties": {
					"id": {
						"type": "string",
						"description": "已删除文件的标识符"
					},
					"object": {
						"type": "string",
						"example": "file"
					},
					"deleted": {
						"type": "boolean",
						"description": "文件是否删除成功"
					}
				},
				"required": [
					"id",
					"object",
					"deleted"
				]
			},
			"BatchCreateRequest": {
				"type": "object",
				"properties": {
					"input_file_id": {
						"type": "string",
						"description": "输入文件的 ID，必须是通过 purpose=\"batch\" 上传的 .jsonl 文件"
					},
					"endpoint": {
						"type": "string",
						"description": "请求端点，目前仅支持 /v1/chat/completions",
						"enum": [
							"/v1/chat/completions"
						]
					},
					"completion_window": {
						"type": "string",
						"description": "任务处理的时间窗口，支持语义化格式如 12h、1d、3d，最小 12h，最大 7d"
					},
					"metadata": {
						"type": "object",
						"description": "自定义元数据，最多 16 个键值对，key 最长 64 字符，value 最长 512 字符",
						"additionalProperties": {
							"type": "string",
							"maxLength": 512
						}
					}
				},
				"required": [
					"input_file_id",
					"endpoint",
					"completion_window"
				]
			},
			"BatchRequestCounts": {
				"type": "object",
				"properties": {
					"completed": {
						"type": "integer",
						"description": "已完成的请求数量"
					},
					"failed": {
						"type": "integer",
						"description": "失败的请求数量"
					},
					"total": {
						"type": "integer",
						"description": "总请求数量"
					}
				},
				"required": [
					"completed",
					"failed",
					"total"
				]
			},
			"BatchObject": {
				"type": "object",
				"properties": {
					"id": {
						"type": "string",
						"description": "批处理任务的唯一标识符"
					},
					"object": {
						"type": "string",
						"description": "对象类型，固定为 batch",
						"example": "batch"
					},
					"endpoint": {
						"type": "string",
						"description": "请求端点"
					},
					"input_file_id": {
						"type": "string",
						"description": "输入文件 ID"
					},
					"completion_window": {
						"type": "string",
						"description": "任务处理时间窗口"
					},
					"status": {
						"type": "string",
						"description": "当前状态：validating（校验中）、failed（校验失败）、in_progress（执行中）、finalizing（准备结果中）、completed（已完成）、expired（已过期）、cancelling（取消中）、cancelled（已取消）",
						"enum": [
							"validating",
							"failed",
							"in_progress",
							"finalizing",
							"completed",
							"expired",
							"cancelling",
							"cancelled"
						]
					},
					"output_file_id": {
						"type": [
							"string",
							"null"
						],
						"description": "处理成功的结果文件 ID"
					},
					"error_file_id": {
						"type": [
							"string",
							"null"
						],
						"description": "处理失败的错误文件 ID"
					},
					"created_at": {
						"type": "integer",
						"description": "创建时间（Unix 时间戳）"
					},
					"in_progress_at": {
						"type": [
							"integer",
							"null"
						],
						"description": "开始执行时间（Unix 时间戳）"
					},
					"expires_at": {
						"type": [
							"integer",
							"null"
						],
						"description": "过期时间（Unix 时间戳）"
					},
					"finalizing_at": {
						"type": [
							"integer",
							"null"
						],
						"description": "开始准备结果的时间（Unix 时间戳）"
					},
					"completed_at": {
						"type": [
							"integer",
							"null"
						],
						"description": "完成时间（Unix 时间戳）"
					},
					"failed_at": {
						"type": [
							"integer",
							"null"
						],
						"description": "校验失败时间（Unix 时间戳）"
					},
					"cancelling_at": {
						"type": [
							"integer",
							"null"
						],
						"description": "发起取消时间（Unix 时间戳）"
					},
					"cancelled_at": {
						"type": [
							"integer",
							"null"
						],
						"description": "取消完成时间（Unix 时间戳）"
					},
					"request_counts": {
						"$ref": "#/components/schemas/BatchRequestCounts"
					},
					"metadata": {
						"type": [
							"object",
							"null"
						],
						"description": "自定义元数据",
						"additionalProperties": {
							"type": "string"
						}
					}
				},
				"required": [
					"id",
					"object",
					"endpoint",
					"input_file_id",
					"completion_window",
					"status",
					"created_at",
					"request_counts"
				]
			},
			"BatchListResponse": {
				"type": "object",
				"properties": {
					"object": {
						"type": "string",
						"example": "list"
					},
					"data": {
						"type": "array",
						"items": {
							"$ref": "#/components/schemas/BatchObject"
						}
					},
					"has_more": {
						"type": "boolean",
						"description": "是否还有更多数据"
					}
				},
				"required": [
					"object",
					"data"
				]
			},
			"ErrorResponse": {
				"type": "object",
				"properties": {
					"error": {
						"type": "object",
						"properties": {
							"message": {
								"type": "string",
								"description": "描述错误原因的错误消息"
							},
							"type": {
								"type": "string",
								"description": "错误类型"
							},
							"code": {
								"type": "string",
								"description": "错误码"
							}
						},
						"required": [
							"message"
						]
					}
				},
				"required": [
					"error"
				]
			}
		}
	},
	"paths": {
		"/v1/models": {
			"get": {
				"summary": "列出模型",
				"description": "列出当前可用的所有模型。",
				"tags": [
					"Models"
				],
				"security": [
					{
						"bearerAuth": []
					}
				],
				"responses": {
					"200": {
						"description": "模型列表",
						"content": {
							"application/json": {
								"schema": {
									"type": "object",
									"properties": {
										"object": {
											"type": "string",
											"example": "list"
										},
										"data": {
											"type": "array",
											"items": {
												"type": "object",
												"properties": {
													"id": {
														"type": "string",
														"description": "模型 ID",
														"example": "kimi-k2.5"
													},
													"object": {
														"type": "string",
														"example": "model"
													},
													"created": {
														"type": "integer",
														"description": "创建时间戳"
													},
													"owned_by": {
														"type": "string",
														"example": "moonshot"
													},
													"context_length": {
														"type": "integer",
														"description": "最大上下文长度（tokens）"
													},
													"supports_image_in": {
														"type": "boolean",
														"description": "是否支持图片输入"
													},
													"supports_video_in": {
														"type": "boolean",
														"description": "是否支持视频输入"
													},
													"supports_reasoning": {
														"type": "boolean",
														"description": "是否支持深度思考"
													}
												}
											}
										}
									}
								}
							}
						}
					},
					"401": {
						"description": "未授权 - API 密钥无效或缺失",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					}
				}
			}
		},
		"/v1/users/me/balance": {
			"get": {
				"summary": "查询余额",
				"description": "查询您在 Kimi 开放平台上的可用余额、代金券余额和现金余额。",
				"tags": [
					"Billing"
				],
				"security": [
					{
						"bearerAuth": []
					}
				],
				"responses": {
					"200": {
						"description": "余额信息",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/BalanceResponse"
								}
							}
						}
					},
					"401": {
						"description": "未授权 - API 密钥无效或缺失",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"500": {
						"description": "服务器错误",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					}
				}
			}
		},
		"/v1/files": {
			"post": {
				"summary": "上传文件",
				"description": "上传文件用于内容提取、图片理解或视频理解。",
				"tags": [
					"Files"
				],
				"security": [
					{
						"bearerAuth": []
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"multipart/form-data": {
							"schema": {
								"type": "object",
								"properties": {
									"file": {
										"type": "string",
										"format": "binary",
										"description": "要上传的文件"
									},
									"purpose": {
										"type": "string",
										"enum": [
											"file-extract",
											"image",
											"video",
											"batch"
										],
										"description": "指定上传文件的处理方式。file-extract：抽取文件内容；image：上传图片，用于视觉理解；video：上传视频，用于视频理解；batch：上传 JSONL 文件，用于批处理任务"
									}
								},
								"required": [
									"file",
									"purpose"
								]
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "已上传文件的元数据",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/FileObject"
								}
							}
						}
					},
					"400": {
						"description": "请求错误 - 上传参数无效",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"401": {
						"description": "未授权 - API 密钥无效或缺失",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"500": {
						"description": "服务器错误",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					}
				}
			},
			"get": {
				"summary": "文件列表",
				"description": "列出当前用户上传的所有文件。",
				"tags": [
					"Files"
				],
				"security": [
					{
						"bearerAuth": []
					}
				],
				"responses": {
					"200": {
						"description": "已上传文件列表",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/FileListResponse"
								}
							}
						}
					},
					"401": {
						"description": "未授权 - API 密钥无效或缺失",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"500": {
						"description": "服务器错误",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					}
				}
			}
		},
		"/v1/files/{file_id}": {
			"get": {
				"summary": "获取文件信息",
				"description": "获取指定已上传文件的元数据。",
				"tags": [
					"Files"
				],
				"security": [
					{
						"bearerAuth": []
					}
				],
				"parameters": [
					{
						"name": "file_id",
						"in": "path",
						"required": true,
						"description": "文件标识符",
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "文件元数据",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/FileObject"
								}
							}
						}
					},
					"401": {
						"description": "未授权 - API 密钥无效或缺失",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"404": {
						"description": "文件未找到",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"500": {
						"description": "服务器错误",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					}
				}
			},
			"delete": {
				"summary": "删除文件",
				"description": "删除一个已上传的文件。",
				"tags": [
					"Files"
				],
				"security": [
					{
						"bearerAuth": []
					}
				],
				"parameters": [
					{
						"name": "file_id",
						"in": "path",
						"required": true,
						"description": "文件标识符",
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "删除结果",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/FileDeleteResponse"
								}
							}
						}
					},
					"401": {
						"description": "未授权 - API 密钥无效或缺失",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"404": {
						"description": "文件未找到",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"500": {
						"description": "服务器错误",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					}
				}
			}
		},
		"/v1/files/{file_id}/content": {
			"get": {
				"summary": "获取文件内容",
				"description": "获取以 `file-extract` 用途上传的文件的提取文本内容。",
				"tags": [
					"Files"
				],
				"security": [
					{
						"bearerAuth": []
					}
				],
				"parameters": [
					{
						"name": "file_id",
						"in": "path",
						"required": true,
						"description": "文件标识符",
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "提取的文件内容",
						"content": {
							"text/plain": {
								"schema": {
									"type": "string",
									"description": "提取的文件内容（纯文本）"
								}
							}
						}
					},
					"401": {
						"description": "未授权 - API 密钥无效或缺失",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"404": {
						"description": "文件未找到",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"500": {
						"description": "服务器错误",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					}
				}
			}
		},
		"/v1/chat/completions": {
			"post": {
				"summary": "创建聊天补全",
				"description": "为聊天消息创建补全结果。支持标准聊天、Partial Mode 和 Tool Use（函数调用）。",
				"tags": [
					"Chat"
				],
				"security": [
					{
						"bearerAuth": []
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"oneOf": [
									{
										"$ref": "#/components/schemas/KimiK3ChatRequest"
									},
									{
										"$ref": "#/components/schemas/KimiK27CodeChatRequest"
									},
									{
										"$ref": "#/components/schemas/KimiK26ChatRequest"
									},
									{
										"$ref": "#/components/schemas/KimiK25ChatRequest"
									},
									{
										"$ref": "#/components/schemas/MoonshotV1ChatRequest"
									}
								],
								"discriminator": {
									"propertyName": "model",
									"mapping": {
										"kimi-k3": "#/components/schemas/KimiK3ChatRequest",
										"kimi-k2.7-code": "#/components/schemas/KimiK27CodeChatRequest",
										"kimi-k2.7-code-highspeed": "#/components/schemas/KimiK27CodeChatRequest",
										"kimi-k2.6": "#/components/schemas/KimiK26ChatRequest",
										"kimi-k2.5": "#/components/schemas/KimiK25ChatRequest",
										"moonshot-v1-8k": "#/components/schemas/MoonshotV1ChatRequest",
										"moonshot-v1-32k": "#/components/schemas/MoonshotV1ChatRequest",
										"moonshot-v1-128k": "#/components/schemas/MoonshotV1ChatRequest",
										"moonshot-v1-auto": "#/components/schemas/MoonshotV1ChatRequest",
										"moonshot-v1-8k-vision-preview": "#/components/schemas/MoonshotV1ChatRequest",
										"moonshot-v1-32k-vision-preview": "#/components/schemas/MoonshotV1ChatRequest",
										"moonshot-v1-128k-vision-preview": "#/components/schemas/MoonshotV1ChatRequest"
									}
								}
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "聊天补全响应",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ChatCompletionResponse"
								}
							},
							"text/event-stream": {
								"schema": {
									"$ref": "#/components/schemas/ChatCompletionChunk"
								}
							}
						}
					},
					"400": {
						"description": "请求错误 - 参数无效",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"401": {
						"description": "未授权 - API 密钥无效或缺失",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"500": {
						"description": "服务器错误",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					}
				}
			}
		},
		"/v1/tokenizers/estimate-token-count": {
			"post": {
				"summary": "估算 Token 数量",
				"description": "估算给定消息和模型所需的 Token 数量。输入结构与聊天补全几乎相同。",
				"tags": [
					"Utilities"
				],
				"security": [
					{
						"bearerAuth": []
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/EstimateTokenRequest"
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "Token 数量估算结果",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/EstimateTokenResponse"
								}
							}
						}
					},
					"400": {
						"description": "请求错误 - 参数无效",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"401": {
						"description": "未授权 - API 密钥无效或缺失",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"500": {
						"description": "服务器错误",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					}
				}
			}
		},
		"/v1/batches": {
			"post": {
				"summary": "创建批处理任务",
				"description": "创建一个批处理任务。需要先通过文件接口上传一个 purpose=\"batch\" 的 JSONL 文件，然后使用返回的 file_id 创建任务。",
				"tags": [
					"Batch"
				],
				"security": [
					{
						"bearerAuth": []
					}
				],
				"requestBody": {
					"required": true,
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/BatchCreateRequest"
							}
						}
					}
				},
				"responses": {
					"200": {
						"description": "已创建的批处理任务",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/BatchObject"
								}
							}
						}
					},
					"400": {
						"description": "请求错误 - 参数无效",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"401": {
						"description": "未授权 - API 密钥无效或缺失",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"500": {
						"description": "服务器错误",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					}
				}
			},
			"get": {
				"summary": "列出批处理任务",
				"description": "列出当前组织的批处理任务。",
				"tags": [
					"Batch"
				],
				"security": [
					{
						"bearerAuth": []
					}
				],
				"parameters": [
					{
						"name": "after",
						"in": "query",
						"required": false,
						"description": "分页游标，传入上一页最后一个 batch 的 ID",
						"schema": {
							"type": "string"
						}
					},
					{
						"name": "limit",
						"in": "query",
						"required": false,
						"description": "每页数量，默认 20",
						"schema": {
							"type": "integer",
							"default": 20
						}
					}
				],
				"responses": {
					"200": {
						"description": "批处理任务列表",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/BatchListResponse"
								}
							}
						}
					},
					"401": {
						"description": "未授权 - API 密钥无效或缺失",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"500": {
						"description": "服务器错误",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					}
				}
			}
		},
		"/v1/batches/{batch_id}": {
			"get": {
				"summary": "获取批处理任务详情",
				"description": "获取指定批处理任务的状态和详细信息。",
				"tags": [
					"Batch"
				],
				"security": [
					{
						"bearerAuth": []
					}
				],
				"parameters": [
					{
						"name": "batch_id",
						"in": "path",
						"required": true,
						"description": "批处理任务的 ID",
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "批处理任务详情",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/BatchObject"
								}
							}
						}
					},
					"401": {
						"description": "未授权 - API 密钥无效或缺失",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"404": {
						"description": "批处理任务未找到",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"500": {
						"description": "服务器错误",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					}
				}
			}
		},
		"/v1/batches/{batch_id}/cancel": {
			"post": {
				"summary": "取消批处理任务",
				"description": "取消一个正在进行的批处理任务。取消后，任务状态将先变为 cancelling，最终变为 cancelled。仅 validating、in_progress、finalizing 状态的任务可以取消。",
				"tags": [
					"Batch"
				],
				"security": [
					{
						"bearerAuth": []
					}
				],
				"parameters": [
					{
						"name": "batch_id",
						"in": "path",
						"required": true,
						"description": "批处理任务的 ID",
						"schema": {
							"type": "string"
						}
					}
				],
				"responses": {
					"200": {
						"description": "已取消的批处理任务",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/BatchObject"
								}
							}
						}
					},
					"400": {
						"description": "请求错误 - 任务状态不允许取消",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"401": {
						"description": "未授权 - API 密钥无效或缺失",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"404": {
						"description": "批处理任务未找到",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					},
					"500": {
						"description": "服务器错误",
						"content": {
							"application/json": {
								"schema": {
									"$ref": "#/components/schemas/ErrorResponse"
								}
							}
						}
					}
				}
			}
		}
	},
	"webhooks": {}
}