GET

/v1/schemas/byteplus/chat/chat%2Fcompletions

kind inputactivity chathash 211d113a…extracted Aug 15, 2026version currentsource upstream spec ↗

Request body

27 properties · 2 required · 13 $defs
propertytypedescriptionconstraints
model*stringArk model id (e.g. seed-2-0-lite-260428) or a preconfigured endpoint id.
messages*ChatCompletionMessage[]
max_tokensintegerMaximum tokens to generate. Mutually exclusive with max_completion_tokens — sending both is a 400.
temperaturenumber
top_pnumber
streamboolean
stopstring[]Up to four strings that stop generation when produced.
frequency_penaltynumber
logit_biasobject
logprobsboolean
top_logprobsinteger
userstringOpaque end-user identifier forwarded for abuse monitoring.
function_callany
toolsTool[]
tool_choiceany
stream_optionsStreamOptions
presence_penaltynumber
repetition_penaltynumberPenalty applied to repeated tokens. Values above 1 discourage repetition.
ninteger
response_formatResponseFormatStructured output. Only {type: 'json_schema'} works, and only on a subset of models — Ark's own features.structured_outputs flag is unreliable (seed-2-0-lite-260428 advertises support and then 400s). Probe-verified accepting: dola-seed-2-1-turbo-260628, seed-2…
parallel_tool_callsboolean
service_tierstring'flex' routes to the batch queue at a lower price with no latency guarantee; 'default' is the standard online tier.
thinkingThinkingReasoning ('deep thinking') switch. 'enabled' is the default on every model except deepseek-v3-2-251201; 'auto' is only accepted by gpt-oss-120b-250805. Cannot be combined with reasoning_effort when disabled (400 InvalidParameter).
max_completion_tokensintegerOpenAI's newer name for max_tokens; mutually exclusive with it.
reasoning_effortenumReasoning budget hint. 'none' and 'xhigh' are only accepted by glm-5-2-260617; 'max' by glm-5-2-260617 and the deepseek-v4-* models. Rejected in combination with thinking: {type: 'disabled'}. Absent from the Go SDK; probe-verified 2026-07-31.none | minimal | low | medium | high | xhigh · +1 more
top_kintegerRestricts sampling to the k most likely tokens. Absent from the Go SDK; probe-verified 2026-07-31.
seedintegerBest-effort determinism hint for repeated identical requests. Absent from the Go SDK; probe-verified 2026-07-31.

Validate a payload

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