Skip to main content

Overview

Reasoning models are advanced language models optimized for complex problem-solving and reasoning tasks, improving solution accuracy by outputting detailed reasoning steps (chain of thought).

Typical Use Cases

  • Complex Problem Solving: Suitable for scenarios requiring step-by-step derivation and clear logical steps, such as mathematics and scientific reasoning.
  • Decision Support Systems: Provides detailed reasoning processes to support decision analysis, helping understand the logic behind decisions.
  • Education and Training: Helps users learn and understand complex knowledge by providing detailed derivation processes.

Installation & Preparation

Before using reasoning models, make sure you have the latest version of the OpenAI SDK installed:

API Usage

Use reasoning models by calling the /chat/completions endpoint.

Request Parameters

  • max_tokens: Sets the maximum number of output tokens for the model.
  • temperature: Recommended to set between 0.5 and 0.7 (0.6 recommended) to balance creativity and logical coherence.
  • top_p: Recommended to set to 0.95.

Example Request Code

Streaming Request

Non-Streaming Request

Context Management

The reasoning content returned by the model is not automatically appended to the next round of conversation. Users need to manually manage conversation history:

Supported Models

Pricing

  • Billing is based on the number of input and output tokens.
  • For specific pricing and conversion rules, please check the model detail page.

Notes & Best Practices

  • Do not add reasoning instructions in the system message; instead, specify instructions directly in the user message.
  • In math problems, clearly state your requirements, for example: “Please reason step by step and clearly state the final answer.”
  • To prevent the model from skipping the reasoning step, it is recommended to force the model to add a newline before the output.