GET

/v1/schemas/nvidia/chat/openai/gpt-oss-20b?kind=output

Accept:

kind outputactivity chathash 64a3f811…extracted Oct 9, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `feae9fe03cce51ed98f6e84f7ffe91db44de487ce5935eaaa222365b87d3eb84` { "fetchedAt": 1791535404, "extractorVersion": "1", "verifiedAt": null }

Response body

3 properties · 3 required · 3 $defs

property	type	description	constraints
id*	string	A unique identifier for the completion.	format: uuid
choices*	Choice[]	The list of completion choices the model generated for the input prompt.
usage*	Usage	Usage statistics for the completion request.

Types

3 $defs

Choiceobject

index*	integer	The index of the choice in the list of choices (always 0).
message*	Message	A chat completion message generated by the model.
finish_reason	enum	The reason the model stopped generating tokens. This will be `stop` if the model hit a natural stop point or a provided stop sequence, or `length` if the maximum number of tokens specified in the request was reached.	stop \| length · nullable

Messageobject

role*	enum	The role of the message author.	user \| assistant
content*	string	The contents of the message.	nullable

Usageobject

completion_tokens*	integer	Number of tokens in the generated completion.
prompt_tokens*	integer	Number of tokens in the prompt.
total_tokens*	integer	Total number of tokens used in the request (prompt + completion).

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"nvidia","endpointId":"openai/gpt-oss-20b","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}