Source: Reasoning models guide (OpenAI API docs)
OpenAI's reference for reasoning models: reasoning.effort, hidden reasoning tokens, summaries, encrypted reasoning items, context preservation and token limits.
Contents
- What: official API documentation page
- Publisher: OpenAI
- Date: accessed 2026-11-14 (living document; covers GPT-5.5, GPT-5.6 and GPT-6 families)
- Original: Reasoning models
Summary
How to call OpenAI reasoning models through the Responses API: the effort and mode controls, how reasoning tokens are hidden but billed, how to get summaries, how reasoning is carried across turns and tool calls (including statelessly with encrypted content), and how to size output limits.
Key claims
- Recommended models (Nov 2026):
gpt-6-astraas default,gpt-5.6-terracheaper,gpt-5.6-lunacheapest and fastest. The Responses API is recommended; Chat Completions does not support function calling with GPT-6 Astra or GPT-6.1 Sol. reasoning.effort:none,minimal,low,medium,high,xhigh,max; support varies by model, and the default ismediumon current models.reasoning.mode(standarddefault /pro, on GPT-5.6 and GPT-6) is a separate axis;prodoes more model work, billed at the model’s standard token rates, so cost and latency rise. The guide does not say how the extra work is done (e.g. whether it samples in parallel).- Reasoning tokens are not returned but occupy context and are billed as output (
output_tokens_details.reasoning_tokens). They range from hundreds to tens of thousands per request. max_output_tokenscaps reasoning plus visible output. Hitting it givesstatus: "incomplete", possibly with no visible text. Reserve at least 25,000 tokens when starting out.- Summaries are opt-in via
reasoning.summary(auto; some models also acceptconciseordetailed). reasoning.context(auto/current_turn/all_turns; GPT-5.6 defaults toall_turns, earlier models tocurrent_turn) controls whether earlier reasoning is reused. Reuse works only within a model family; incompatible reasoning is dropped on a family switch.- With
store: false/ ZDR, reasoning items carryencrypted_content; replay all output items in order. Pass reasoning items back with tool outputs so the model continues its reasoning. - A
configuration_updateinput item can change effort mid-conversation without changing the cached prefix. - Prompting: give the goal, constraints and output format rather than every step; treat effort as a tuning knob; define “done” for agentic tasks.