temperature | number | no | 0.7 | Sampling temperature. 0 is deterministic and 1.99 is maximum randomness. · Range: 0 – 1.99 |
top_p | number | no | 0.9 | Nucleus sampling probability mass. Lower values make outputs more focused. · Range: 0 – 1 |
max_tokens | number | no | - | Maximum output tokens. When omitted, the model’s own default applies. · Range: 1 – 131072 |
stop | string | no | - | Up to 4 strings where the model will stop generating further tokens. |
enable_thinking | boolean | no | true | Enable reasoning before answering. A request that forces a tool call runs without reasoning unless it sets enable_thinking. |
reasoning_effort | enum | no | - | Reasoning effort level. none disables thinking. low, medium, high, and max set bounded thinking budgets sized to the selected model. · Allowed: none, low, medium, high, max |
thinking_budget | number | no | - | Maximum tokens reserved for reasoning when thinking is enabled. When omitted, the model decides how long to reason. · Range: 1 – 262144 |
preserve_thinking | boolean | no | false | Include the reasoning of earlier assistant turns in the model’s input on /v1/chat/completions. Return each turn’s reasoning unchanged in that assistant message’s reasoning_content field. The earlier reasoning is billed as input tokens. Not available when a built-in tool is on. |
seed | integer | no | - | Random seed for more reproducible sampling. Reusing a seed with the same request returns similar, not always identical, output. · Range: 0 – 2147483647 |
top_k | integer | no | - | Sample only from the K most likely tokens. When omitted, the model’s own default applies. · Range: 1 – 100 |
presence_penalty | number | no | - | Penalty for tokens that already appeared in the generated text. Positive values encourage new topics. When omitted, the model’s own default applies. · Range: -2 – 2 |
repetition_penalty | number | no | - | Higher values discourage repeated phrasing, and 1 applies no penalty. When omitted, the model’s own default applies. Not available when a built-in tool is on, or on /v1/responses. · Range: 0.1 – 2 |
n | integer | no | 1 | Number of answers to return. Above 1 runs only on /v1/chat/completions, with enable_thinking false and without tools, web search or logprobs. The output tokens of every answer are billed. · Range: 1 – 4 |
logprobs | boolean | no | false | Return the log probabilities of the answer tokens, not the reasoning, on /v1/chat/completions. Not available when a built-in tool is on. |
top_logprobs | integer | no | 0 | Return up to this many most likely alternatives for each answer token. Needs logprobs set to true. · Range: 0 – 5 |
vl_high_resolution_images | boolean | no | true | Use higher resolution processing for image inputs. Applies when no built-in tool is enabled, and not on /v1/responses. |
max_pixels | number | no | 2621440 | Maximum pixel count per image when high resolution processing is disabled. · Range: 4096 – 16777216 |
video_fps | number | no | 2 | Frames per second to sample from video inputs. · Range: 0.1 – 10 |
treat_images_as_video | boolean | no | false | Treat a sequence of images as video frames. |
tool_web_search | boolean | no | false | Search the web for real-time information. Adds $0.02 to the request cost for each invoked call. Not used when the request also has function tools, response_format or video input. |
parallel_tool_calls | boolean | no | - | Allow multiple tool calls in a single assistant turn. When omitted, the model’s own default applies. |
disable_formatting | boolean | no | false | Return the answer without EmpirioLabs formatting: citations stay as plain [N] markers and no References block is added. Applies to streamed responses that use a built-in tool. |
response_format | enum | no | - | Constrain the output to valid JSON. Use JSON mode for any JSON object, or supply a JSON Schema to force an exact response shape. |