GET
/v1/schemas/openai/chat/responses%2Fcompact%3Fbeta%3Dtrue
Accept:
Request body
8 properties · 1 required · 175 $defs| property | type | description | constraints |
|---|---|---|---|
| model* | BetaModelIdsShared | enum | string | Model ID used to generate the response, like `gpt-5` 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 | BetaInputItem[] | 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 |
| 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 |
| prompt_cache_key | string | A key to use when reading from or writing to the prompt cache. | length ≤ 64 · nullable |
| prompt_cache_retention | enum | How long to retain a prompt cache entry created by this request. | in_memory | 24h · nullable · deprecated |
| prompt_cache_options | BetaPromptCacheOptionsParam | Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each request can write up to four b… | nullable |
| service_tier | enum | The service tier to use for this request. | auto | default | flex | priority · nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"openai","endpointId":"responses/compact?beta=true","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}