openai · OpenAI Platform Docs
Reasoning models | OpenAI API
Explains how to utilize reasoning models to handle complex tasks through internal chain-of-thought processing and provides guidance on prompting strategies for these specific model types.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Reasoning models | OpenAI API
Explains how to utilize reasoning models to handle complex tasks through internal chain-of-thought processing and provides guidance on prompting strategies for these specific model types.
When To Use
Use when you need to implement complex problem-solving workflows, multi-step reasoning tasks, or optimize prompts for models that utilize internal chain-of-thought processes.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/reasoning-models-openai-api-workflow-guide.md | A guide explaining how reasoning models use internal tokens to plan, use tools, and manage context windows within the OpenAI API. | Questions about a guide explaining how reasoning models use internal tokens to plan, use tools, and manage context windows within the... |
examples/reasoning-models-openai-api-openai-api-reasoning-effort-nodejs.text | A Node.js code snippet demonstrating how to use the OpenAI API with a reasoning model and specified effort level. | Exact payloads, commands, or snippets shown in A Node.js code snippet demonstrating how to use the OpenAI API with a reasoning model and specified effort level. |
examples/reasoning-models-openai-api-openai-api-python-reasoning-effort-low.text | A Python code snippet demonstrating how to use the OpenAI API with a reasoning model by specifying a low reasoning effort. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to use the OpenAI API with a reasoning model by specifying a low reasoning ef... |
examples/reasoning-models-openai-api-openai-api-reasoning-effort-curl-request.text | A curl command demonstrating how to send a request to the OpenAI API specifying the reasoning effort parameter. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to send a request to the OpenAI API specifying the reasoning effort parameter. |
examples/reasoning-models-openai-api-openai-api-reasoning-models-usage-response.text | A text representation of an OpenAI API response showing token usage breakdown including reasoning tokens. | Exact payloads, commands, or snippets shown in A text representation of an OpenAI API response showing token usage breakdown including reasoning tokens. |
examples/reasoning-models-openai-api-openai-api-reasoning-model-nodejs.text | A Node.js code example demonstrating how to use the reasoning parameter with the OpenAI API to generate a response. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to use the reasoning parameter with the OpenAI API to generate a response. |
examples/reasoning-models-openai-api-openai-api-python-reasoning-effort.text | A Python script demonstrating how to use the OpenAI API with a reasoning model by specifying the reasoning effort parameter. | Exact payloads, commands, or snippets shown in A Python script demonstrating how to use the OpenAI API with a reasoning model by specifying the reasoning effort par... |
examples/reasoning-models-openai-api-openai-api-reasoning-model-curl-request.text | 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-api-openai-api-reasoning-effort-nodejs-2.text | A Node.js code snippet demonstrating how to use the reasoning parameter with the OpenAI API to control model effort. | Exact payloads, commands, or snippets shown in A Node.js code snippet demonstrating how to use the reasoning parameter with the OpenAI API to control model effort. |
examples/reasoning-models-openai-api-openai-api-reasoning-model-python-request.text | A Python code example demonstrating how to use the OpenAI API to send a request to a reasoning model with specified effort levels. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to use the OpenAI API to send a request to a reasoning model with specified e... |
examples/reasoning-models-openai-api-openai-api-reasoning-model-curl-request-2.text | 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-api-openai-api-reasoning-model-response-object.text | A text representation of an OpenAI API response object containing reasoning type metadata and summary text. | Exact payloads, commands, or snippets shown in A text representation of an OpenAI API response object containing reasoning type metadata and summary text. |
examples/reasoning-models-openai-api-openai-api-reasoning-models-nodejs-response-.text | A Node.js code example demonstrating how to use the OpenAI client to create responses with specific reasoning phases like commentary and final answer. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to use the OpenAI client to create responses with specific reasoning phases... |
examples/reasoning-models-openai-api-openai-api-reasoning-models-python-response-.text | A Python code example demonstrating how to use the OpenAI client to create responses with reasoning phases using a reasoning model. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to use the OpenAI client to create responses with reasoning phases using a re... |
examples/reasoning-models-openai-api-openai-api-reasoning-models-nodejs-prompt.text | A Node.js code snippet demonstrating how to structure a prompt for OpenAI reasoning models to perform specific code transformations. | Exact payloads, commands, or snippets shown in A Node.js code snippet demonstrating how to structure a prompt for OpenAI reasoning models to perform specific code t... |
examples/reasoning-models-openai-api-openai-api-reasoning-models-python-prompt.text | A Python code snippet demonstrating how to structure a prompt for OpenAI reasoning models to perform specific code transformations. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to structure a prompt for OpenAI reasoning models to perform specific code tr... |
examples/reasoning-models-openai-api-openai-api-reasoning-models-nodejs-prompt-2.text | A Node.js code example demonstrating how to structure a prompt for OpenAI reasoning models to perform specific code transformations. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to structure a prompt for OpenAI reasoning models to perform specific code t... |
examples/reasoning-models-openai-api-openai-api-reasoning-models-python-prompt-2.text | A Python code snippet demonstrating how to structure a prompt for OpenAI reasoning models to perform specific code transformations. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to structure a prompt for OpenAI reasoning models to perform specific code tr... |
examples/reasoning-models-openai-api-openai-api-reasoning-models-nodejs-prompt-3.text | A Node.js code example demonstrating how to send a prompt to OpenAI reasoning models using the OpenAI client library. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to send a prompt to OpenAI reasoning models using the OpenAI client library. |
examples/reasoning-models-openai-api-openai-api-reasoning-models-python.text | A Python script demonstrating how to use the OpenAI client to interact with reasoning models. | Exact payloads, commands, or snippets shown in A Python script demonstrating how to use the OpenAI client to interact with reasoning models. |
examples/reasoning-models-openai-api-openai-api-reasoning-models-nodejs-prompt-4.text | A Node.js code example demonstrating how to send a prompt to OpenAI reasoning models using the OpenAI client library. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to send a prompt to OpenAI reasoning models using the OpenAI client library. |
examples/reasoning-models-openai-api-openai-api-reasoning-models-python-2.text | A Python script demonstrating how to use the OpenAI client to interact with reasoning models for complex task processing. | Exact payloads, commands, or snippets shown in A Python script demonstrating how to use the OpenAI client to interact with reasoning models for complex task process... |
examples/reasoning-models-openai-api-openai-api-reasoning-models-nodejs-chat-comp.text | A Node.js code example demonstrating how to use the OpenAI API to create a chat completion with a reasoning model. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to use the OpenAI API to create a chat completion with a reasoning model. |
examples/reasoning-models-openai-api-openai-api-python-reasoning-model-chat-compl.text | A Python script demonstrating how to use the OpenAI client to send a prompt to a reasoning model via the chat completions endpoint. | Exact payloads, commands, or snippets shown in A Python script demonstrating how to use the OpenAI client to send a prompt to a reasoning model via the chat complet... |
examples/reasoning-models-openai-api-openai-api-reasoning-models-nodejs-request.text | A Node.js code example demonstrating how to use the OpenAI API to send a prompt to a reasoning model. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to use the OpenAI API to send a prompt to a reasoning model. |
examples/reasoning-models-openai-api-openai-api-reasoning-models-python-client.text | A Python code example demonstrating how to use the OpenAI client to send a prompt to a reasoning model. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to use the OpenAI client to send a prompt to a reasoning model. |
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