Skip to main content
POST
The 응답s API is OpenAI’s newer agentic API. Compared with Chat Completions, it adds richer tool use and server-side conversation state.
  • Function calling: let models call custom functions
  • Built-in tools: use tools such as web_search_preview
  • Server-side context: use previous_response_id instead of resending the full conversation
  • Reasoning control: tune thinking depth with reasoning.effort
모델 marked as 응답s Only, such as gpt-5-pro-official and gpt-5.3-codex-official, only support this API and do not support Chat Completions. See the model list for details.

Authorizations

string
필수
Use Bearer Token authentication.
Get your API key from the API Key management page.

Body

string
필수
모델 name.Examples: "gpt-5-pro-official", "gpt-5.3-codex-official", "gpt-5.2-official"
string | object[]
필수
User input. Supports simple string input or a message array for multi-turn conversations.
string
System instructions that guide model behavior.
boolean
기본값:false
Whether to enable streaming output.
integer
Maximum number of output tokens.
number
기본값:1
Sampling temperature, from 0 to 2.
number
기본값:1
Nucleus sampling threshold, from 0 to 1.
string
Previous response ID for server-side multi-turn context.
object
Reasoning configuration. reasoning.effort can be high, medium, low, or none.
object[]
Available tools. Supported tool types include function and web_search_preview.
string
기본값:"auto"
Tool selection policy: auto, none, or required.

응답

string
Unique response ID, usable as previous_response_id.
string
Always response.
string
응답 status: completed, failed, or in_progress.
object[]
Output items, such as message, function_call, reasoning, or web_search_call.
object
Token usage statistics, including input, output, reasoning, and total tokens.