GET
/v1/schemas/moonshotai-cn/chat/v1%2Fresponses
Accept:
Request body
13 properties · 2 required · 16 $defs| property | type | description | constraints |
|---|---|---|---|
| model* | string | 使用的模型 ID。本接口当前支持 `kimi-k3.1-pro`、`kimi-k3.1-pro-highspeed` 和 `kimi-k3`。 | |
| input* | string | ResponsesInputItem[] | 本次请求的输入。传字符串等价于一条 user 消息;传数组时按顺序给出带类型的 item,可包含历史对话、工具调用与工具结果。 | |
| instructions | string | 顶层系统指令,作为最靠前的指令生效。 | |
| stream | boolean | 为 true 时以 SSE 事件流返回响应。 | default: false |
| max_output_tokens | integer | 本次响应最多生成的 Token 数量。Kimi K3 系列(`kimi-k3.1-pro`、`kimi-k3.1-pro-highspeed`、`kimi-k3`)默认为 131072,最大可设置为 1048576。此值为期望返回的 Token 长度,而非输入加输出的总长度。达到上限时 `status` 为 `incomplete`,`incomplete_details.reason` 为 `max_output_tokens`。 | |
| reasoning | object | 推理相关配置。 | |
| text | object | 输出文本配置。 | |
| tools | ResponsesTool[] | 模型可调用的工具列表。 | |
| tool_choice | enum | 控制工具调用行为。取 `auto` 时由模型自行决定是否调用工具。 | auto |
| include | enum[] | 要额外返回的字段,仅在使用 `web_search` 工具时有效。`web_search_call.action.sources` 返回搜索命中的网页来源;`web_search_call.results` 返回图片搜索结果。 | |
| prompt_cache_key | string | 上下文缓存标识,同一会话使用相同取值可提升缓存命中率。 | |
| prompt_cache_options | object | 上下文缓存写入选项。不传时默认开启缓存写入(5m 档):系统自动将请求前缀写入 5m 档缓存 | |
| safety_identifier | string | 用于检测可能违反使用政策的用户的稳定标识符。应为唯一标识每个用户的字符串。建议对用户名或邮箱进行哈希处理以避免发送可识别信息 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"moonshotai-cn","endpointId":"v1/responses","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}