메인 콘텐츠로 건너뛰기
POST
/
v1
/
responses
curl --request POST \
  --url https://toapis.com/v1/responses \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.3-codex-official",
    "instructions": "You are a professional code assistant",
    "input": "Write a quicksort in Python"
  }'

{
  "id": "<string>",
  "object": "<string>",
  "status": "<string>",
  "output": [
    {}
  ],
  "usage": {}
}
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

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

​
Body

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

​
응답

​
id
string
Unique response ID, usable as previous_response_id.
​
object
string
Always response.
​
status
string
응답 status: completed, failed, or in_progress.
​
output
object[]
Output items, such as message, function_call, reasoning, or web_search_call.
​
usage
object
Token usage statistics, including input, output, reasoning, and total tokens.
curl --request POST \
  --url https://toapis.com/v1/responses \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.3-codex-official",
    "instructions": "You are a professional code assistant",
    "input": "Write a quicksort in Python"
  }'