4973 4973
4974- `model: optional "gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 99 more or string`4974- `model: optional "gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 99 more or string`
4975 4975
4976 Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI4976 Model ID used to generate the response, like `gpt-5.6-sol`. OpenAI
4977 offers a wide range of models with different capabilities, performance4977 offers a wide range of models with different capabilities, performance
4978 characteristics, and price points. Refer to the [model guide](/docs/models)4978 characteristics, and price points. Refer to the [model guide](/docs/models)
4979 to browse and compare available models.4979 to browse and compare available models.
4980 4980
4981 - `"gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 99 more`4981 - `"gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 99 more`
4982 4982
4983 Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI4983 Model ID used to generate the response, like `gpt-5.6-sol`. OpenAI
4984 offers a wide range of models with different capabilities, performance4984 offers a wide range of models with different capabilities, performance
4985 characteristics, and price points. Refer to the [model guide](/docs/models)4985 characteristics, and price points. Refer to the [model guide](/docs/models)
4986 to browse and compare available models.4986 to browse and compare available models.
5322 5322
5323- `reasoning: optional object { context, effort, generate_summary, 2 more } or null`5323- `reasoning: optional object { context, effort, generate_summary, 2 more } or null`
5324 5324
5325 **gpt-5 and o-series models only**
5326
5327 Configuration options for5325 Configuration options for
5328 [reasoning models](https://platform.openai.com/docs/guides/reasoning).5326 [reasoning models](https://platform.openai.com/docs/guides/reasoning).
5329 5327
11751 11749
11752 - `model: "gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 99 more or string`11750 - `model: "gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 99 more or string`
11753 11751
11754 Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI11752 Model ID used to generate the response, like `gpt-5.6-sol`. OpenAI
11755 offers a wide range of models with different capabilities, performance11753 offers a wide range of models with different capabilities, performance
11756 characteristics, and price points. Refer to the [model guide](/docs/models)11754 characteristics, and price points. Refer to the [model guide](/docs/models)
11757 to browse and compare available models.11755 to browse and compare available models.
11758 11756
11759 - `"gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 99 more`11757 - `"gpt-5.6-sol" or "gpt-5.6-terra" or "gpt-5.6-luna" or 99 more`
11760 11758
11761 Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI11759 Model ID used to generate the response, like `gpt-5.6-sol`. OpenAI
11762 offers a wide range of models with different capabilities, performance11760 offers a wide range of models with different capabilities, performance
11763 characteristics, and price points. Refer to the [model guide](/docs/models)11761 characteristics, and price points. Refer to the [model guide](/docs/models)
11764 to browse and compare available models.11762 to browse and compare available models.
17397 17395
17398 - `reasoning: optional object { context, effort, generate_summary, 2 more } or null`17396 - `reasoning: optional object { context, effort, generate_summary, 2 more } or null`
17399 17397
17400 **gpt-5 and o-series models only**
17401
17402 Configuration options for17398 Configuration options for
17403 [reasoning models](https://platform.openai.com/docs/guides/reasoning).17399 [reasoning models](https://platform.openai.com/docs/guides/reasoning).
17404 17400
17707 -H 'Content-Type: application/json' \17703 -H 'Content-Type: application/json' \
17708 -H "Authorization: Bearer $OPENAI_API_KEY" \17704 -H "Authorization: Bearer $OPENAI_API_KEY" \
17709 -d '{17705 -d '{
17710 "model": "gpt-5.1",17706 "model": "gpt-5.6-sol",
17711 "prompt_cache_key": "prompt-cache-key-1234",17707 "prompt_cache_key": "prompt-cache-key-1234",
17712 "safety_identifier": "safety-identifier-1234",17708 "safety_identifier": "safety-identifier-1234",
17713 "temperature": 1,17709 "temperature": 1,
17733 "metadata": {17729 "metadata": {
17734 "foo": "string"17730 "foo": "string"
17735 },17731 },
17736 "model": "gpt-5.1",17732 "model": "gpt-5.6-sol",
17737 "object": "response",17733 "object": "response",
17738 "output": [17734 "output": [
17739 {17735 {
17899 -H "Content-Type: application/json" \17895 -H "Content-Type: application/json" \
17900 -H "Authorization: Bearer $OPENAI_API_KEY" \17896 -H "Authorization: Bearer $OPENAI_API_KEY" \
17901 -d '{17897 -d '{
17902 "model": "gpt-5.4",17898 "model": "gpt-5.6-sol",
17903 "input": [17899 "input": [
17904 {17900 {
17905 "role": "user",17901 "role": "user",
17931 "instructions": null,17927 "instructions": null,
17932 "max_output_tokens": null,17928 "max_output_tokens": null,
17933 "max_tool_calls": null,17929 "max_tool_calls": null,
17934 "model": "gpt-5.4",17930 "model": "gpt-5.6-sol",
17935 "output": [17931 "output": [
17936 {17932 {
17937 "id": "msg_686eef60d3e081a29283bdcbc4322fd90e34c516d176ff86",17933 "id": "msg_686eef60d3e081a29283bdcbc4322fd90e34c516d176ff86",
17991 -H "Content-Type: application/json" \17987 -H "Content-Type: application/json" \
17992 -H "Authorization: Bearer $OPENAI_API_KEY" \17988 -H "Authorization: Bearer $OPENAI_API_KEY" \
17993 -d '{17989 -d '{
17994 "model": "gpt-5.4",17990 "model": "gpt-5.6-sol",
17995 "tools": [{17991 "tools": [{
17996 "type": "file_search",17992 "type": "file_search",
17997 "vector_store_ids": ["vs_1234567890"],17993 "vector_store_ids": ["vs_1234567890"],
18014 "incomplete_details": null,18010 "incomplete_details": null,
18015 "instructions": null,18011 "instructions": null,
18016 "max_output_tokens": null,18012 "max_output_tokens": null,
18017 "model": "gpt-5.4",18013 "model": "gpt-5.6-sol",
18018 "output": [18014 "output": [
18019 {18015 {
18020 "type": "file_search_call",18016 "type": "file_search_call",
18142 -H "Content-Type: application/json" \18138 -H "Content-Type: application/json" \
18143 -H "Authorization: Bearer $OPENAI_API_KEY" \18139 -H "Authorization: Bearer $OPENAI_API_KEY" \
18144 -d '{18140 -d '{
18145 "model": "gpt-5.4",18141 "model": "gpt-5.6-sol",
18146 "input": "What is the weather like in Boston today?",18142 "input": "What is the weather like in Boston today?",
18147 "tools": [18143 "tools": [
18148 {18144 {
18182 "incomplete_details": null,18178 "incomplete_details": null,
18183 "instructions": null,18179 "instructions": null,
18184 "max_output_tokens": null,18180 "max_output_tokens": null,
18185 "model": "gpt-5.4",18181 "model": "gpt-5.6-sol",
18186 "output": [18182 "output": [
18187 {18183 {
18188 "type": "function_call",18184 "type": "function_call",
18257 -H "Content-Type: application/json" \18253 -H "Content-Type: application/json" \
18258 -H "Authorization: Bearer $OPENAI_API_KEY" \18254 -H "Authorization: Bearer $OPENAI_API_KEY" \
18259 -d '{18255 -d '{
18260 "model": "gpt-5.4",18256 "model": "gpt-5.6-sol",
18261 "input": [18257 "input": [
18262 {18258 {
18263 "role": "user",18259 "role": "user",
18286 "incomplete_details": null,18282 "incomplete_details": null,
18287 "instructions": null,18283 "instructions": null,
18288 "max_output_tokens": null,18284 "max_output_tokens": null,
18289 "model": "gpt-5.4",18285 "model": "gpt-5.6-sol",
18290 "output": [18286 "output": [
18291 {18287 {
18292 "type": "message",18288 "type": "message",
18343 -H "Content-Type: application/json" \18339 -H "Content-Type: application/json" \
18344 -H "Authorization: Bearer $OPENAI_API_KEY" \18340 -H "Authorization: Bearer $OPENAI_API_KEY" \
18345 -d '{18341 -d '{
18346 "model": "o3-mini",18342 "model": "gpt-5.6-sol",
18347 "input": "How much wood would a woodchuck chuck?",18343 "input": "How much wood would a woodchuck chuck?",
18348 "reasoning": {18344 "reasoning": {
18349 "effort": "high"18345 "effort": "high"
18364 "incomplete_details": null,18360 "incomplete_details": null,
18365 "instructions": null,18361 "instructions": null,
18366 "max_output_tokens": null,18362 "max_output_tokens": null,
18367 "model": "o1-2024-12-17",18363 "model": "gpt-5.6-sol",
18368 "output": [18364 "output": [
18369 {18365 {
18370 "type": "message",18366 "type": "message",
18421 -H "Content-Type: application/json" \18417 -H "Content-Type: application/json" \
18422 -H "Authorization: Bearer $OPENAI_API_KEY" \18418 -H "Authorization: Bearer $OPENAI_API_KEY" \
18423 -d '{18419 -d '{
18424 "model": "gpt-5.4",18420 "model": "gpt-5.6-sol",
18425 "instructions": "You are a helpful assistant.",18421 "instructions": "You are a helpful assistant.",
18426 "input": "Hello!",18422 "input": "Hello!",
18427 "stream": true18423 "stream": true
18432 18428
18433```json18429```json
18434event: response.created18430event: response.created
18435data: {"type":"response.created","response":{"id":"resp_67c9fdcecf488190bdd9a0409de3a1ec07b8b0ad4e5eb654","object":"response","created_at":1741290958,"status":"in_progress","error":null,"incomplete_details":null,"instructions":"You are a helpful assistant.","max_output_tokens":null,"model":"gpt-5.4","output":[],"parallel_tool_calls":true,"previous_response_id":null,"reasoning":{"effort":null,"summary":null},"store":true,"temperature":1.0,"text":{"format":{"type":"text"}},"tool_choice":"auto","tools":[],"top_p":1.0,"truncation":"disabled","usage":null,"user":null,"metadata":{}}}18431data: {"type":"response.created","response":{"id":"resp_67c9fdcecf488190bdd9a0409de3a1ec07b8b0ad4e5eb654","object":"response","created_at":1741290958,"status":"in_progress","error":null,"incomplete_details":null,"instructions":"You are a helpful assistant.","max_output_tokens":null,"model":"gpt-5.6-sol","output":[],"parallel_tool_calls":true,"previous_response_id":null,"reasoning":{"effort":null,"summary":null},"store":true,"temperature":1.0,"text":{"format":{"type":"text"}},"tool_choice":"auto","tools":[],"top_p":1.0,"truncation":"disabled","usage":null,"user":null,"metadata":{}}}
18436 18432
18437event: response.in_progress18433event: response.in_progress
18438data: {"type":"response.in_progress","response":{"id":"resp_67c9fdcecf488190bdd9a0409de3a1ec07b8b0ad4e5eb654","object":"response","created_at":1741290958,"status":"in_progress","error":null,"incomplete_details":null,"instructions":"You are a helpful assistant.","max_output_tokens":null,"model":"gpt-5.4","output":[],"parallel_tool_calls":true,"previous_response_id":null,"reasoning":{"effort":null,"summary":null},"store":true,"temperature":1.0,"text":{"format":{"type":"text"}},"tool_choice":"auto","tools":[],"top_p":1.0,"truncation":"disabled","usage":null,"user":null,"metadata":{}}}18434data: {"type":"response.in_progress","response":{"id":"resp_67c9fdcecf488190bdd9a0409de3a1ec07b8b0ad4e5eb654","object":"response","created_at":1741290958,"status":"in_progress","error":null,"incomplete_details":null,"instructions":"You are a helpful assistant.","max_output_tokens":null,"model":"gpt-5.6-sol","output":[],"parallel_tool_calls":true,"previous_response_id":null,"reasoning":{"effort":null,"summary":null},"store":true,"temperature":1.0,"text":{"format":{"type":"text"}},"tool_choice":"auto","tools":[],"top_p":1.0,"truncation":"disabled","usage":null,"user":null,"metadata":{}}}
18439 18435
18440event: response.output_item.added18436event: response.output_item.added
18441data: {"type":"response.output_item.added","output_index":0,"item":{"id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","type":"message","status":"in_progress","role":"assistant","content":[]}}18437data: {"type":"response.output_item.added","output_index":0,"item":{"id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","type":"message","status":"in_progress","role":"assistant","content":[]}}
18458data: {"type":"response.output_item.done","output_index":0,"item":{"id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","type":"message","status":"completed","role":"assistant","content":[{"type":"output_text","text":"Hi there! How can I assist you today?","annotations":[]}]}}18454data: {"type":"response.output_item.done","output_index":0,"item":{"id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","type":"message","status":"completed","role":"assistant","content":[{"type":"output_text","text":"Hi there! How can I assist you today?","annotations":[]}]}}
18459 18455
18460event: response.completed18456event: response.completed
18461data: {"type":"response.completed","response":{"id":"resp_67c9fdcecf488190bdd9a0409de3a1ec07b8b0ad4e5eb654","object":"response","created_at":1741290958,"status":"completed","error":null,"incomplete_details":null,"instructions":"You are a helpful assistant.","max_output_tokens":null,"model":"gpt-5.4","output":[{"id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","type":"message","status":"completed","role":"assistant","content":[{"type":"output_text","text":"Hi there! How can I assist you today?","annotations":[]}]}],"parallel_tool_calls":true,"previous_response_id":null,"reasoning":{"effort":null,"summary":null},"store":true,"temperature":1.0,"text":{"format":{"type":"text"}},"tool_choice":"auto","tools":[],"top_p":1.0,"truncation":"disabled","usage":{"input_tokens":37,"output_tokens":11,"output_tokens_details":{"reasoning_tokens":0},"total_tokens":48},"user":null,"metadata":{}}}18457data: {"type":"response.completed","response":{"id":"resp_67c9fdcecf488190bdd9a0409de3a1ec07b8b0ad4e5eb654","object":"response","created_at":1741290958,"status":"completed","error":null,"incomplete_details":null,"instructions":"You are a helpful assistant.","max_output_tokens":null,"model":"gpt-5.6-sol","output":[{"id":"msg_67c9fdcf37fc8190ba82116e33fb28c507b8b0ad4e5eb654","type":"message","status":"completed","role":"assistant","content":[{"type":"output_text","text":"Hi there! How can I assist you today?","annotations":[]}]}],"parallel_tool_calls":true,"previous_response_id":null,"reasoning":{"effort":null,"summary":null},"store":true,"temperature":1.0,"text":{"format":{"type":"text"}},"tool_choice":"auto","tools":[],"top_p":1.0,"truncation":"disabled","usage":{"input_tokens":37,"output_tokens":11,"output_tokens_details":{"reasoning_tokens":0},"total_tokens":48},"user":null,"metadata":{}}}
18462```18458```
18463 18459
18464### Text input18460### Text input
18468 -H "Content-Type: application/json" \18464 -H "Content-Type: application/json" \
18469 -H "Authorization: Bearer $OPENAI_API_KEY" \18465 -H "Authorization: Bearer $OPENAI_API_KEY" \
18470 -d '{18466 -d '{
18471 "model": "gpt-5.4",18467 "model": "gpt-5.6-sol",
18472 "input": "Tell me a three sentence bedtime story about a unicorn."18468 "input": "Tell me a three sentence bedtime story about a unicorn."
18473 }'18469 }'
18474```18470```
18486 "incomplete_details": null,18482 "incomplete_details": null,
18487 "instructions": null,18483 "instructions": null,
18488 "max_output_tokens": null,18484 "max_output_tokens": null,
18489 "model": "gpt-5.4",18485 "model": "gpt-5.6-sol",
18490 "output": [18486 "output": [
18491 {18487 {
18492 "type": "message",18488 "type": "message",
18543 -H "Content-Type: application/json" \18539 -H "Content-Type: application/json" \
18544 -H "Authorization: Bearer $OPENAI_API_KEY" \18540 -H "Authorization: Bearer $OPENAI_API_KEY" \
18545 -d '{18541 -d '{
18546 "model": "gpt-5.4",18542 "model": "gpt-5.6-sol",
18547 "tools": [{ "type": "web_search_preview" }],18543 "tools": [{ "type": "web_search_preview" }],
18548 "input": "What was a positive news story from today?"18544 "input": "What was a positive news story from today?"
18549 }'18545 }'
18562 "incomplete_details": null,18558 "incomplete_details": null,
18563 "instructions": null,18559 "instructions": null,
18564 "max_output_tokens": null,18560 "max_output_tokens": null,
18565 "model": "gpt-5.4",18561 "model": "gpt-5.6-sol",
18566 "output": [18562 "output": [
18567 {18563 {
18568 "type": "web_search_call",18564 "type": "web_search_call",