openai · OpenAI Platform Docs
Reasoning models
Teaches how to implement and configure reasoning models using the Responses API, including managing reasoning effort levels, controlling costs, and handling context window allocation for internal reasoning tokens.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Reasoning models
Teaches how to implement and configure reasoning models using the Responses API, including managing reasoning effort levels, controlling costs, and handling context window allocation for internal reasoning tokens.
When To Use
Use when you need to implement complex problem-solving workflows, optimize the balance between reasoning quality and latency, or manage token costs for models that use internal reasoning steps.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/reasoning-models-workflow-guide.md | A guide explaining how reasoning models use internal tokens to plan, use tools, and solve complex multi-step tasks. | Questions about a guide explaining how reasoning models use internal tokens to plan, use tools, and solve complex multi-step tasks. |
examples/reasoning-models-openai-reasoning-models-javascript-request.javascript | A JavaScript code example demonstrating how to use the OpenAI SDK to send a request to a reasoning model with specified effort levels. | Exact payloads, commands, or snippets shown in A JavaScript code example demonstrating how to use the OpenAI SDK to send a request to a reasoning model with specifi... |
examples/reasoning-models-openai-reasoning-models-python-effort-parameter.python | A Python script demonstrating how to use the reasoning effort parameter with the OpenAI client to interact with reasoning models. | Exact payloads, commands, or snippets shown in A Python script demonstrating how to use the reasoning effort parameter with the OpenAI client to interact with reaso... |
examples/reasoning-models-openai-reasoning-models-curl-request.bash | A curl command demonstrating how to send a request to the OpenAI reasoning models API with specified reasoning effort. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to send a request to the OpenAI reasoning models API with specified reasoning effort. |
examples/reasoning-models-openai-reasoning-models-usage-response.json | A JSON object demonstrating the usage and token breakdown structure for OpenAI reasoning models. | Exact payloads, commands, or snippets shown in A JSON object demonstrating the usage and token breakdown structure for OpenAI reasoning models. |
examples/reasoning-models-openai-reasoning-models-javascript-request-2.javascript | A JavaScript code example demonstrating how to use the OpenAI SDK to send a request to a reasoning model with specified effort levels. | Exact payloads, commands, or snippets shown in A JavaScript code example demonstrating how to use the OpenAI SDK to send a request to a reasoning model with specifi... |
examples/reasoning-models-openai-reasoning-models-python-effort-parameter-2.python | A Python script demonstrating how to use the reasoning effort parameter with the OpenAI client to interact with reasoning models. | Exact payloads, commands, or snippets shown in A Python script demonstrating how to use the reasoning effort parameter with the OpenAI client to interact with reaso... |
examples/reasoning-models-openai-api-reasoning-model-curl-request.bash | A curl command demonstrating how to send a request to the OpenAI API using a reasoning model with specified effort levels and reasoning content inclusion. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to send a request to the OpenAI API using a reasoning model with specified effort le... |
examples/reasoning-models-openai-reasoning-models.javascript | A JavaScript code example demonstrating how to use the OpenAI SDK to create a response with specific reasoning effort settings. | Exact payloads, commands, or snippets shown in A JavaScript code example demonstrating how to use the OpenAI SDK to create a response with specific reasoning effort... |
examples/reasoning-models-openai-reasoning-models-python-effort-configuration.python | A Python script demonstrating how to configure reasoning effort and summary settings when using the OpenAI reasoning models API. | Exact payloads, commands, or snippets shown in A Python script demonstrating how to configure reasoning effort and summary settings when using the OpenAI reasoning... |
examples/reasoning-models-openai-api-reasoning-models-curl-request.bash | A curl command demonstrating how to send a request to the OpenAI API using a reasoning model with specified effort levels. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to send a request to the OpenAI API using a reasoning model with specified effort le... |
examples/reasoning-models-openai-reasoning-models-api-response.json | A JSON object demonstrating the structure of an API response from an OpenAI reasoning model, including the reasoning field and summary text. | Exact payloads, commands, or snippets shown in A JSON object demonstrating the structure of an API response from an OpenAI reasoning model, including the reasoning... |
What This Skill Covers
- Reasoning models like GPT-5.5 use internal reasoning tokens before producing a response. This helps the model plan, use tools effectively, inspect alternativ...
- Main sections:
Get started with reasoning,Reasoning effort,How reasoning works,Managing the context window,Controlling costs.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://developers.openai.com/api/docs/guides/reasoning.md