{
	"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"],
						"description": "消息发送者的角色"
					},
					"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"]
										}
									]
								}
							}
						],
						"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"]
			},
			"ChatRequestBase": {
				"type": "object",
				"properties": {
					"messages": {
						"type": "array",
						"description": "包含迄今为止对话的消息列表。每个元素格式为 {\"role\": \"user\", \"content\": \"你好\"}。role 支持 system、user、assistant 其一，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 数量。如果不给的话，默认给一个不错的整数比如 1024。如果结果达到最大 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"
						},
						"maxItems": 128
					},
					"prompt_cache_key": {
						"type": "string",
						"default": null,
						"description": "用于缓存相似请求的响应以优化缓存命中率。对于 Coding Agent，通常是代表单个会话的 session id 或 task id；退出并恢复会话时应保持不变。对于 Kimi Code Plan，此字段为必填以提高缓存命中率。对于其他多轮对话 Agent，也建议使用此字段"
					},
					"safety_identifier": {
						"type": "string",
						"description": "用于检测可能违反使用政策的用户的稳定标识符。应为唯一标识每个用户的字符串。建议对用户名或邮箱进行哈希处理以避免发送可识别信息"
					}
				},
				"required": ["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"]
					}
				]
			},
			"KimiK2ChatRequest": {
				"title": "kimi-k2",
				"allOf": [
					{ "$ref": "#/components/schemas/ChatRequestBase" },
					{
						"type": "object",
						"properties": {
							"model": {
								"type": "string",
								"description": "模型 ID",
								"enum": [
									"kimi-k2-0905-preview",
									"kimi-k2-0711-preview",
									"kimi-k2-turbo-preview"
								],
								"default": "kimi-k2-0905-preview"
							},
							"temperature": {
								"type": "number",
								"format": "float",
								"description": "采样温度，范围 0 到 1。较高的值（如 0.7）使输出更随机，较低的值（如 0.2）使输出更集中和确定。默认值为 0.6。",
								"default": 0.6,
								"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"]
					}
				]
			},
			"KimiK2ThinkingChatRequest": {
				"title": "kimi-k2-thinking",
				"allOf": [
					{ "$ref": "#/components/schemas/ChatRequestBase" },
					{
						"type": "object",
						"properties": {
							"model": {
								"type": "string",
								"description": "模型 ID",
								"enum": [
									"kimi-k2-thinking",
									"kimi-k2-thinking-turbo"
								],
								"default": "kimi-k2-thinking"
							},
							"temperature": {
								"type": "number",
								"format": "float",
								"description": "采样温度，范围 0 到 1。较高的值（如 0.7）使输出更随机，较低的值（如 0.2）使输出更集中和确定。默认值为 1.0。",
								"default": 1.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-kimi-k2-thinking-model#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 字符串"
															}
														}
													}
												}
											}
										}
									}
								},
								"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 数量"
							}
						}
					}
				}
			},
			"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-k2.5",
						"enum": [
							"kimi-k2.6",
							"kimi-k2.5",
							"kimi-k2-0905-preview",
							"kimi-k2-0711-preview",
							"kimi-k2-turbo-preview",
							"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 其一，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/KimiK26ChatRequest" },
											{ "$ref": "#/components/schemas/KimiK25ChatRequest" },
											{ "$ref": "#/components/schemas/KimiK2ChatRequest" },
											{ "$ref": "#/components/schemas/KimiK2ThinkingChatRequest" },
											{ "$ref": "#/components/schemas/MoonshotV1ChatRequest" }
										],
"discriminator": {
											"propertyName": "model",
											"mapping": {
												"kimi-k2.6": "#/components/schemas/KimiK26ChatRequest",
												"kimi-k2.5": "#/components/schemas/KimiK25ChatRequest",
												"kimi-k2-0905-preview": "#/components/schemas/KimiK2ChatRequest",
										"kimi-k2-0711-preview": "#/components/schemas/KimiK2ChatRequest",
										"kimi-k2-turbo-preview": "#/components/schemas/KimiK2ChatRequest",
										"kimi-k2-thinking": "#/components/schemas/KimiK2ThinkingChatRequest",
										"kimi-k2-thinking-turbo": "#/components/schemas/KimiK2ThinkingChatRequest",
										"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" }
							}
						}
					},
					"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": {}
}