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, reasoning included. When omitted, the model’s own default applies. · Range: 1 – 262144 |
stop | string | no | - | Up to 4 strings where the model will stop generating further tokens. |
enable_thinking | boolean | no | true | Enable reasoning before answering. |
reasoning_effort | enum | no | "high" | Reasoning depth while thinking is on: low, high, or xhigh. Higher effort spends more reasoning tokens before answering. The default is high. low and xhigh cannot be combined with thinking_budget. · Allowed: low, high, xhigh |
thinking_budget | number | no | - | Maximum tokens reserved for reasoning when thinking is enabled. When omitted, the model decides how long to reason. Runs at the default reasoning effort and cannot be combined with low or xhigh. Not used when a built-in tool is on, or on /v1/responses. · Range: 1 – 262144 |
preserve_thinking | boolean | no | true | 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. |
tool_web_extractor | boolean | no | false | Extract and read content from URLs. Requires Web Search and Thinking. Not used when the request also has function tools, response_format or video input. |
tool_code_interpreter | boolean | no | false | Run Python code in a sandbox. Requires Thinking. Not used when the request also has function tools, response_format or video input. |
tool_web_search_image | boolean | no | false | Search the web for images from text descriptions. 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. |
tool_image_search | boolean | no | false | Find similar images from an uploaded image. 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. |