GET

/v1/schemas/together/chat/v1%2Fchat%2Fcompletions

kind inputactivity chathash 4243c0a6…extracted Oct 22, 2026version currentsource upstream spec ↗

Request body

27 properties · 2 required · 14 $defs
propertytypedescriptionconstraints
messages*ChatCompletionMessageParam[]A list of messages comprising the conversation so far.
model*stringThe name of the model to query.<br> <br> [See all of Together AI's chat models](https://docs.together.ai/docs/serverless-models#chat-models)
max_tokensintegerThe maximum number of tokens to generate.
stopstring[]A list of string sequences that truncate (stop) inference text output. For example, "</s>" stops generation as soon as the model generates the given token.
temperaturenumberA decimal number from 0-1 that determines the degree of randomness in the response. A temperature less than 1 favors more correctness and is appropriate for question answering or summarization. A value closer to 1 introduces more randomness in the output.
top_pnumberA percentage (also called the nucleus parameter) that's used to dynamically adjust the number of choices for each predicted token based on the cumulative probabilities. It specifies a probability threshold below which all less likely tokens are filtered out. T…
top_kintegerAn integer that's used to limit the number of choices for the next predicted word or token. It specifies the maximum number of tokens to consider at each step, based on their probability of occurrence. This technique helps to speed up the generation process an…
context_length_exceeded_behaviorenumDefines the behavior of the API when max_tokens exceed the maximum context length of the model. When set to 'error', the API returns 400 with an appropriate error message. When set to 'truncate', overrides max_tokens with the maximum context length of the mode…truncate | error · default: "error"
repetition_penaltynumberA number that controls the diversity of generated text by reducing the likelihood of repeated sequences. Higher values decrease repetition.
streambooleanIf true, stream tokens as Server-Sent Events as the model generates them instead of waiting for the full model response. The stream terminates with `data: [DONE]`. If false, return a single JSON object containing the results.
logprobsintegerAn integer between 0 and 20 of the top k tokens to return log probabilities for at each generation step, instead of only the sampled token. Log probabilities help assess model confidence in token predictions.0 ≤ n ≤ 20
echobooleanIf true, the response contains the prompt. Can be used with `logprobs` to return prompt logprobs.
nintegerThe number of completions to generate for each prompt.1 ≤ n ≤ 128
min_pnumberA number between 0 and 1 that can be used as an alternative to top_p and top-k.
presence_penaltynumberA number between -2.0 and 2.0 where a positive value increases the likelihood of a model talking about new topics.
frequency_penaltynumberA number between -2.0 and 2.0 where a positive value decreases the likelihood of repeating tokens that have already been mentioned.
logit_biasobjectAdjusts the likelihood of specific tokens appearing in the generated output.
seedintegerSeed value for reproducibility.
function_callenum | object
response_formatText | JSON schema | JSON objectAn object specifying the format that the model must output.
toolsToolsPart[]A list of tools the model may call. Currently, only functions are supported as a tool. Use this to provide a list of functions the model may generate JSON inputs for.
tool_choicestring | objectControls which (if any) function is called by the model. By default uses `auto`, which lets the model pick between generating a message or calling a function.
complianceconst"hipaa"
chat_template_kwargsobjectAdditional configuration to pass to model engine.
safety_modelstringThe name of the moderation model used to validate tokens. Choose from the available moderation models found [here](https://docs.together.ai/docs/inference-models#moderation-models).
reasoning_effortenumControls the level of reasoning effort the model should apply when generating responses. Higher values may result in more thoughtful and detailed responses but may take longer to generate.low | medium | high
reasoningobjectFor models that support toggling reasoning functionality, this object can be used to control that functionality.

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"together","endpointId":"v1/chat/completions","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}