GET
/v1/schemas/openai/chat/responses%2Finput_tokens
Accept:
Request body
12 properties · 0 required · 180 $defs| property | type | description | constraints |
|---|---|---|---|
| model | string | Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range of models with different capabilities, performance characteristics, and price points. Refer to the [model guide](/docs/models) to browse and compare available models. | nullable |
| input | string | InputItem[] | Text, image, or file inputs to the model, used to generate a response | nullable |
| previous_response_id | string | The unique ID of the previous response to the model. Use this to create multi-turn conversations. Learn more about [conversation state](/docs/guides/conversation-state). Cannot be used in conjunction with `conversation`. | nullable |
| tools | Tool[] | An array of tools the model may call while generating a response. You can specify which tool to use by setting the `tool_choice` parameter. | nullable |
| text | ResponseTextParam | Configuration options for a text response from the model. Can be plain text or structured JSON data. Learn more: - [Text inputs and outputs](/docs/guides/text) - [Structured Outputs](/docs/guides/structured-outputs) | nullable |
| reasoning | Reasoning | **gpt-5 and o-series models only** Configuration options for [reasoning models](https://platform.openai.com/docs/guides/reasoning). | nullable |
| truncation | enum | The truncation strategy to use for the model response. - `auto`: If the input to this Response exceeds the model's context window size, the model will truncate the response to fit the context window by dropping items from the beginning of the conversation. - `… | auto | disabled · deprecated |
| instructions | string | A system (or developer) message inserted into the model's context. When used along with `previous_response_id`, the instructions from a previous response will not be carried over to the next response. This makes it simple to swap out system (or developer) mess… | nullable |
| personality | string | enum | A model-owned style preset to apply to this request. Omit this parameter to use the model's default style. Supported values may expand over time. Values must be at most 64 characters. | |
| conversation | string | Conversation object | The conversation that this response belongs to. Items from this conversation are prepended to `input_items` for this response request. Input items and output items from this response are automatically added to this conversation after this response completes. | default: null · nullable |
| tool_choice | enum | Allowed tools | Hosted tool | … | Controls which tool the model should use, if any. | nullable |
| parallel_tool_calls | boolean | Whether to allow the model to run tool calls in parallel. | nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"openai","endpointId":"responses/input_tokens","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}