Fallback models
Sendmodels instead of a single model. The gateway tries each in order, and the response reports which one answered.
model in the response, or the by_model rows in usage, to see where traffic landed.
Reasoning
reasoning (an object) and reasoning_effort (a string) control thinking on models that support it. Reasoning tokens are billed as output tokens.
reasoning: { "enabled": false } or keep max_tokens large enough for the thinking and the answer.
Plugins and web search
plugins accepts web, file-parser, response-healing, and context-compression. web_search_options tunes the web plugin, and a model id ending in :online turns web search on. Plugin costs are part of the call’s charge.
Other supported fields
If you send
user, keep it stable per end user so abuse reports can be attributed.
