GET
/v1/schemas/moonshot/chat/v1%2Fresponses
Accept:
Request body
13 properties · 2 required · 16 $defs| property | type | description | constraints |
|---|---|---|---|
| model* | string | ID 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. | |
| instructions | string | Top-level system instructions, applied ahead of every input item. | |
| stream | boolean | When true, the response is delivered as a stream of SSE events. | default: false |
| max_output_tokens | integer | Maximum 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… | |
| reasoning | object | Reasoning configuration. | |
| text | object | Output text configuration. | |
| tools | ResponsesTool[] | List of tools the model may call. | |
| tool_choice | enum | Controls tool-calling behavior. With `auto`, the model decides whether to call a tool. | auto |
| include | enum[] | 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_key | string | Context cache identifier. Reusing the same value across a session improves cache hit rate. | |
| prompt_cache_options | object | Context 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_identifier | string | A 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 tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"moonshot","endpointId":"v1/responses","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}