Plan a relaxed Saturday using these options: a park open 9am-6pm, a museum open 10am-5pm, and a cafe open 8am-8pm. Start at 10am, include a lunch break, and allow 30 minutes between stops. Return a timetable without inventing prices or opening hours.
GPT 5.6 Sol API: Online text generation, tutorials and integration guide
Connect to GPT 5.6 Sol in one click on RequestBeam. One API key connects AI and multiple data services, so you can focus on your business and explore new ideas.
GPT 5.6 Sol API pricing and billing
0-272K input tokens
Official price
- Input
-
$4.0000/M - Output
-
$20.0000/M - Cache input
-
$0.4000/M - Cache write
-
$5.0000/M
Our price Save 70%
- Input
- $1.2000 /M
- Output
- $6.0000 /M
- Cache input
- $0.1200 /M
- Cache write
- $1.5000 /M
272.001K-922K input tokens
Official price
- Input
-
$8.0000/M - Output
-
$30.0000/M - Cache input
-
$0.8000/M - Cache write
-
$10.0000/M
Our price Save 70%
- Input
- $2.4000 /M
- Output
- $9.0000 /M
- Cache input
- $0.2400 /M
- Cache write
- $3.0000 /M
GPT 5.6 Sol online chat tool
Model settings
It includes completed, reusable turns from this conversation in your next request, so you can ask follow-up questions without repeating the context.
What happens when it is off?Only your new message and any system prompt are sent. Existing messages stay visible; turning memory back on includes eligible earlier turns again.
Is this long-term memory?No. This is conversation context, not memory across separate conversations. Failed, stopped, truncated, or non-reusable replies are excluded. More history can use more input tokens and increase cost.
Advanced parameters
Conversation

How can I help you today?
No response data yet GPT 5.6 Sol prompt examples
Draft a polite customer email for this situation: an order will arrive two days late, the revised delivery date is October 15, and tracking will be sent tomorrow. Apologize without inventing compensation. Include a subject line and keep the email under 120 words.
Turn these meeting notes into an action list: Maya will revise the proposal by Friday; Leo will confirm the venue next Monday; the budget needs approval, with no owner assigned. Use columns for task, owner, deadline, and open questions. Mark missing details as unknown.
Information checked on: October 8, 2026.
What Is ChatGPT-5.6 SOL
The Sol Model in the GPT-5.6 Family for Complex Professional Work
The ChatGPT-5.6 SOL introduced here corresponds to OpenAI's official GPT-5.6 Sol. It is the flagship model in the GPT-5.6 family, officially released on July 9, 2026, alongside Terra and Luna. We position it as a general-purpose model that can combine reference materials, code, and tools to handle complex tasks, with a focus on project development, business analysis, and multi-step work. OpenAI's official release notes
A General-Purpose Model with a 1.05 Million Token Context and Image Input
The official GPT-5.6 Sol API provides a context window of 1,050,000 tokens and a maximum output of 128,000 tokens. It supports text and image input and produces text output. As a multimodal model, its image understanding can be used to read screenshots, charts, and interface references; generating images, executing code, or exporting files requires the corresponding tools and runtime environment. Official model specifications
As a multimodal model, it has many more application scenarios than a non-multimodal model, such as OCR, frontend testing, VQA, and multimodal document parsing.
Turn Thinking Off or Adjust Reasoning Effort to Match Task Difficulty
GPT-5.6 Sol supports six reasoning effort settings: none, low, medium, high, xhigh, and max. The official default is medium. Of these, none is for requests without additional reasoning, while the other levels adjust the reasoning effort the model invests in solving a problem. Official reasoning levels
We recommend starting business-scenario testing with medium: compare none or low for formatting and simple extraction; compare high for multi-file code analysis and complex reference-material processing; and, for difficult problems that require repeated checking, assess whether xhigh or max delivers sufficient benefit. Based on our experience with multiple models, xhigh and max are sometimes not the best choice.
RequestBeam's ChatGPT-5.6 SOL Online Tool and API
Through RequestBeam, we hope to help you understand how ChatGPT-5.6 SOL actually performs on your own tasks more quickly. You only need to sign in, create an API Key, and add a small amount of credit to start trying the online tool, without writing API integration code first or purchasing a fixed plan for a short-term evaluation. This also reduces the hassle of registering and managing accounts across multiple model platforms yourself.
ChatGPT-5.6 SOL Core Features and Domain Strengths
Project Programming: Understand Existing Code and Make Multi-File Changes
We think Sol is worth using for feature development, bug fixes, and refactoring in existing or new projects. One of our customers shared their experience generating a dashboard and refactoring a project of about 20,000 lines, and felt they needed to correct the model repeatedly less often.
We pay more attention to the actual tasks behind this feedback: whether the model can leave existing code outside the intended changes untouched, and whether it can handle dependencies between multiple files. When using ChatGPT-5.6 SOL for development tasks, we recommend breaking the work into small tasks to keep its context as small as possible.
Long-Running Work: Continue Migrations and Correct Problems Based on Test Feedback
We would use Sol's ability to keep working for migration and modification tasks with a clearly defined test suite. One of our customers shared that they had repeatedly used Sol Ultra to convert a Python library to Golang, reporting that the entire process took about 10+ hours and ultimately passed multiple tests of their own.
We think this case illustrates the value of sustained work, while also showing that completing a sustained task can take a long time. For language migrations, interface replacements, and batch module modifications, we recommend retaining intermediate results by module and using both existing tests and real usage scenarios for acceptance.
Webpage and Interface Generation: Turn Brief Requirements into Inspectable Interactive Prototypes
We think Sol can be used to prepare initial drafts of landing pages, product demos, and admin interfaces. A customer shared their experience using ChatGPT-5.6 SOL for frontend development. They had been using the ChatGPT series for frontend interface development and felt that the GPT-5.6 family's frontend performance had improved, although its aesthetics might still lag behind contemporary Claude models.
We think webpage and interface generation should be assessed according to the business scenario. If your main work involves admin interfaces without particularly demanding color and aesthetic requirements, ChatGPT-5.6 SOL can handle your tasks fairly well. However, if you want to create a particularly striking webpage, you will need to pair it with other models to help complete the task.
Documents and Office Deliverables: Prepare Presentations and Business Files from Reference Materials
We focus on whether Sol, when equipped with file-processing tools, can organize materials into office deliverables that remain editable. On OpenAI's release page, Model ML disclosed that it had tested Sol on 20 customer workflows and hundreds of presentations, and praised its page readability, data visualization, and reduction in rework.
For business reports, product proposals, and recurring analysis materials, we recommend providing source data, reference templates, and delivery requirements together, so the model can retain sources as it organizes the content. During acceptance, pay attention to the consistency of numbers, whether key conclusions have supporting evidence, and whether the charts and page structure are easy for readers to understand.
Writing and Content Refinement: Revise Existing Drafts over Multiple Rounds
We would more strongly recommend Sol for refining outlines, drafts, and arguments. One of our customers shared their experience using SOL to revise a short drama, discussing line by line whether dialogue changed character relationships, and checking pacing, foreshadowing, and what the audience should know at different stages. They felt that the model could still follow the overall narrative goal while discussing local details, but also noted that SOL's writing was not as creative and divergent as contemporary Claud models.
Based on our current experience with multiple models, if writing is your main focus, ChatGPT-5.6 SOL may not be your best choice. You could try Claude Opus 5, which may deliver better results.
ChatGPT-5.6 SOL Benchmarks and Performance
In this section, we retain the evaluation version, reasoning level, and runtime environment. RequestBeam's pricing; actual integration costs should be based on console prices and request usage.
Terminal Tasks: 37.88% in an Independent Terminal-Bench 4.0 Evaluation
On Vals AI's Terminal-Bench 4.0 leaderboard, GPT-5.6 Sol Max scores 37.88%, with an average cost of USD 7.98 per task. This test uses mini-swe-agent, with three independent runs on each of 66 tasks, and reports the average pass rate. On the same leaderboard, GPT-6 Astra Max scores 59.60%, with an average cost of USD 9.58 per task. Vals AI leaderboard and methodology · Sol evaluation configuration
We recommend using Sol for tasks with clear requirements. If your task calls for discussion and design, you need to switch to a model at the level of Astra or Claude Opus 5.5.
- GPT-5.6 Sol Max37.88%
- GPT-6 Astra Max59.60%
- GPT-5.6 Sol Max$7.98
- GPT-6 Astra Max$9.58
Project Programming: CursorBench 4.0 Rises from 35.7% at High to 41.7% at Max
CursorBench 4.0 uses multi-file tasks from real Cursor sessions, covering investigation, modification, and refactoring. GPT-5.6 Sol performs as follows at different reasoning levels. Original CursorBench 4.0 leaderboard
| Reasoning level | Score | Average cost per task |
|---|---|---|
| Medium | 31.1% | USD 1.77 |
| High | 35.7% | USD 2.85 |
| Extra High | 37.7% | USD 4.40 |
| Max | 41.7% | USD 8.23 |
We pay more attention to the change from High to Max: the score increases by 6 percentage points, while the task cost is nearly 2.9 times the original. For everyday project development, we recommend High for ordinary tasks, and Max when there are more constraints and greater complexity. If your task is especially complex, you may need to switch to Astra.
- Sol Medium31.1%
- Sol High35.7%
- Sol Extra High37.7%
- Sol Max41.7%
- Sol Medium$1.77
- Sol High$2.85
- Sol Extra High$4.40
- Sol Max$8.23
Professional Knowledge Work: 1611 Elo on GDPval-AA v2.1
On Artificial Analysis's current comparison page, GPT-5.6 Sol Max scores 1611 Elo on GDPval-AA v2.1. This evaluation uses 220 tasks across 44 occupations and 9 industries. Models use shell and web-browsing tools to submit documents, presentations, and spreadsheets, which are then scored through anonymous pairwise comparisons. We interpret this score as a signal of deliverable quality within that evaluation. Sol's GDPval-AA score · Evaluation methodology
For teams already using Sol to prepare reports, presentations, and business spreadsheets, we recommend retaining existing acceptance samples and then comparing whether a new model reduces missing information, numerical errors, and manual rework. A model's ranking on programming leaderboards can differ from its ranking for office deliverables, so we recommend deciding whether to switch separately for each type of work product.
- GPT-5.6 Sol Max1611
Cross-Application Automation: About 60% Goal Completion on AutomationBench-AA
In Artificial Analysis's current comparison, Sol Max scores about 60% on AutomationBench-AA. This measures the average proportion of task goals completed: if a task violates any business constraint specified by the evaluation, the task receives a score of zero. Therefore, 60% does not mean that six out of ten complete business workflows can already run without human intervention. Sol's automation score · AutomationBench-AA scoring explanation
We recommend starting with workflows whose results are easy to verify, such as retrieving customer information, summarizing support tickets, and generating handling suggestions. After connecting multiple business systems, we recommend checking separately whether queries are accurate, records refer to the correct entities, and the final state meets requirements. For reasoning levels, we recommend starting with high and then lowering or raising the thinking level according to the business situation.
- GPT-5.6 Sol Max≈ 60%
Overall Index and Generation Speed: 47 Points and About 81 Tokens per Second
Artificial Analysis's Intelligence Index v4.3.2 records GPT-5.6 Sol Max at 47 points, with a weighted cost of about USD 1.99 per task. Its measurements of the OpenAI API show an output speed of about 81.3 tokens per second. We distinguish between output speed after generation begins, the wait before the response text appears, and the time taken to complete the entire task. Artificial Analysis model evaluation
For products that require frequent interaction, we recommend first comparing response times for Medium and High. For complex analysis that can run in the background, assess whether Max improves the quality of the final deliverable. If your business scenario is particularly time-sensitive, we recommend using models in the Luna or Sonnet series.
- GPT-5.6 Sol Max47
- GPT-5.6 Sol Max≈ $1.99
- GPT-5.6 Sol Max≈ 81.3
ChatGPT-5.6 SOL Compared with GPT-5.5, GPT-5.6 Terra, GPT-6 Astra, and Claude Opus 5.5
Compared with GPT-5.5: At the Same High Level, Sol's Overall Performance and Task Cost Merit Evaluation
In Artificial Analysis v4.3.2's comparison at the same reasoning level, Sol High and GPT-5.5 High have overall index scores of 42 and 37, weighted costs per task of USD 0.81 and USD 1.54, and GDPval-AA v2.1 scores of 1505 and 1329 Elo, respectively. Sol High versus GPT-5.5 High
Based on these results, we recommend that teams still using GPT-5.5 give priority to upgrading to ChatGPT-5.6 SOL. If your business is already running reliably, you need to find a small scenario for testing before switching.
- Sol High42
- GPT-5.5 High37
- Sol High$0.81
- GPT-5.5 High$1.54
- Sol High1505
- GPT-5.5 High1329
Compared with GPT-5.6 Terra: Allocate Models and Reasoning Budgets According to Task Difficulty
At the same Max level, Sol and Terra have overall index scores of 47 and 42, weighted costs per task of USD 1.99 and USD 1.40, and GDPval-AA v2.1 scores of 1611 and 1453 Elo, respectively. However, the comparison page shows both at about 60% on AutomationBench-AA. On that basis, we consider their performance close on this automation metric. Sol Max versus Terra Max
We recommend evaluating Terra's cost for organizing fixed-format materials, batch extraction, and simple business assistants. For work that requires combining multiple materials, assessing interdependent constraints, and producing a complete report, focus on testing Sol. If the model's output does not meet your expectations, you can adjust its thinking level. If your task is quite difficult, we recommend switching to Astra.
- Sol Max47
- Terra Max42
- Sol Max$1.99
- Terra Max$1.40
- Sol Max1611
- Terra Max1453
- Sol Max≈ 60%
- Terra Max≈ 60%
Compared with GPT-6 Astra: Consider Upgrading for Complex Execution Tasks, but Compare Document Workflows Separately
In Artificial Analysis's comparison, Astra High and Sol Max have overall index scores of 51 and 47, weighted costs per task of USD 1.73 and USD 1.99, and AutomationBench-AA scores of about 67% and 60%, respectively. The ranking is reversed on GDPval-AA v2.1, however: Astra High scores 1485 Elo, while Sol Max scores 1611 Elo. Astra High versus Sol Max
We recommend prioritizing tests of Astra High for complex tool operations, cross-system execution, and engineering tasks that require ongoing investigation. Teams already using Sol to generate reports, presentations, and spreadsheets should continue comparing the quality of deliverables. Based on our current production experience, SOL is better suited to bounded tasks, while Astra is better suited to more open-ended tasks.
- Sol Max47
- Astra High51
- Sol Max$1.99
- Astra High$1.73
- Sol Max1611
- Astra High1485
- Sol Max≈ 60%
- Astra High≈ 67%
Compared with Claude Opus 5.5: Focus on Comparing Opus High for Complex Projects
On CursorBench 4.0, Opus 5.5 High scores 56.0%, with an average cost of USD 3.97 per task. Sol Max scores 41.7%, at a corresponding cost of USD 8.23. On this basis, we think Opus High merits priority evaluation for this set of Cursor project tasks; the cost conclusion should also be limited to the corresponding tasks and reasoning levels. CursorBench head-to-head results
We recommend that our customers use Claude Opus 5.5 in scenarios requiring creativity and divergent thinking, and then hand implementation and delivery to ChatGPT 5.6 SOL.
- Sol Max41.7%
- Claude Opus 5.5 High56.0%
- Sol Max$8.23
- Claude Opus 5.5 High$3.97
ChatGPT-5.6 SOL API Frequently Asked Questions
How do I call the ChatGPT-5.6 SOL API through RequestBeam?
We recommend first signing in to RequestBeam and creating an API Key, then reading our documentation or asking AI to help you configure the connection.
We recommend completing a minimal generation test through the online tool first, then integrating according to RequestBeam's current ChatGPT-5.6 SOL API documentation. This lets you verify whether the model meets your business needs before integration and helps avoid mistakenly carrying over endpoint paths and parameters from other providers into RequestBeam.
How Should Reasoning Parameters Be Set, and What Is the Difference between Max and Ultra?
With Responses, reasoning intensity is configured through an object such as reasoning: {"effort":"high"}; the corresponding field in OpenAI Chat Completions is the top-level reasoning_effort. We recommend following the parameter documentation for your chosen endpoint and starting tests with configurations supported by the current service. OpenAI reasoning parameters · Chat Completions parameters
max is a reasoning effort level supported by Sol, while Ultra involves parallel collaboration among multiple agents. We do not recommend entering ultra directly as the reasoning.effort of an ordinary request, and we do not equate community experiences with Sol Ultra to a single Max request. For similar parallel processing, use an application or orchestration capability that supports multiple agents. OpenAI's explanation of Max and Ultra
Why Have Tokens Been Consumed without a Complete Response Text?
We recommend first checking the output budget and completion status. For reasoning models, Responses' max_output_tokens covers both reasoning tokens and visible response text; the budget may be exhausted before the actual answer. If the response returns status: "incomplete" and incomplete_details.reason is max_output_tokens, you can increase the budget or lower the reasoning level if quality allows. OpenAI output budget explanation
We also recommend checking your response-parsing code. Responses' output is a list of content items that may contain messages and tool calls, so you cannot always treat the first item as the response text. If the model returns a tool call, the application must execute the tool and send back its results before the task can continue. When streaming is enabled, continuously process text deltas and completion events. RequestBeam response structure and streaming explanation
Why Does Ordinary Chat Work but Codex Reports That Compact Is Unavailable?
We recommend checking ordinary Responses requests and context compression separately. RequestBeam's current Codex documentation states that five GPT models, including Sol, do not yet have a verified Compact channel. Ordinary chat returning a result does not mean that POST https://api.requestbeam.com/openai/responses/compact is already available. Adjusting the local token threshold or switching between HTTP and WebSocket will not automatically provide this capability. RequestBeam Codex integration guide
For long-running project tasks, we recommend saving requirements, completed changes, and next steps at each stage, limiting the history carried into each round, and starting a new session before reaching the context limit. When you need automatic compression or stateful continuation that depends on previous_response_id, first confirm that the selected service explicitly supports the corresponding capability before making your business workflow depend on it. RequestBeam session capability explanation
Why use GPT 5.6 Sol through RequestBeam?
Usage-based billing and model cost optimization
Reliable service at prices lower than official rates. Top up on demand and use what you pay for.
Unified AI models and data APIs, with multi-model access in one place
One API key connects multiple AI models and data services, reducing integration costs and letting you switch with one click. Business applications need both AI and data.
Call logs and application access controls, with clarity on every call
Every API call is recorded in your dashboard. Create separate API keys for different applications.
Model capabilities without compromise
We do not water down our models. We cannot offer you the cheapest, but we are committed to offering you the best.
How to use GPT 5.6 Sol on RequestBeam
After creating an API key in the console, follow the documentation to get started with GPT 5.6 Sol.
Prepare your account and test online
Sign in, confirm your balance, and create an API key.
Try it in the Playground
Explore the model's capabilities in the Playground to find the best way to use it.
Integrate GPT 5.6 Sol into your business
Follow our developer documentation to integrate GPT 5.6 Sol into your business.
Future model upgrades
When a new model is released, simply replace the model name with the new one to upgrade.
GPT 5.6 Sol API FAQ
Can the GPT 5.6 Sol Playground analyze images, PDFs, or linked repositories?
The conversation tool accepts text without file or image upload controls. Sol has native image-input capability, and the Responses guide describes image and PDF input formats subject to model and channel support. Those inputs are separate from this text chat; a pasted link does not automatically load a file or repository.
Why is the answer incomplete or missing after a reasoning request?
An explicit output allowance may be consumed by reasoning before enough final text is produced. Check Chat finish_reason or the Responses completion status and incomplete details, along with output and usage. Narrow the task or adjust the allowance; a reasoning item or partial stream is not a completed technical answer.
Is conversation memory persistent across separate sessions?
No. It sends eligible completed turns from the current conversation with your next request. Disabling it keeps history visible but excludes it from the new input; failed, stopped, truncated, or non-reusable replies are excluded. More history can increase input usage. This control does not enable Responses persisted reasoning or stateful continuation.
How should I troubleshoot 401, 402, 403, or 429 errors?
Check authentication for 401, balance for 402, model permissions for 403, and rate or allowance limits for 429. Confirm gpt-5.6-sol against the model catalog for your key. The numeric platform code is separate from the HTTP status; inspect the complete error for upstream failures and use protocol-specific handling for errors inside an SSE stream.
Can I use OpenAI Responses or Claude Messages with GPT 5.6 Sol?
RequestBeam documents both Chat Completions and OpenAI-compatible Responses for gpt-5.6-sol, not Claude Messages. Use messages for Chat and input for Responses, and parse the matching response format. Do not infer support for Compact, a stateful previous_response_id, or every native tool from ordinary Responses availability.
Can GPT 5.6 Sol return JSON or several proposed plans?
Ask for several alternatives in one answer and define required fields, types, and unknown-value behavior for JSON. The text Playground does not enforce a schema merely because the prompt asks for one. Responses has a documented text.format configuration, subject to model support; validate syntax, schema, and factual values before downstream use.
Can GPT 5.6 Sol execute a migration or run tools here?
No. This text Playground does not run commands, modify files, or access your database. An API-based agent needs supported tool definitions, an execution environment, permissions, result feedback, and approval gates. A returned function call is a request for an action, not proof that a migration or deployment succeeded.
Should I immediately retry a slow, interrupted, or stopped request?
Check available output, request records, and usage first. Reasoning, large inputs, and long outputs affect duration. Stopping browser waiting or losing the stream does not establish that upstream work was cancelled or unprocessed. Resolve outstanding results and apply a bounded error-specific retry policy to reduce duplicate work and charges.
Related text APIs
GPT 5.6 Sol API specification and requests
GPT 5.6 Sol API quickstart
gpt-5.6-solChat CompletionsPOST /v1/chat-completions
curl -X POST "https://api.requestbeam.com/v1/chat-completions" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"Hello, introduce yourself in one sentence."}],"stream":false}'ResponsesPOST /openai/responses
curl -X POST "https://api.requestbeam.com/openai/responses" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","input":"Hello, reply with one short sentence.","stream":false}'Family and protocol reference
OpenAI Multimodal Responses
Full API documentationOpenAI-compatible Responses API. This endpoint uses OpenAI-style `input`, supports text, public image URLs, PDF file input, tool calls, reasoning options, and streaming parameters.
https://api.requestbeam.com/openai/responsesOpenAI-compatible Responses API. This endpoint uses OpenAI-style input, supports text, public image URLs, PDF file input, tool calls, reasoning options, and streaming parameters.
POST https://api.requestbeam.com/openai/responsesAuthentication
All requests require Bearer Token authentication.
Authorization: Bearer YOUR_API_KEYBody
modelstringrequiredDefault: gpt-5.4Current active models with Responses support:
gpt-5.4gpt-5.5gpt-5.6-solgpt-5.6-terragpt-6-astra
See the Model Catalog for the models visible to the current API Key.
inputstring | object[]Input content. Required unless a non-empty previous_response_id is provided. Omitting both fields or using an invalid input type returns 400 before billing.
Supported forms:
- A string, equivalent to one
usertext input. - An array of input items for conversation history, multimodal input, and tool call results.
Each object in the input array may contain the following fields:
typestringInput item type.
Common values:
message: a message input.function_call_output: the result of a function tool call.
rolestringRole when type=message.
Common values:
developersystemuserassistant
contentstring | object[]Message content.
Use a content-block array for multimodal requests. Content blocks support:
typestringContent block type.
Currently supported:
input_textinput_imageinput_file
textstringText content when type=input_text.
image_urlstringPublic image URL when type=input_image.
Only publicly accessible http:// or https:// image URLs are supported. Base64 Data URLs such as data:image/...;base64,... are not supported.
detailstringDefault: autoImage detail level when type=input_image.
Common values:
autolowhigh
file_datastringFile content Data URL when type=input_file. PDFs may use data:application/pdf;base64,....
filenamestringFile name when type=input_file.
instructionsstringSystem or developer instructions inserted into the model context.
max_output_tokensintegerOptional maximum output tokens, as a positive integer. Omit this field to use the upstream default for the selected model. Depending on the model, the budget may include reasoning tokens as well as final text. A small budget can truncate the answer or be exhausted before final text; increasing it may increase cost.
streambooleanDefault: falseWhether to stream the response.
false: return one complete responsetrue: return OpenAI Responses-style SSE events
temperaturenumberDefault: 1.0Sampling temperature, usually from 0 to 2.
top_pnumberDefault: 1.0Nucleus sampling parameter, usually from 0 to 1.
textobjectText output configuration.
text.formatobjectText format configuration, such as { "type": "text" } or a JSON schema.
text.verbositystringOutput verbosity, such as low, medium, or high. Support depends on the selected model.
toolsobject[]Tool definitions. Availability depends on the selected model and available features.
tool_choicestring | objectTool selection policy.
parallel_tool_callsbooleanWhether parallel tool calls are allowed.
reasoningobjectReasoning-related options.
includestring[]Extra fields to include in the response.
prompt_cache_keystringPrompt cache key for prompt cache reuse.
prompt_cache_retentionstringPrompt cache retention policy. Supported values depend on the selected model and available features.
safety_identifierstringStable end-user identifier for safety controls.
storebooleanWhether response state may be stored.
Model Parameter Differences
- Native OpenAI-compatible Responses forwarding preserves
top_pin the upstream request; validation and sampling behavior depend on the selected model and upstream. The checks on 2026-09-26 acceptedtop_p: 0.9forgpt-5.5,gpt-5.6-sol, andgpt-5.6-terra. Acceptance and forwarding do not prove a sampling effect or guarantee support for other values, models, or later requests. Start with a minimal request. - Support on this page applies only to the regular
/openai/responsesendpoint. It does not imply that the same model supports/openai/responses/compact, WebSocket, or statefulprevious_response_id. - The five GPT models listed above currently have no verified Compact channel. Compact requests are rejected before billing when no explicitly enabled channel is available. Ordinary Responses and Responses WebSocket remain available.
Request Examples
The examples below provide input. A continuation may omit input when it provides a valid previous_response_id and the selected channel supports stateful continuation. A response ID does not enable that capability on an unsupported channel. Tool results remain valid input items, including function_call_output.
Text
{
"model": "gpt-5.4",
"input": "Hello, introduce yourself in one sentence."
}Codex CLI-Style Parameters
{
"model": "gpt-5.5",
"input": "Reply with READY only.",
"reasoning": {
"effort": "xhigh"
},
"store": false,
"text": {
"verbosity": "low"
},
"stream": true
}Image Understanding
{
"model": "gpt-5.4",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "What is in this image?"
},
{
"type": "input_image",
"image_url": "https://example.com/cat.png",
"detail": "high"
}
]
}
]
}File Input
Use file_data plus filename to submit PDF content. file_data must be a complete Data URL.
{
"model": "gpt-5.4",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Summarize the key points in this PDF."
},
{
"type": "input_file",
"file_data": "data:application/pdf;base64,JVBERi0xLjQKJc...",
"filename": "report.pdf"
}
]
}
]
}Image and File Input
{
"model": "gpt-5.4",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Give three conclusions based on the image and attachment."
},
{
"type": "input_image",
"image_url": "https://example.com/chart.png",
"detail": "high"
},
{
"type": "input_file",
"file_data": "data:application/pdf;base64,JVBERi0xLjQKJc...",
"filename": "notes.pdf"
}
]
}
]
}Streaming Output
{
"model": "gpt-5.4",
"stream": true,
"input": [
{
"role": "user",
"content": [
{
"type": "input_text",
"text": "Explain this diagram step by step."
},
{
"type": "input_image",
"image_url": "https://example.com/diagram.png"
}
]
}
]
}Response
Non-streaming responses follow OpenAI Responses style. Actual fields may vary with selected model capabilities.
idstringUnique response identifier.
objectstringResponse object type, usually response.
created_atintegerCreation timestamp.
modelstringActual model used.
outputobject[]Output item list. Common items include message, function_call, and tool-related output.
usageobjectToken usage statistics, such as input_tokens, output_tokens, and total_tokens.
Success Example
{
"id": "resp_123",
"object": "response",
"created_at": 1766534400,
"model": "gpt-5.4",
"output": [
{
"type": "message",
"role": "assistant",
"content": [
{
"text": "The image shows a cat, and the attachment is a document about pet care."
}
]
}
],
"usage": {
"input_tokens": 128,
"output_tokens": 42,
"total_tokens": 170
}
}Streaming Response
When stream=true, the endpoint returns Server-Sent Events.
event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"The image"}
event: response.completed
data: {"type":"response.completed","response":{"id":"resp_123"}}Read events until response.completed or the connection closes.
Error Response
See Error Codes and Troubleshooting for the full code reference, protocol differences, and diagnostic steps.
Platform-generated HTTP errors use the flat fields below instead of an error wrapper. Some upstream errors may retain their original structure; errors inside an already-started SSE stream do not follow this HTTP response example.
{
"code": 40000,
"message": "Insufficient credit. Required: 30000, Available: 20000",
"type": "api_error"
}Notes
- The
Responsesendpoint usesinput, notmessages. If your client only sendsmessages, use/openai/v1/chat/completions. - Image input uses
input_image;image_urlmust be a publichttp://orhttps://URL. Base64 Data URLs are not supported for images. - File input uses
input_file. For PDFs, usefile_dataplusfilename;file_datashould be a completedata:application/pdf;base64,...URL. - Audio input/output, image generation tools, file search, and other advanced capabilities depend on the selected model and available features.
- The fields listed on this page form the current public Responses request contract; do not assume unlisted fields are available.
/openai/responsesis the recommended public path./v1/responsesfollows the same public request and response contract./compat/v1/responsesfollows the same public request and response contract./openai/v1/responsesfollows the same public request and response contract.