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-6 Astra API: Online text generation, tutorials and integration guide
Connect to GPT-6 Astra 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-6 Astra API pricing and billing
0-272K input tokens
Official price
- Input
-
$10.0000/M - Output
-
$50.0000/M - Cache input
-
$1.0000/M - Cache write
-
$12.5000/M
Our price Save 70%
- Input
- $3.0000 /M
- Output
- $15.0000 /M
- Cache input
- $0.3000 /M
- Cache write
- $3.7500 /M
272.001K-922K input tokens
Official price
- Input
-
$20.0000/M - Output
-
$75.0000/M - Cache input
-
$2.0000/M - Cache write
-
$25.0000/M
Our price Save 70%
- Input
- $6.0000 /M
- Output
- $22.5000 /M
- Cache input
- $0.6000 /M
- Cache write
- $7.5000 /M
GPT-6 Astra 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-6 Astra 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.
What Is ChatGPT-6 Astra?
A GPT-Series Model for Complex Reasoning, Coding, and Professional Work
The ChatGPT-6 Astra discussed here corresponds to OpenAI's official name, GPT-6 Astra, and has the API model ID gpt-6-astra. Released on September 3, 2026, it is primarily intended for complex reasoning, coding, computer use, research, and document creation. What matters most to us is whether it can combine these capabilities to keep working toward a goal and ultimately deliver a result that can be checked and used. OpenAI changelog
For example, when handling a production issue involving multiple modules, we want the model to understand the requirements and logs, find the code that needs to change, and then continue refining the fix based on test results. We think Astra is worth a serious evaluation for this kind of work that requires repeatedly cross-checking information.
A Multimodal Model with a 1.05 Million Token Context Window and Image Understanding
The official GPT-6 Astra API provides a 1,050,000 Token context window and a maximum output of 128,000 Token. It supports text and image inputs with text output, and its knowledge cutoff is April 30, 2026. We think this configuration is suited to analyzing requirements documents, code, logs, and interface screenshots as part of the same task. Official model specifications
In practice, we recommend labeling materials with filenames, versions, and dates, and asking the model to tie its conclusions to specific evidence. Long inputs also need to leave room for reasoning and the answer; when the task involves current information, provide fresh materials or connect a retrieval tool. Tasks that require image generation, video creation, or software operation also need the corresponding tools, because a harness and agent play an equally important role in completing the task.
Five Reasoning Levels Let You Adjust Reasoning Effort
GPT-6 Astra supports five reasoning effort levels: low, medium, high, xhigh, and max. We treat these settings as ways to adjust reasoning effort; actual consumption still varies by task. Official reasoning effort guidance
We recommend starting at medium to establish a business baseline: compare low for simple extraction and formatting, and try high for cross-file analysis, multiple constraints, or repeated debugging. For problems the earlier levels still cannot solve, evaluate xhigh and max. What matters more to us is whether the added wait and cost reduce rework.
RequestBeam's ChatGPT-6 Astra Online Tool and API
We want RequestBeam to help you understand ChatGPT-6 Astra's real performance 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 it through the online tool. You do not need to write API integration code first or buy a fixed plan for a short evaluation, and you have fewer model-platform accounts to manage.
ChatGPT-6 Astra's Core Capabilities and Domain Strengths
Project Coding: Pay Closer Attention to Cross-File Understanding and Complex Code Review
We think Astra deserves priority for code reviews that require understanding multiple modules at once. In CodeRabbit's early evaluation, Astra's actionable issue coverage on the more difficult cross-file review subset was 57.1%, compared with 47.6% for GPT-5.6 Sol. This metric measures whether a model can identify annotated issues and provide feedback developers can act on; the authors also explicitly note that these are early results from a specific test. CodeRabbit's firsthand evaluation
For work involving API changes, shared state, permission logic, and cross-module dependencies, we recommend providing the callers, relevant tests, and business constraints together, and asking the model to include the code location and triggering condition for each finding. Our customers report that Astra is quite capable of tracking down and resolving cross-module and relatively complex issues.
Tool Coordination: Carry Out Multistep Workflows Across Browsers and Business Software
We are optimistic about Astra's ability to carry out specific operations in existing business systems. In a public hands-on account, Claire Vo of ChatPRD had Astra in Codex operate a CRM workflow editor in Chrome, add nodes and connect logic, complete a lead-assignment workflow, draft customized emails, and send the drafts to Slack for review. Claire Vo's hands-on account
Among our customers, using ChatGPT's Computer Use to replace repetitive business operations accounts for a very large share. Based on their feedback, Astra does perform Computer Use better, but ChatGPT-5.6 Sol may offer better value in some scenarios.
Research: Gather Information, Then Check the Evidence Against a Specific Question
We would include Astra on the trial list for technical research, competitor-information gathering, and long-form review. In our internal tests, using the same prompt and reasoning level for Astra and GPT-5.6 Sol, we found that Astra surfaced more useful materials and blog posts, with broader search coverage.
At the same time, Astra's response speed is a real concern. Our customers also report that Astra is generally not as fast as they expected, and this becomes more noticeable when they need to gather a lot of information.
Visual Development: Turn a Description into an Editable 3D Prototype
We think an interesting use for Astra is to quickly create editable visual prototypes with professional software. Simon Willison used Codex mode in the ChatGPT macOS app, with Astra at medium, to operate a local Blender installation and create a scene of a pelican riding a bicycle. He then made two more rounds of changes to add the background and details, and published the .blend file, Python script, and conversation record. Simon Willison's complete process
Some of our customers have also used Blender MCP to make game assets and were satisfied with the results, while acknowledging that some character models still needed manual cleanup. We therefore recommend testing it in your actual business scenarios to assess whether it can really complete the task.
Testing and Debugging: Tasks That Need Repeated Interaction to Reveal Problems
We are especially interested in whether Astra can keep checking code execution results after writing code. In another hands-on account, Claire Vo had Astra test a preview branch in the browser for 1 hour and 45 minutes, including sending chats, refreshing the page, and checking the console. The author said it found issues that had previously been missed. Browser QA example
However, OpenAI's developer article also notes that Astra sometimes stops after the first implementation and waits for feedback; repeatedly emphasizing checks in old prompts may also lead to excessive testing. If you feel it is spending too much time testing, you can adjust AGENTS.md to limit this. In our own development, testing has not taken an unusually large share, though that may also relate to the reasoning level we use. If you set a higher reasoning level, its share of testing may increase accordingly.
ChatGPT-6 Astra Benchmarks and Performance
Terminal Tasks: About 59% in the Independent Terminal-Bench 4.0 Evaluation
In Artificial Analysis's current comparison table, Astra at max scores approximately 59% on Terminal-Bench 4.0 after rounding. AA uses mini-swe-agent to run all 66 tasks, repeating each task three times and scoring the average single-attempt pass rate. A task is successful only if it passes every test. Tasks cover software maintenance, system operations, and data processing. AA model results · Terminal-Bench 4.0 methodology
We recommend that teams handling dependency failures, database migrations, or cross-file fixes include Astra in tests on a real project. Start with the high reasoning level; lower or raise it after evaluating the results against your business tests.
- GPT-6 Astra max ≈59%
Scientific Workflows: 68.1% on Terminal-Bench-Science 0.1
In the current Terminal-Bench-Science 0.1 leaderboard, Astra at max, paired with Codex, achieves a solve rate of 68.1%. This evaluation contains 70 scientific workflows covering tasks such as data analysis, simulation, optimization, and model fitting, with acceptance based on actual artifacts and task tests. Scientific workflow leaderboard · Evaluation scope and methodology
We think this result is more useful for evaluating a research assistant that can analyze, write code, run it, and check the result. For routine data cleaning, we recommend comparing lower-cost models first. For repeated failures in fitting, simulation, or complex analysis, raise Astra's reasoning level and then check whether its output meets your requirements.
- GPT-6 Astra max + Codex 68.1%
Professional Documents: 34.2% in the Original GDP.pdf Evaluation
In Surge AI's original GDP.pdf leaderboard, Astra at max scores 34.2%, GPT-5.6 Sol at max scores 30.7%, and Claude Opus 5.5 at adaptive/max scores 30.6%. This evaluation uses PDFs and questions from real professional work, including tables, technical drawings, and easily overlooked details. Surge AI's original leaderboard
We recommend that users who need to work with manuals, extract data from charts, or cross-check information across pages try Astra first, while requiring answers to specify page numbers, applicable models, and the original evidence.
- GPT-6 Astra max 34.2%
- GPT-5.6 Sol max 30.7%
- Claude Opus 5.5 adaptive/max 30.6%
Business Automation: A 41.4% Completion Rate at Max on AutomationBench
Zapier's AutomationBench 1.0.6 tests multistep tasks in simulated business applications and scores whether the final state meets every requirement. The benchmark tests workflows that operate applications through APIs. Some Astra results are shown below. Zapier's original evaluation
| Reasoning level | Task completion rate | Average cost per task |
|---|---|---|
| Medium | 34.09% | USD 1.27 |
| High | 37.14% | USD 1.44 |
| Max | 41.40% | USD 1.73 |
From high to max, the completion rate increases by 4.26 percentage points, while average task cost rises by USD 0.29. We recommend first running a workflow with clear acceptance criteria at medium or high, then checking whether max reduces failures that genuinely affect the business. In our business scenarios, response time at max is nearly 20% slower than at high, so consider whether that delay is acceptable for your scenario.
- GPT-6 Astra Medium 34.09%
- GPT-6 Astra High 37.14%
- GPT-6 Astra Max 41.40%
- GPT-6 Astra Medium $1.27
- GPT-6 Astra High $1.44
- GPT-6 Astra Max $1.73
Overall Capability and Response Speed: An Index Score of 53 and About 48 Token/s Output
Artificial Analysis's Intelligence Index v4.3.2 gives Astra at max a score of 53. AA's measurements of the OpenAI API show an output speed of about 47.6 Token per second. This is the rate after generation begins; the actual wait also includes input processing and reasoning time. AA capability and speed evaluation
We recommend recording both the time until an answer starts appearing and the total time to complete a task for features sensitive to wait time. For simple Q&A and short-text organization, we would first compare lower reasoning levels or lighter models. For complex debugging and research analysis, check whether waiting a little longer can produce a better result. In our current workflow, we mainly use Astra at high; for more complex or different tasks, we may switch models and reasoning levels.
- GPT-6 Astra
- 53 points
- max
- GPT-6 Astra
- ≈47.6 Token/s
- max
ChatGPT-6 Astra Compared with GPT-6.1 Sol, Claude Opus 5.5, and Claude Fable 5.1
Compared with GPT-6.1 Sol: Calculate Everyday Task Costs First, Then Give Harder Problems to Astra
In Artificial Analysis's comparison at max, Astra and GPT-6.1 Sol have overall index scores of 53 and 52, respectively. Their weighted per-task costs in the same index are USD 3.26 and USD 0.72. We think this gap is enough to affect everyday model selection, especially for products handling large numbers of requests every day. Like-for-like comparison of Astra and GPT-6.1 Sol
For batch code maintenance, document organization, and information processing with clear rules, we recommend first checking whether GPT-6.1 Sol can meet the requirements. Astra can be reserved for problems that still fail after repeated attempts, complex research workflows, and reviews where mistakes are more costly. In our everyday development, GPT-6.1 Sol accounts for 80% of use; unless an issue spans modules or is especially complex, we consider switching to Astra.
- GPT-6 Astra max 53
- GPT-6.1 Sol max 52
- GPT-6 Astra max $3.26
- GPT-6.1 Sol max $0.72
Compared with Claude Opus 5.5: Consider Source Understanding, Finished Deliverables, and Task Costs Together
In AA's comparison, Opus 5.5 uses max with the default fallback configuration, while Astra uses max. Their overall index scores are 58 and 53, respectively, with weighted per-task costs of USD 5.98 and USD 3.26. We think Opus's score advantage in this overall test should be evaluated together with its higher per-task cost. Opus 5.5 and Astra comparison
If the task is mainly reading professional PDFs and checking tables and technical drawings, we recommend trying Astra first and comparing it closely with Opus 5.5. We also recommend splitting models across different, more specific scenarios in your business workflow. For example, you could use Astra for recognition and Opus 5.5 for understanding materials.
- GPT-6 Astra max 53
- Claude Opus 5.5 max + default fallback 58
- GPT-6 Astra max $3.26
- Claude Opus 5.5 max + default fallback $5.98
Compared with Claude Fable 5.1: More Attractive Execution Costs, but Keep a Comparison for Long-Document Workflows
In AA's current comparison, Astra at max and Fable 5.1 at max with the default fallback configuration both have an overall index score of 53. Their weighted per-task costs are USD 3.26 and USD 7.63, respectively. Results differ across individual tests: rounded Terminal-Bench 4.0 scores are 59% and 52%, while AA-LCR v1.1 long-context reasoning scores are 81% and 85%, respectively. We think these results are more useful for assigning different models to different tasks. Astra and Fable 5.1 comparison
Teams already using Fable 5.1 can start with comparative tests of terminal execution and multistep fixes, focusing on completion rates and the cost of the whole task. If the existing workflow mainly involves cross-document research and long-form analysis, and you have already developed effective prompts, we recommend keeping Fable while testing Astra on the same materials. Then decide which tasks, if any, to migrate. In our experience, Fable 5.1 and Astra serve different scenarios and are not replacements for each other.
- GPT-6 Astra max 53
- Claude Fable 5.1 max + default fallback 53
- GPT-6 Astra max $3.26
- Claude Fable 5.1 max + default fallback $7.63
- GPT-6 Astra max ≈59%
- Claude Fable 5.1 max + default fallback ≈52%
- GPT-6 Astra max 81%
- Claude Fable 5.1 max + default fallback 85%
ChatGPT-6 Astra API FAQ
Which Model Name and Request Format Should I Use Through RequestBeam?
We recommend first checking the invocation name in the current model catalog and the interface used by the console examples. OpenAI's official model ID is gpt-6-astra; when integrating through RequestBeam, follow the currently available model and integration examples. Do not use the product display name "ChatGPT-6 Astra" directly as a confirmed request parameter. OpenAI model ID
The table below lists fields that are easily confused between two native OpenAI protocols, so you can check them when migrating. This is a comparison of protocol fields; the actual RequestBeam request URL must still follow its current integration documentation. Official migration guidance · Chat Completions parameters · Responses output budget
| Setting | Responses | Chat Completions |
|---|---|---|
| User input | input | messages |
| Reasoning level | reasoning: {"effort": "medium"} | reasoning_effort: "medium" |
| Output budget | max_output_tokens | max_completion_tokens |
| Astra tool calling | Supported | Requires switching to Responses |
We recommend first sending a basic text request and confirming that the model, authentication, and output parsing all work. Then add streaming output, images, or tool calls.
Why Do Reasoning or Sampling Parameters Return 400 After Migrating from an Older Model?
We recommend first checking whether the old request contains reasoning_effort: "none", or reasoning.effort: "none" in Responses. Astra does not support disabling reasoning; use one of its five supported levels instead. Also remove temperature, top_p, and top_logprobs from the old configuration. For Chat Completions, remove logprobs as well; for Responses, the include field must not contain message.output_text.logprobs. OpenAI parameter migration rules
Our recommendation is to reduce the request to the model, input, and necessary output budget, get that basic request working, and then add settings one at a time. A parameter appearing in compatible-interface documentation does not mean every model accepts it. When an error occurs, check both the model's restrictions and the fields supported by the current endpoint.
Why Have Tokens Been Consumed Without a Complete Answer?
We recommend first checking the response status and usage details. Astra's reasoning tokens are not shown in full as ordinary answer text, but they still occupy context and are billed as output tokens. In Responses, max_output_tokens covers generated usage such as reasoning and the visible answer. If the budget is too small or too little context remains, generation may end before the answer begins. Reasoning usage and output budget guidance
When using Responses, we recommend checking whether status is incomplete and whether incomplete_details.reason is max_output_tokens. Then use usage.output_tokens_details.reasoning_tokens to decide whether to increase the budget, organize the input, or lower the reasoning level. We recommend observing actual consumption on a representative task before setting the budget, rather than directly reusing an output limit that was too small for an older model. Handling incomplete responses
Why Has the Model Not Completed the Follow-Up Actions After I Added tools?
We recommend first checking the interface selection. Under OpenAI's official rules, Astra tool calling requires the Responses API. For business functions you provide yourself, merely declaring tools does not automatically execute queries, calculations, or write operations in your application. Astra tool-calling requirements
After the application receives a function_call, it needs to execute the corresponding function, then return the result as function_call_output while preserving the original call_id. After receiving the result, the model may call another tool or provide a final answer. If the application maintains its own conversation history, it also needs to retain the relevant returned items, including reasoning items that accompany tool calls. Official function-calling flow
We recommend first using a simple query tool to get the full "call, execute, return, answer" flow working, then expanding to multiple tools. When integrating through RequestBeam, also confirm that the current service supports Responses, continuation with tool results, and the relevant fields. This directly affects whether multistep tasks can be completed successfully.
Why use GPT-6 Astra 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-6 Astra on RequestBeam
After creating an API key in the console, follow the documentation to get started with GPT-6 Astra.
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-6 Astra into your business
Follow our developer documentation to integrate GPT-6 Astra into your business.
Future model upgrades
When a new model is released, simply replace the model name with the new one to upgrade.
GPT-6 Astra API FAQ
Can the GPT-6 Astra Playground open images, PDFs, or websites?
This conversation tool accepts text and has no file or image upload control. Native vision and supported Responses input formats are separate capabilities. Pasting a URL does not automatically retrieve a website or analyze its file contents.
Why can a reasoning request end without a complete answer?
An explicit output budget may be exhausted by reasoning or truncate the final text. Check Chat finish_reason or Responses status and incomplete_details, along with usage. Narrow the task or adjust the allowance; partial output is not a finished answer.
Does conversation memory persist across sessions?
No. The control includes eligible completed turns from the current conversation in the next request. Disabling it keeps history visible but excludes it from new input. Failed, stopped, truncated, or non-reusable replies are not reused as normal history. More history can increase input usage.
How should I troubleshoot 401, 402, 403, or 429 errors?
Check authentication for 401, balance for 402, model access for 403, and rate or allowance limits for 429. Confirm the exact ID gpt-6-astra in the catalog for your key. Read the full error and distinguish a platform code from the HTTP status; streaming errors also need protocol-specific handling.
Can I use Responses or Claude Messages with GPT-6 Astra?
RequestBeam documents Chat Completions and OpenAI-compatible Responses for gpt-6-astra, not Claude Messages. Use messages for Chat and input for Responses with the matching response parser. Responses availability alone does not establish support for every native tool, Compact, or stateful continuation.
Can GPT-6 Astra return JSON or several alternatives?
Ask for several alternatives within one answer and define fields and unknown-value behavior for JSON. A text instruction does not enforce a schema. For an API integration, consult the documented text.format options and model support, then validate syntax and business meaning before use.
Can GPT-6 Astra run code or operate business software here?
No. This text Playground does not run commands, edit files, or send business transactions. An agent application needs supported tools, an execution environment, permissions, result feedback, and approval controls. A proposed tool action is not proof that it ran.
Should I immediately retry a slow or interrupted request?
Check available results, request records, and usage first. Reasoning and long inputs or outputs can affect duration. Stopping browser waiting or losing a stream does not prove upstream cancellation. Resolve outstanding work and use a bounded retry policy to reduce duplicate requests and charges.
Related text APIs
GPT-6 Astra API specification and requests
GPT-6 Astra API quickstart
gpt-6-astraChat 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-6-astra","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-6-astra","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.