Reasoning

The Responses API Beta supports advanced reasoning capabilities, allowing models to show their internal reasoning process with configurable effort levels.

Reasoning Configuration

Configure reasoning behavior using the reasoning parameter:

Reasoning Effort Levels

The effort parameter controls how much computational effort the model puts into reasoning:

Complex Reasoning Example

For complex mathematical or logical problems:

Reasoning in Conversation Context

Include reasoning in multi-turn conversations:

Streaming Reasoning

Enable streaming to see reasoning develop in real-time:

Response with Reasoning

When reasoning is enabled, the response includes reasoning information:

Best Practices

1. Choose appropriate effort levels: Use high for complex problems, low for simple tasks
2. Consider token usage: Reasoning increases token consumption
3. Use streaming: For long reasoning chains, streaming provides better user experience
4. Include context: Provide sufficient context for the model to reason effectively

Next Steps

• Explore Tool Calling with reasoning
• Learn about Web Search integration
• Review Basic Usage fundamentals