GET

/v1/schemas/moonshot/chat/v1%2Fresponses

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

Request body

13 properties · 2 required · 16 $defs
propertytypedescriptionconstraints
model*stringID of the model to use. This endpoint currently supports `kimi-k3.1-pro`, `kimi-k3.1-pro-highspeed`, and `kimi-k3`.
input*string | ResponsesInputItem[]Input for this request. A string is equivalent to a single user message. An array holds ordered typed items and may contain conversation history, tool calls, and tool results.
instructionsstringTop-level system instructions, applied ahead of every input item.
streambooleanWhen true, the response is delivered as a stream of SSE events.default: false
max_output_tokensintegerMaximum number of tokens to generate for this response. For Kimi K3-series models (`kimi-k3.1-pro`, `kimi-k3.1-pro-highspeed`, and `kimi-k3`) it defaults to 131072 and can be set up to 1048576. This refers to the length of tokens you expect us to return, not t…
reasoningobjectReasoning configuration.
textobjectOutput text configuration.
toolsResponsesTool[]List of tools the model may call.
tool_choiceenumControls tool-calling behavior. With `auto`, the model decides whether to call a tool.auto
includeenum[]Additional fields to return. Only effective when the `web_search` tool is used. `web_search_call.action.sources` returns the web pages the search hit; `web_search_call.results` returns image search results.
prompt_cache_keystringContext cache identifier. Reusing the same value across a session improves cache hit rate.
prompt_cache_optionsobjectContext cache write options. When omitted, cache write is enabled by default (5m tier): the system automatically writes the request prefix to the 5m cache tier
safety_identifierstringA stable identifier used to help detect users of your application that may be violating usage policies. The ID should be a string that uniquely identifies each user. It is recommended to hash the username or email address to avoid sending any identifying infor…

Validate a payload

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