Home / Servers / OpenAI API / create_response
Create a model response
An MCP tool from the OpenAI API server, hosted on mcp.hjlabs.in.
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… [POST /responses]
Name on the gateway: openai_api__create_response · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
metadata | object | Set of 16 key-value pairs that can be attached to an object. This can be… |
top_logprobs | integer | An integer between 0 and 20 specifying the maximum number of most likely… |
temperature | number | What sampling temperature to use, between 0 and 2. Higher values like 0.8 will… |
top_p | number | An alternative to sampling with temperature, called nucleus sampling, where… |
user | string | This field is being replaced by safety_identifier and prompt_cache_key. Use… |
safety_identifier | string | A stable identifier used to help detect users of your application that may be… |
prompt_cache_key | string | Used by OpenAI to cache responses for similar requests to optimize your cache… |
prompt_cache_retention | in_memory | 24h | Deprecated. Use prompt_cache_options.ttl instead. The retention policy for the… |
previous_response_id | string | The unique ID of the previous response to the model. Use this to create… |
model | string | Model ID used to generate the response, like gpt-6-astra. OpenAI offers a wide… |
background | boolean | Whether to run the model response in the background. Learn more. |
max_tool_calls | integer | The maximum number of total calls to built-in tools that can be processed in a… |
text | object | Configuration options for a text response from the model. Can be plain text or… |
tools | array | An array of tools the model may call while generating a response. You can… |
tool_choice | object | How the model should select which tool (or tools) to use when generating a… |
prompt | object | Reference to a prompt template and its variables. Learn more. |
access_programs | object | Domain-specific access programs to use for this request. |
image | object | Request level image options. |
prompt_cache_options | object | Options for prompt caching. Supported for gpt-5.6 and later models. By… |
service_tier | auto | default | flex | scale | priority | fast | ultrafast | Specifies the processing type used for serving the request. - If set to… |
truncation | auto | disabled | The truncation strategy to use for the model response. - auto: If the input to… |
reasoning | object | Configuration options for reasoning models. |
input | string | Text, image, or file inputs to the model, used to generate a response. Learn… |
include | array | Specify additional output data to include in the model response. Currently… |
parallel_tool_calls | boolean | Whether to allow the model to run tool calls in parallel. |
store | boolean | Whether to store the generated model response for later retrieval via API.… |
instructions | string | A system (or developer) message inserted into the model's context. When using… |
moderation | object | Configuration for running moderation on the input and output of this response. |
stream | boolean | If set to true, the model response data will be streamed to the client as it… |
stream_options | object | Options for streaming responses. Only set this when you set stream: true. |
conversation | object | The conversation that this response belongs to. Items from this conversation… |
context_management | array | Context management configuration for this request. |
max_output_tokens | integer | An upper bound for the number of tokens that can be generated for a response… |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "openai_api__create_response",
"arguments": {}
}Or connect the OpenAI API server directly, which lists 371 tools including this one:
claude mcp add --transport http hj-openai-api https://mcp.hjlabs.in/mcp/openai-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the create a model response tool with metadata set to ….