Create a model response
Creates a model response. Provide text or image inputs to generate text or JSON outputs. Have the model call your own custom code or use built-in tools like web search or file search to use your own data as input for the model's response.
Request body
Response
OK
Example response
{
"id": "resp_67ccd3a9da748190baa7f1570fe91ac604becb25c45c1d41",
"object": "response",
"access_programs": null,
"created_at": 1741476777,
"status": "completed",
"completed_at": 1741476778,
"error": null,
"incomplete_details": null,
"instructions": null,
"max_output_tokens": null,
"model": "gpt-6-astra",
"output": [
{
"type": "message",
"id": "msg_67ccd3acc8d48190a77525dc6de64b4104becb25c45c1d41",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "The image depicts a scenic landscape with a wooden boardwalk or pathway leading through lush, green grass under a blue sky with some clouds. The setting suggests a peaceful natural area, possibly a park or nature reserve. There are trees and shrubs in the background.",
"annotations": []
}
]
}
],
"parallel_tool_calls": true,
"previous_response_id": null,
"reasoning": {
"effort": null,
"summary": null,
"context": null
},
"store": true,
"temperature": 1,
"text": {
"format": {
"type": "text"
}
},
"tool_choice": "auto",
"tools": [],
"top_p": 1,
"truncation": "disabled",
"usage": {
"input_tokens": 328,
"input_tokens_details": {
"cached_tokens": 0,
"cache_write_tokens": 0
},
"output_tokens": 52,
"output_tokens_details": {
"reasoning_tokens": 0
},
"total_tokens": 380
},
"user": null,
"metadata": {}
}Changes
Changed in 40 of the 163 revisions of this API.4039831829
- ○
added the non-success response with the status
response-non-success-status-added
- ○
added the non-success response with the status
response-non-success-status-added
- ○
- ○
added the new optional request property
/new-optional-request-property
- ○
added the required property
/to the response with the status (media type: application/json)response-required-property-added
- ○
added the required property
//////to the response with the status (media type: text/event-stream)response-required-property-added
- ○
added the required property
//////to the response with the status (media type: text/event-stream)response-required-property-added
- ○
added the required property
//////to the response with the status (media type: text/event-stream)response-required-property-added
- ○
added the required property
//////to the response with the status (media type: text/event-stream)response-required-property-added
- ○
added the required property
//////to the response with the status (media type: text/event-stream)response-required-property-added
- ○
added the required property
///to the response with the status (media type: text/event-stream)response-required-property-added
- ○
- ●
added the new
gpt-rosalind-researchenum value to the/////response property for the response status (media type: application/json)response-property-enum-value-added
- ●
added the new
gpt-rosalind-researchenum value to the//////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-rosalind-researchenum value to the//////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-rosalind-researchenum value to the//////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-rosalind-researchenum value to the//////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-rosalind-researchenum value to the//////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-rosalind-researchenum value to the///////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ○
added the new
gpt-rosalind-researchenum value to the request property/////request-property-enum-value-added
- ●
- ●
added the new
gpt-6-lunaenum value to the/////////response property for the response status (media type: application/json)response-property-enum-value-added
- ●
added the new
gpt-6-lunaenum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-6-lunaenum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-6-lunaenum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-6-lunaenum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-6-lunaenum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-6-lunaenum value to the///////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-6-solenum value to the/////////response property for the response status (media type: application/json)response-property-enum-value-added
- ●
added the new
gpt-6-solenum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-6-solenum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-6-solenum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-6-solenum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-6-solenum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-6-solenum value to the///////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ○
added the new
gpt-6-lunaenum value to the request property/////////request-property-enum-value-added
- ○
added the new
gpt-6-solenum value to the request property/////////request-property-enum-value-added
- ●
- ●
added the new
gpt-5.1-minienum value to the/////////response property for the response status (media type: application/json)response-property-enum-value-added
- ●
added the new
gpt-5.1-minienum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-5.1-minienum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-5.1-minienum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-5.1-minienum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-5.1-minienum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-5.1-minienum value to the///////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ○
added the new
gpt-5.1-minienum value to the request property/////////request-property-enum-value-added
- ●
- ○
request property
///////deprecatedrequest-property-deprecated
- ○
request property
////////////deprecatedrequest-property-deprecated
- ○
request property
////////////deprecatedrequest-property-deprecated
- ○
response property
allOf[ResponseProperties]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: application/json)response-property-deprecated
- ○
response property
allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[AdditionalToolsItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: application/json)response-property-deprecated
- ○
response property
allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[ToolSearchOutputItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: application/json)response-property-deprecated
- ○
response property
allOf[subschema #3]/output/items/oneOf[AdditionalTools]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: application/json)response-property-deprecated
- ○
response property
allOf[subschema #3]/output/items/oneOf[ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: application/json)response-property-deprecated
- ○
response property
anyOf[ResponseCompletedEvent]/response/allOf[ResponseProperties]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseCompletedEvent]/response/allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[AdditionalToolsItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseCompletedEvent]/response/allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[ToolSearchOutputItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseCompletedEvent]/response/allOf[subschema #3]/output/items/oneOf[AdditionalTools]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseCompletedEvent]/response/allOf[subschema #3]/output/items/oneOf[ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseCreatedEvent]/response/allOf[ResponseProperties]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseCreatedEvent]/response/allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[AdditionalToolsItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseCreatedEvent]/response/allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[ToolSearchOutputItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseCreatedEvent]/response/allOf[subschema #3]/output/items/oneOf[AdditionalTools]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseCreatedEvent]/response/allOf[subschema #3]/output/items/oneOf[ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseFailedEvent]/response/allOf[ResponseProperties]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseFailedEvent]/response/allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[AdditionalToolsItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseFailedEvent]/response/allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[ToolSearchOutputItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseFailedEvent]/response/allOf[subschema #3]/output/items/oneOf[AdditionalTools]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseFailedEvent]/response/allOf[subschema #3]/output/items/oneOf[ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseInProgressEvent]/response/allOf[ResponseProperties]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseInProgressEvent]/response/allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[AdditionalToolsItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseInProgressEvent]/response/allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[ToolSearchOutputItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseInProgressEvent]/response/allOf[subschema #3]/output/items/oneOf[AdditionalTools]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseInProgressEvent]/response/allOf[subschema #3]/output/items/oneOf[ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseIncompleteEvent]/response/allOf[ResponseProperties]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseIncompleteEvent]/response/allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[AdditionalToolsItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseIncompleteEvent]/response/allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[ToolSearchOutputItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseIncompleteEvent]/response/allOf[subschema #3]/output/items/oneOf[AdditionalTools]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseIncompleteEvent]/response/allOf[subschema #3]/output/items/oneOf[ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseOutputItemAddedEvent]/item/oneOf[AdditionalTools]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseOutputItemAddedEvent]/item/oneOf[ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseOutputItemDoneEvent]/item/oneOf[AdditionalTools]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[ResponseOutputItemDoneEvent]/item/oneOf[ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[subschema #57: ResponseQueuedEvent]/response/allOf[ResponseProperties]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[subschema #57: ResponseQueuedEvent]/response/allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[AdditionalToolsItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[subschema #57: ResponseQueuedEvent]/response/allOf[subschema #3]/instructions/anyOf[subschema #1]/oneOf[subschema #2: Input item list]/items/oneOf[subschema #2: Item]/oneOf[ToolSearchOutputItemParam]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[subschema #57: ResponseQueuedEvent]/response/allOf[subschema #3]/output/items/oneOf[AdditionalTools]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
response property
anyOf[subschema #57: ResponseQueuedEvent]/response/allOf[subschema #3]/output/items/oneOf[ToolSearchOutput]/tools/items/oneOf[subschema #6: MCP tool]/connector_iddeprecated (media type: text/event-stream)response-property-deprecated
- ○
- ○
added the new optional request property
//new-optional-request-property
- ○
- ○
added the new optional request property
//new-optional-request-property
- ○
- ▲
removed the enum value
gpt-5.1-miniof the request property/////////request-property-enum-value-removed
- ●
added the new
gpt-audio-minienum value to the/////////response property for the response status (media type: application/json)response-property-enum-value-added
- ●
added the new
gpt-audio-minienum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-audio-minienum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-audio-minienum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-audio-minienum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-audio-minienum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-audio-minienum value to the///////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-audio-mini-2025-12-15enum value to the/////////response property for the response status (media type: application/json)response-property-enum-value-added
- ●
added the new
gpt-audio-mini-2025-12-15enum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-audio-mini-2025-12-15enum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-audio-mini-2025-12-15enum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-audio-mini-2025-12-15enum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-audio-mini-2025-12-15enum value to the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ●
added the new
gpt-audio-mini-2025-12-15enum value to the///////////response property for the response status (media type: text/event-stream)response-property-enum-value-added
- ○
added the new
gpt-audio-minienum value to the request property/////////request-property-enum-value-added
- ○
added the new
gpt-audio-mini-2025-12-15enum value to the request property/////////request-property-enum-value-added
- ○
removed the
gpt-5.1-minienum value from the/////////response property for the response status (media type: application/json)response-property-enum-value-removed
- ○
removed the
gpt-5.1-minienum value from the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-removed
- ○
removed the
gpt-5.1-minienum value from the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-removed
- ○
removed the
gpt-5.1-minienum value from the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-removed
- ○
removed the
gpt-5.1-minienum value from the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-removed
- ○
removed the
gpt-5.1-minienum value from the//////////////response property for the response status (media type: text/event-stream)response-property-enum-value-removed
- ○
removed the
gpt-5.1-minienum value from the///////////response property for the response status (media type: text/event-stream)response-property-enum-value-removed
- ▲
- ○
added to the response body
anyOflist for the response statusresponse-body-any-of-added
- ○