/v1/responses).
Key capabilities
- Responses API — Uses the newer
/v1/responsesendpoint withinputinstead ofmessages - Reasoning control — Configure reasoning effort (minimal / low / medium / high) and summary
- Verbosity control — Set response verbosity to low, medium, or high
- Streaming — Supports real-time token streaming via SSE
- Tool use — Supports function calling and tool use
Quick example
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Must be gpt-5.2-chat |
input | array | Yes | List of { role, content } objects |
stream | boolean | No | Enable SSE streaming. Default: false |
temperature | float | No | 0\u20132. Controls randomness. Default: 1 |
top_p | float | No | Nucleus sampling threshold. Default: 1 |
max_output_tokens | integer | No | Maximum output tokens to generate |
stop | string / array | No | Sequences that stop generation |
reasoning | object | No | { effort, summary } — controls reasoning depth |
text | object | No | { format, verbosity } — controls output format and verbosity |
tools | array | No | List of tools the model may call |
store | boolean | No | Store response for later retrieval. Default: true |
API Reference
View the interactive API playground for GPT-5.2 Chat.