GET

/v1/schemas/moonshotai-cn/chat/v1%2Fresponses

kind inputactivity chathash 58bca315…extracted Oct 24, 2026version currentsource upstream spec ↗

Request body

13 properties · 2 required · 16 $defs
propertytypedescriptionconstraints
model*string使用的模型 ID。本接口当前支持 `kimi-k3.1-pro`、`kimi-k3.1-pro-highspeed` 和 `kimi-k3`。
input*string | ResponsesInputItem[]本次请求的输入。传字符串等价于一条 user 消息;传数组时按顺序给出带类型的 item,可包含历史对话、工具调用与工具结果。
instructionsstring顶层系统指令,作为最靠前的指令生效。
streamboolean为 true 时以 SSE 事件流返回响应。default: false
max_output_tokensinteger本次响应最多生成的 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`。
reasoningobject推理相关配置。
textobject输出文本配置。
toolsResponsesTool[]模型可调用的工具列表。
tool_choiceenum控制工具调用行为。取 `auto` 时由模型自行决定是否调用工具。auto
includeenum[]要额外返回的字段,仅在使用 `web_search` 工具时有效。`web_search_call.action.sources` 返回搜索命中的网页来源;`web_search_call.results` 返回图片搜索结果。
prompt_cache_keystring上下文缓存标识,同一会话使用相同取值可提升缓存命中率。
prompt_cache_optionsobject上下文缓存写入选项。不传时默认开启缓存写入(5m 档):系统自动将请求前缀写入 5m 档缓存
safety_identifierstring用于检测可能违反使用政策的用户的稳定标识符。应为唯一标识每个用户的字符串。建议对用户名或邮箱进行哈希处理以避免发送可识别信息

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"moonshotai-cn","endpointId":"v1/responses","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}