GET
/v1/schemas/nvidia/chat/openai/gpt-oss-20b
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracefeae9fe03cce51ed98f6e84f7ffe91db44de487ce5935eaaa222365b87d3eb84{
"fetchedAt": 1791535404,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
12 properties · 1 required · 2 $defs| property | type | description | constraints |
|---|---|---|---|
| messages* | Message[] | A list of messages comprising the conversation so far. The roles of the messages must be alternating between `user` and `assistant`. The last input message should have role `user`. A message with the the `system` role is optional, and must be the very first me… | |
| model | string | default: "openai/gpt-oss-20b" | |
| temperature | number | The sampling temperature to use for text generation. The higher the temperature value is, the less deterministic the output text will be. It is not recommended to modify both temperature and top_p in the same call. | 0 ≤ n ≤ 1 · default: 0.6 |
| top_p | number | The top-p sampling mass used for text generation. The top-p value determines the probability mass that is sampled at sampling time. For example, if top_p = 0.2, only the most likely tokens (summing to 0.2 cumulative probability) will be sampled. It is not reco… | 0 < n ≤ 1 · default: 0.7 |
| frequency_penalty | number | Indicates how much to penalize new tokens based on their existing frequency in the text so far, decreasing model likelihood to repeat the same line verbatim. | -2 ≤ n ≤ 2 · default: 0 |
| presence_penalty | number | Positive values penalize new tokens based on whether they appear in the text so far, increasing model likelihood to talk about new topics. | -2 ≤ n ≤ 2 · default: 0 |
| max_tokens | integer | The maximum number of tokens to generate in any given call. Note that the model is not aware of this value, and generation will simply stop at the number of tokens specified. | 1 ≤ n ≤ 4096 · default: 4096 |
| stream | boolean | If set, partial message deltas will be sent. Tokens will be sent as data-only server-sent events (SSE) as they become available (JSON responses are prefixed by `data: `), with the stream terminated by a `data: [DONE]` message. | default: false |
| stop | string[] | string | A string or a list of strings where the API will stop generating further tokens. The returned text will not contain the stop sequence. | nullable |
| reasoning_effort | enum | Controls the effort level for reasoning in reasoning-capable models. 'low' provides basic reasoning, 'medium' provides balanced reasoning, and 'high' provides detailed step-by-step reasoning. | low | medium | high · default: "medium" |
| tools | Tool[] | A list of tools the model may call. | |
| tool_choice | enum | object | Controls which (if any) tool is called by the model. |
Types
2 $defsMessageobject
| role* | enum | The role of the message author. | user | assistant |
| content* | string | The contents of the message. | nullable |
Toolobject
| type* | enum | The type of the tool. | function |
| function* | object |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"nvidia","endpointId":"openai/gpt-oss-20b","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}