Stateless reasoning controls. Send full conversation history in input; previous_response_id chaining and stored-response retrieval are not implemented.
Processing tier. Omitted, null, auto and default are standard processing at the model's normal rates. ultrafast is OpenAI's low-latency tier, available only for openai/gpt-6-astra and openai/gpt-6.1-sol: it is served only by OpenAI's own API (never another host, never a silent fallback to standard) and billed at Ultrafast rates. fast uses native Anthropic only for anthropic/claude-opus-5-5 at Fast rates. priority and flex return 400. Same contract as on ChatCompletionRequest.
Function tools are relayed to your application. Native web_search and x_search execute only on supported xAI routes and are filtered out on other providers. Gateway-paid searches add $0.005 per invocation. A required tool choice with no executable tools returns 400.
Request-level breakpoint; same contract as on ChatCompletionRequest. A per-part cache_control anywhere takes precedence and this is ignored.
Show child attributes
Response
A response object. When stream: true, the body is instead an SSE
stream of response.* semantic events ending with response.completed,
or response.incomplete when generation stopped short (see status).
Present only when the request set service_tier, on a completed or incomplete response (in a stream: the response.completed / response.incomplete event). Same contract as on ChatCompletion, including unknown reported strings and null.
⌘I
{"docsConfig":{"theme":"willow","$schema":"https://mintlify.com/docs.json","name":"impossibl","description":"Use one API key for models across providers. Get started, connect your app, and manage usage and billing.","colors":{"primary":"#000000","light":"#FFFFFF","dark":"#000000"},"logo":{"light":"https://mintcdn.com/impossibl/3d3DRU0do26ni_Q1/logo-light-v2.png?fit=max\u0026auto=format\u0026n=3d3DRU0do26ni_Q1\u0026q=85\u0026s=c8f499ee9ee34ad48d6237725054f6d5","dark":"https://mintcdn.com/impossibl/3d3DRU0do26ni_Q1/logo-dark-v2.png?fit=max\u0026auto=format\u0026n=3d3DRU0do26ni_Q1\u0026q=85\u0026s=3d2870508f4e1d38ce884314bc45bf93"},"favicon":{"light":"https://mintcdn.com/impossibl/3d3DRU0do26ni_Q1/favicon-light.svg?fit=max\u0026auto=format\u0026n=3d3DRU0do26ni_Q1\u0026q=85\u0026s=e2f99d84d17cfc0ce1e8a69fa9ce22d7","dark":"https://mintcdn.com/impossibl/3d3DRU0do26ni_Q1/favicon-dark.svg?fit=max\u0026auto=format\u0026n=3d3DRU0do26ni_Q1\u0026q=85\u0026s=1478ca16d79753dfb3afa484f449af86"},"background":{"color":{"light":"#FFFFFF","dark":"#000000"}},"navbar":{"links":[{"href":"https://impossibl.com/models","label":"Models"}],"primary":{"type":"button","label":"Console","href":"https://impossibl.com/dashboard"}},"seo":{"metatags":{"canonical":"https://impossibl.com/docs","og:site_name":"impossibl","twitter:site":"@Impossiblai","og:image":"https://impossibl.com/opengraph-image","twitter:image":"https://impossibl.com/opengraph-image","twitter:card":"summary_large_image"},"organization":{"name":"impossibl","url":"https://impossibl.com","logo":"https://impossibl.com/brand/impossibl-icon.png","sameAs":["https://x.com/Impossiblai","https://github.com/impossiblco"]}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"impossibl","hasAudioNarration":false,"actualSubdomain":"impossibl","customDomains":["impossibl.com"],"gitSource":{"type":"github","owner":"impossiblco","repo":"imp-monorepo","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"c3292231-1b34-4e3f-8585-5bedf8c02381","liveDeploymentHistoryId":"6adfa93e1421c8c54a042a7e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adfa93e1421c8c54a042a7e"},"entitlements":{},"buildId":"6ae2f6b2eead52743c6f5e6e","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":68},{"language":"default","tag":"Guides","count":27},{"language":"default","tag":"Build","count":8},{"language":"default","tag":"Modalities","count":8},{"language":"default","tag":"Get started","count":6},{"language":"default","tag":"Manage","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/create-a-response-openai-responses-api","slug":"/api-reference/create-a-response-openai-responses-api","pageMetadata":{"title":"Create a response (OpenAI Responses API)","description":"Implements OpenAI's Responses API for text. Set `stream: true` for semantic-event SSE.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/responses","href":"/api-reference/create-a-response-openai-responses-api","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Implements OpenAI’s Responses API for text. Set \", _jsx(_components.code, {\n children: \"stream: true\"\n }), \" for semantic-event SSE.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a response (OpenAI Responses API)","description":"Implements OpenAI's Responses API for text. Set `stream: true` for semantic-event SSE.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/responses","href":"/api-reference/create-a-response-openai-responses-api","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/impossibl/c75059c84ec01199/analytics.js"],"openApiReferenceData":{"operation":{"operationId":"createResponse","summary":"Create a response (OpenAI Responses API)","description":"Implements OpenAI's Responses API for text. Set `stream: true` for semantic-event SSE.","requestBody":"49cd3ddf-08ba-4771-a930-dc4740123021","responses":{"200":"8925a183-64fb-40d4-9203-7b561eb63a95","400":"ac1fe674-6b55-455b-a1f2-52e2f903dd52","401":"01c26346-6c59-4130-8bdd-86a071dfd614","402":"9921204f-a85f-489a-aca8-eeea6ac50a7e","404":"b3d79436-decb-4da9-9fb5-35219baefca4","502":"0f0e5251-cc96-49dd-bcfb-fd97c07e7de9","503":"fb8648bb-4e23-48b1-8f79-7d36a428e066"},"method":"post","type":"path","servers":["56354270-4d43-4a36-9df8-087ce55ddbb8","b9326fa1-d188-49aa-a659-8ec127b80a40"],"security":["b9e249f0-508d-49aa-b644-e83d1e514b84"],"path":"/v1/responses","baseUrlOptions":["https://api.impossibl.com","http://localhost:8787"],"title":"Create a response (OpenAI Responses API)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","input"],"properties":{"model":{"type":"string","example":"anthropic/claude-sonnet-4-5","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"input":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"input.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"object","description":"A role message, or a `function_call` / `function_call_output` item on follow-up turns. A `reasoning` item echoed from a prior response is accepted and dropped.","properties":{"type":{"type":"string","enum":["message","function_call","function_call_output","reasoning"],"uniqueKey":"input.oneOf.1.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"role":{"type":"string","enum":["system","developer","user","assistant"],"uniqueKey":"input.oneOf.1.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"content":{"oneOf":[{"type":"string","description":"A text string, or an array of input parts (input_text, input_image, input_audio).","uniqueKey":"input.oneOf.1.items.[INDEX].content.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["input_text","input_image","input_audio"],"uniqueKey":"input.oneOf.1.items.[INDEX].content.oneOf.1.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"text":{"type":"string","description":"Present when `type` is `input_text`.","uniqueKey":"input.oneOf.1.items.[INDEX].content.oneOf.1.items.[INDEX].text","typeLabel":"string"},"image_url":{"oneOf":[{"type":"string","description":"Present when `type` is `input_image`: an http(s) URL or a `data:` URI, as a string or `{ url }`. Inside a `function_call_output` only a `data:` URI is accepted.","uniqueKey":"input.oneOf.1.items.[INDEX].content.oneOf.1.items.[INDEX].image_url.oneOf.0","typeLabel":"string"},{"type":"object","description":"Present when `type` is `input_image`: an http(s) URL or a `data:` URI, as a string or `{ url }`. Inside a `function_call_output` only a `data:` URI is accepted.","properties":{"url":{"type":"string","uniqueKey":"input.oneOf.1.items.[INDEX].content.oneOf.1.items.[INDEX].image_url.oneOf.1.url","typeLabel":"string"}},"uniqueKey":"input.oneOf.1.items.[INDEX].content.oneOf.1.items.[INDEX].image_url.oneOf.1","typeLabel":"object"}],"uniqueKey":"input.oneOf.1.items.[INDEX].content.oneOf.1.items.[INDEX].image_url","typeLabel":"string | object"},"input_audio":{"type":"object","description":"Present when `type` is `input_audio`. Only models advertising `audio` in `input_modalities` accept it.","properties":{"data":{"type":"string","description":"Base64-encoded audio (no data-URI prefix).","uniqueKey":"input.oneOf.1.items.[INDEX].content.oneOf.1.items.[INDEX].input_audio.data","typeLabel":"string"},"format":{"type":"string","description":"`wav` or `mp3` (`aiff`, `aac`, `ogg`, `flac` also pass through).","uniqueKey":"input.oneOf.1.items.[INDEX].content.oneOf.1.items.[INDEX].input_audio.format","typeLabel":"string"}},"uniqueKey":"input.oneOf.1.items.[INDEX].content.oneOf.1.items.[INDEX].input_audio","typeLabel":"object"}},"uniqueKey":"input.oneOf.1.items.[INDEX].content.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"A text string, or an array of input parts (input_text, input_image, input_audio).","uniqueKey":"input.oneOf.1.items.[INDEX].content.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"input.oneOf.1.items.[INDEX].content","typeLabel":"string | object[]"},"call_id":{"type":"string","description":"Correlates a function_call and its function_call_output.","uniqueKey":"input.oneOf.1.items.[INDEX].call_id","typeLabel":"string"},"name":{"type":"string","uniqueKey":"input.oneOf.1.items.[INDEX].name","typeLabel":"string"},"arguments":{"type":"string","description":"JSON-encoded arguments string (on function_call).","uniqueKey":"input.oneOf.1.items.[INDEX].arguments","typeLabel":"string"},"output":{"oneOf":[{"type":"string","description":"Tool result (on function_call_output): a text string, or an array of input parts (input_text, input_image) to return an image from the tool. An `input_image` there must be a `data:` base64 URI; an http(s) URL returns 400.","uniqueKey":"input.oneOf.1.items.[INDEX].output.oneOf.0","typeLabel":"string"},{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["input_text","input_image","input_audio"],"uniqueKey":"input.oneOf.1.items.[INDEX].output.oneOf.1.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"text":{"type":"string","description":"Present when `type` is `input_text`.","uniqueKey":"input.oneOf.1.items.[INDEX].output.oneOf.1.items.[INDEX].text","typeLabel":"string"},"image_url":{"oneOf":[{"type":"string","description":"Present when `type` is `input_image`: an http(s) URL or a `data:` URI, as a string or `{ url }`. Inside a `function_call_output` only a `data:` URI is accepted.","uniqueKey":"input.oneOf.1.items.[INDEX].output.oneOf.1.items.[INDEX].image_url.oneOf.0","typeLabel":"string"},{"type":"object","description":"Present when `type` is `input_image`: an http(s) URL or a `data:` URI, as a string or `{ url }`. Inside a `function_call_output` only a `data:` URI is accepted.","properties":{"url":{"type":"string","uniqueKey":"input.oneOf.1.items.[INDEX].output.oneOf.1.items.[INDEX].image_url.oneOf.1.url","typeLabel":"string"}},"uniqueKey":"input.oneOf.1.items.[INDEX].output.oneOf.1.items.[INDEX].image_url.oneOf.1","typeLabel":"object"}],"uniqueKey":"input.oneOf.1.items.[INDEX].output.oneOf.1.items.[INDEX].image_url","typeLabel":"string | object"},"input_audio":{"type":"object","description":"Present when `type` is `input_audio`. Only models advertising `audio` in `input_modalities` accept it.","properties":{"data":{"type":"string","description":"Base64-encoded audio (no data-URI prefix).","uniqueKey":"input.oneOf.1.items.[INDEX].output.oneOf.1.items.[INDEX].input_audio.data","typeLabel":"string"},"format":{"type":"string","description":"`wav` or `mp3` (`aiff`, `aac`, `ogg`, `flac` also pass through).","uniqueKey":"input.oneOf.1.items.[INDEX].output.oneOf.1.items.[INDEX].input_audio.format","typeLabel":"string"}},"uniqueKey":"input.oneOf.1.items.[INDEX].output.oneOf.1.items.[INDEX].input_audio","typeLabel":"object"}},"uniqueKey":"input.oneOf.1.items.[INDEX].output.oneOf.1.items.[INDEX]","typeLabel":"object"},"description":"Tool result (on function_call_output): a text string, or an array of input parts (input_text, input_image) to return an image from the tool. An `input_image` there must be a `data:` base64 URI; an http(s) URL returns 400.","uniqueKey":"input.oneOf.1.items.[INDEX].output.oneOf.1","typeLabel":"object[]"}],"uniqueKey":"input.oneOf.1.items.[INDEX].output","typeLabel":"string | object[]"}},"uniqueKey":"input.oneOf.1.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"input.oneOf.1","typeLabel":"object[]"}],"isRequired":true,"uniqueKey":"input","typeLabel":"string | object[]"},"instructions":{"type":"string","uniqueKey":"instructions","typeLabel":"string"},"stream":{"type":"boolean","default":false,"uniqueKey":"stream","typeLabel":"boolean"},"temperature":{"type":"number","uniqueKey":"temperature","typeLabel":"number"},"top_p":{"type":"number","uniqueKey":"top_p","typeLabel":"number"},"max_output_tokens":{"type":"integer","uniqueKey":"max_output_tokens","typeLabel":"integer"},"reasoning":{"type":"object","description":"Stateless reasoning controls. Send full conversation history in input; previous_response_id chaining and stored-response retrieval are not implemented.","properties":{"effort":{"oneOf":[{"type":"string","enum":["none","minimal","low","medium","high","xhigh","max"],"description":"Translated per model and route exactly like Chat Completions' `reasoning_effort`, so a level the model lacks moves to the nearest one it has (ties to the lower), and `max` runs at the model's highest level. The `x-impossibl-reasoning` response header reports what was applied.","uniqueKey":"reasoning.effort.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["none","minimal","low","medium","high","xhigh","max"],"description":"Translated per model and route exactly like Chat Completions' `reasoning_effort`, so a level the model lacks moves to the nearest one it has (ties to the lower), and `max` runs at the model's highest level. The `x-impossibl-reasoning` response header reports what was applied.","uniqueKey":"reasoning.effort.oneOf.1","typeLabel":"null"}],"uniqueKey":"reasoning.effort","typeLabel":"enum\u003cstring> | null"},"summary":{"oneOf":[{"type":"string","enum":["auto","concise","detailed"],"description":"Fills the `reasoning` output item's `summary` with the model's reasoning text, and asks Claude for a summary of its thinking. Without it the item has an empty `summary`. Some models return no reasoning text even when asked.","uniqueKey":"reasoning.summary.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["auto","concise","detailed"],"description":"Fills the `reasoning` output item's `summary` with the model's reasoning text, and asks Claude for a summary of its thinking. Without it the item has an empty `summary`. Some models return no reasoning text even when asked.","uniqueKey":"reasoning.summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"reasoning.summary","typeLabel":"enum\u003cstring> | null"},"context":{"oneOf":[{"type":"string","description":"Accepted for client compatibility; not forwarded and has no effect.","uniqueKey":"reasoning.context.oneOf.0","typeLabel":"string"},{"type":"null","description":"Accepted for client compatibility; not forwarded and has no effect.","uniqueKey":"reasoning.context.oneOf.1","typeLabel":"null"}],"uniqueKey":"reasoning.context","typeLabel":"string | null"}},"uniqueKey":"reasoning","typeLabel":"object"},"parallel_tool_calls":{"type":"boolean","description":"Forwarded where the serving provider supports parallel function-tool controls.","uniqueKey":"parallel_tool_calls","typeLabel":"boolean"},"service_tier":{"oneOf":[{"type":"string","enum":["auto","default","ultrafast","fast"],"description":"Processing tier. Omitted, `null`, `auto` and `default` are standard processing at the model's normal rates. `ultrafast` is OpenAI's low-latency tier, available only for `openai/gpt-6-astra` and `openai/gpt-6.1-sol`: it is served only by OpenAI's own API (never another host, never a silent fallback to standard) and billed at Ultrafast rates. `fast` uses native Anthropic only for `anthropic/claude-opus-5-5` at Fast rates. `priority` and `flex` return 400. Same contract as on ChatCompletionRequest.","uniqueKey":"service_tier.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["auto","default","ultrafast","fast"],"description":"Processing tier. Omitted, `null`, `auto` and `default` are standard processing at the model's normal rates. `ultrafast` is OpenAI's low-latency tier, available only for `openai/gpt-6-astra` and `openai/gpt-6.1-sol`: it is served only by OpenAI's own API (never another host, never a silent fallback to standard) and billed at Ultrafast rates. `fast` uses native Anthropic only for `anthropic/claude-opus-5-5` at Fast rates. `priority` and `flex` return 400. Same contract as on ChatCompletionRequest.","uniqueKey":"service_tier.oneOf.1","typeLabel":"null"}],"uniqueKey":"service_tier","typeLabel":"enum\u003cstring> | null"},"tools":{"type":"array","description":"Function tools are relayed to your application. Native web_search and x_search execute only on supported xAI routes and are filtered out on other providers. Gateway-paid searches add $0.005 per invocation. A required tool choice with no executable tools returns 400.","items":{"oneOf":[{"type":"object","required":["type","name"],"properties":{"type":{"type":"string","const":"function","isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.0.type","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.0.name","typeLabel":"string"},"description":{"type":"string","uniqueKey":"tools.items.[INDEX].oneOf.0.description","typeLabel":"string"},"parameters":{"type":"object","description":"JSON Schema for the tool input.","uniqueKey":"tools.items.[INDEX].oneOf.0.parameters","typeLabel":"object"},"strict":{"type":"boolean","uniqueKey":"tools.items.[INDEX].oneOf.0.strict","typeLabel":"boolean"}},"uniqueKey":"tools.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"web_search","isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.1.type","typeLabel":"string"},"allowed_domains":{"type":"array","items":{"type":"string","uniqueKey":"tools.items.[INDEX].oneOf.1.allowed_domains.items.[INDEX]","typeLabel":"string"},"uniqueKey":"tools.items.[INDEX].oneOf.1.allowed_domains","typeLabel":"string[]"},"excluded_domains":{"type":"array","items":{"type":"string","uniqueKey":"tools.items.[INDEX].oneOf.1.excluded_domains.items.[INDEX]","typeLabel":"string"},"uniqueKey":"tools.items.[INDEX].oneOf.1.excluded_domains","typeLabel":"string[]"},"enable_image_understanding":{"type":"boolean","uniqueKey":"tools.items.[INDEX].oneOf.1.enable_image_understanding","typeLabel":"boolean"}},"uniqueKey":"tools.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"x_search","isRequired":true,"uniqueKey":"tools.items.[INDEX].oneOf.2.type","typeLabel":"string"},"allowed_x_handles":{"type":"array","items":{"type":"string","uniqueKey":"tools.items.[INDEX].oneOf.2.allowed_x_handles.items.[INDEX]","typeLabel":"string"},"uniqueKey":"tools.items.[INDEX].oneOf.2.allowed_x_handles","typeLabel":"string[]"},"excluded_x_handles":{"type":"array","items":{"type":"string","uniqueKey":"tools.items.[INDEX].oneOf.2.excluded_x_handles.items.[INDEX]","typeLabel":"string"},"uniqueKey":"tools.items.[INDEX].oneOf.2.excluded_x_handles","typeLabel":"string[]"},"from_date":{"type":"string","uniqueKey":"tools.items.[INDEX].oneOf.2.from_date","typeLabel":"string"},"to_date":{"type":"string","uniqueKey":"tools.items.[INDEX].oneOf.2.to_date","typeLabel":"string"},"enable_image_understanding":{"type":"boolean","uniqueKey":"tools.items.[INDEX].oneOf.2.enable_image_understanding","typeLabel":"boolean"},"enable_video_understanding":{"type":"boolean","uniqueKey":"tools.items.[INDEX].oneOf.2.enable_video_understanding","typeLabel":"boolean"}},"uniqueKey":"tools.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"tools.items.[INDEX]","typeLabel":"object"},"uniqueKey":"tools","typeLabel":"object[]"},"tool_choice":{"oneOf":[{"type":"string","description":"`auto`, `none`, `required`, or `{ type: function, name }`.","enum":["auto","none","required"],"uniqueKey":"tool_choice.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","description":"`auto`, `none`, `required`, or `{ type: function, name }`.","properties":{"type":{"type":"string","const":"function","uniqueKey":"tool_choice.oneOf.1.type","typeLabel":"string"},"name":{"type":"string","uniqueKey":"tool_choice.oneOf.1.name","typeLabel":"string"}},"uniqueKey":"tool_choice.oneOf.1","typeLabel":"object"}],"uniqueKey":"tool_choice","typeLabel":"enum\u003cstring> | object"},"cache_control":{"type":"object","description":"Request-level breakpoint; same contract as on ChatCompletionRequest. A per-part `cache_control` anywhere takes precedence and this is ignored.","required":["type"],"properties":{"type":{"type":"string","const":"ephemeral","isRequired":true,"uniqueKey":"cache_control.type","typeLabel":"string"},"ttl":{"type":"string","enum":["5m","1h"],"default":"5m","description":"Cache lifetime; one-hour writes use the higher published write rate.","uniqueKey":"cache_control.ttl","typeLabel":"enum\u003cstring>"}},"uniqueKey":"cache_control","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"model":"anthropic/claude-sonnet-4-5","input":"\u003cstring>","instructions":"\u003cstring>","stream":false,"temperature":123,"top_p":123,"max_output_tokens":123,"reasoning":{"context":"\u003cstring>"},"parallel_tool_calls":true,"tools":[{"type":"function","name":"\u003cstring>","description":"\u003cstring>","parameters":{},"strict":true}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"8925a183-64fb-40d4-9203-7b561eb63a95":{"description":"A `response` object. When `stream: true`, the body is instead an SSE\nstream of `response.*` semantic events ending with `response.completed`,\nor `response.incomplete` when generation stopped short (see `status`).\n","headers":{"x-impossibl-reasoning":{"description":"Sent when the request sets `reasoning.effort`, in the same format as on POST /v1/chat/completions: `requested=\u003clevel> applied=\u003csent> route=\u003cprovider>`.","schema":{"type":"string","example":"requested=xhigh applied=high route=anthropic"}}},"content":{"application/json":{"schema":{"type":"object","description":"Responses API object (`response`).","properties":{"id":{"type":"string","example":"resp_...","uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","const":"response","uniqueKey":"object","typeLabel":"string"},"created_at":{"type":"integer","uniqueKey":"created_at","typeLabel":"integer"},"status":{"type":"string","enum":["in_progress","completed","incomplete","failed"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"incomplete_details":{"type":"object","description":"Why generation stopped short. Present only when `status` is `incomplete`.","properties":{"reason":{"type":"string","enum":["max_output_tokens","content_filter"],"uniqueKey":"incomplete_details.reason","typeLabel":"enum\u003cstring>"}},"uniqueKey":"incomplete_details","typeLabel":"object"},"model":{"type":"string","uniqueKey":"model","typeLabel":"string"},"output_text":{"type":"string","description":"Convenience aggregation of the assistant text.","uniqueKey":"output_text","typeLabel":"string"},"output":{"type":"array","description":"Output items — a `reasoning` item first when the model reasoned, assistant `message` items and, on tool calls, `function_call` items.","items":{"type":"object","properties":{"type":{"type":"string","enum":["reasoning","message","function_call"],"uniqueKey":"output.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"id":{"type":"string","uniqueKey":"output.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","uniqueKey":"output.items.[INDEX].status","typeLabel":"string"},"role":{"type":"string","const":"assistant","description":"Present on `message` items.","uniqueKey":"output.items.[INDEX].role","typeLabel":"string"},"content":{"type":"array","description":"Present on `message` items.","items":{"type":"object","properties":{"type":{"type":"string","const":"output_text","uniqueKey":"output.items.[INDEX].content.items.[INDEX].type","typeLabel":"string"},"text":{"type":"string","uniqueKey":"output.items.[INDEX].content.items.[INDEX].text","typeLabel":"string"},"annotations":{"type":"array","items":{"type":"object","uniqueKey":"output.items.[INDEX].content.items.[INDEX].annotations.items.[INDEX]","typeLabel":"object"},"uniqueKey":"output.items.[INDEX].content.items.[INDEX].annotations","typeLabel":"object[]"}},"uniqueKey":"output.items.[INDEX].content.items.[INDEX]","typeLabel":"object"},"uniqueKey":"output.items.[INDEX].content","typeLabel":"object[]"},"call_id":{"type":"string","description":"Present on `function_call` items.","uniqueKey":"output.items.[INDEX].call_id","typeLabel":"string"},"name":{"type":"string","description":"Present on `function_call` items.","uniqueKey":"output.items.[INDEX].name","typeLabel":"string"},"arguments":{"type":"string","description":"Present on `function_call` items: JSON-encoded arguments string.","uniqueKey":"output.items.[INDEX].arguments","typeLabel":"string"},"summary":{"type":"array","description":"Present on `reasoning` items. Text only when the request set `reasoning.summary`; one part per reasoning block.","items":{"type":"object","properties":{"type":{"type":"string","const":"summary_text","uniqueKey":"output.items.[INDEX].summary.items.[INDEX].type","typeLabel":"string"},"text":{"type":"string","uniqueKey":"output.items.[INDEX].summary.items.[INDEX].text","typeLabel":"string"}},"uniqueKey":"output.items.[INDEX].summary.items.[INDEX]","typeLabel":"object"},"uniqueKey":"output.items.[INDEX].summary","typeLabel":"object[]"}},"uniqueKey":"output.items.[INDEX]","typeLabel":"object"},"uniqueKey":"output","typeLabel":"object[]"},"usage":{"type":"object","properties":{"input_tokens":{"type":"integer","uniqueKey":"usage.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","uniqueKey":"usage.output_tokens","typeLabel":"integer"},"total_tokens":{"type":"integer","uniqueKey":"usage.total_tokens","typeLabel":"integer"},"input_tokens_details":{"type":"object","description":"Present when cache-read usage is reported; a subset of input_tokens.","properties":{"cached_tokens":{"type":"integer","uniqueKey":"usage.input_tokens_details.cached_tokens","typeLabel":"integer"}},"uniqueKey":"usage.input_tokens_details","typeLabel":"object"},"output_tokens_details":{"type":"object","description":"Present when the backend reports a reasoning count; a subset of output_tokens.","properties":{"reasoning_tokens":{"type":"integer","uniqueKey":"usage.output_tokens_details.reasoning_tokens","typeLabel":"integer"}},"uniqueKey":"usage.output_tokens_details","typeLabel":"object"},"server_side_tool_calls":{"type":"integer","description":"Provider-executed search invocations, omitted when zero.","uniqueKey":"usage.server_side_tool_calls","typeLabel":"integer"}},"uniqueKey":"usage","typeLabel":"object"},"service_tier":{"oneOf":[{"type":"string","description":"Present only when the request set `service_tier`, on a completed or incomplete response (in a stream: the `response.completed` / `response.incomplete` event). Same contract as on ChatCompletion, including unknown reported strings and null.","uniqueKey":"service_tier.oneOf.0","typeLabel":"string"},{"type":"null","description":"Present only when the request set `service_tier`, on a completed or incomplete response (in a stream: the `response.completed` / `response.incomplete` event). Same contract as on ChatCompletion, including unknown reported strings and null.","uniqueKey":"service_tier.oneOf.1","typeLabel":"null"}],"uniqueKey":"service_tier","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"resp_...","object":"response","created_at":123,"status":"in_progress","incomplete_details":{"reason":"max_output_tokens"},"model":"\u003cstring>","output_text":"\u003cstring>","output":[{"type":"reasoning","id":"\u003cstring>","status":"\u003cstring>","role":"assistant","content":[{"type":"output_text","text":"\u003cstring>","annotations":[{}]}],"call_id":"\u003cstring>","name":"\u003cstring>","arguments":"\u003cstring>","summary":[{"type":"summary_text","text":"\u003cstring>"}]}],"usage":{"input_tokens":123,"output_tokens":123,"total_tokens":123,"input_tokens_details":{"cached_tokens":123},"output_tokens_details":{"reasoning_tokens":123},"server_side_tool_calls":123},"service_tier":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ac1fe674-6b55-455b-a1f2-52e2f903dd52":{"description":"Malformed request (bad JSON, or missing required fields).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Common types include authentication_error, invalid_request_error, insufficient_quota, billing_required, permission_error, upstream_error, and provider_not_configured.","uniqueKey":"error.type","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"`model` and `messages` are required","type":"invalid_request_error"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"`model` and `messages` are required","type":"invalid_request_error"}}}},"exampleType":"examples"}},"exampleType":"examples"},"01c26346-6c59-4130-8bdd-86a071dfd614":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Common types include authentication_error, invalid_request_error, insufficient_quota, billing_required, permission_error, upstream_error, and provider_not_configured.","uniqueKey":"error.type","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"Invalid API key","type":"authentication_error"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Invalid API key","type":"authentication_error"}}}},"exampleType":"examples"}},"exampleType":"examples"},"9921204f-a85f-489a-aca8-eeea6ac50a7e":{"description":"Available credits or postpaid headroom cannot cover the request's balance check, which can include estimated input cost. Top up or reduce the request size.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Common types include authentication_error, invalid_request_error, insufficient_quota, billing_required, permission_error, upstream_error, and provider_not_configured.","uniqueKey":"error.type","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"Insufficient credits. Top up to continue.","type":"insufficient_quota"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Insufficient credits. Top up to continue.","type":"insufficient_quota"}}}},"exampleType":"examples"}},"exampleType":"examples"},"b3d79436-decb-4da9-9fb5-35219baefca4":{"description":"The requested `model` id is not in the registry (see GET /v1/models).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Common types include authentication_error, invalid_request_error, insufficient_quota, billing_required, permission_error, upstream_error, and provider_not_configured.","uniqueKey":"error.type","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"Unknown model: foo/bar","type":"invalid_request_error"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Unknown model: foo/bar","type":"invalid_request_error"}}}},"exampleType":"examples"}},"exampleType":"examples"},"0f0e5251-cc96-49dd-bcfb-fd97c07e7de9":{"description":"The upstream provider returned an error.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Common types include authentication_error, invalid_request_error, insufficient_quota, billing_required, permission_error, upstream_error, and provider_not_configured.","uniqueKey":"error.type","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"permission-denied: ...","type":"upstream_error"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"permission-denied: ...","type":"upstream_error"}}}},"exampleType":"examples"}},"exampleType":"examples"},"fb8648bb-4e23-48b1-8f79-7d36a428e066":{"description":"The provider for this model has no API key configured on the gateway.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"Common types include authentication_error, invalid_request_error, insufficient_quota, billing_required, permission_error, upstream_error, and provider_not_configured.","uniqueKey":"error.type","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"message":"Provider not configured: missing OPENAI_API_KEY","type":"provider_not_configured"}},"examples":{"Example":{"title":"Example","value":{"error":{"message":"Provider not configured: missing OPENAI_API_KEY","type":"provider_not_configured"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"b9e249f0-508d-49aa-b644-e83d1e514b84":{"BearerKey":{"type":"http","scheme":"bearer","description":"Gateway API key (`imp-rt-...`) from POST /v1/accounts or /v1/keys.","scopes":[],"schemeName":"BearerKey"}}},"servers":{"56354270-4d43-4a36-9df8-087ce55ddbb8":{"url":"https://api.impossibl.com","description":"Production"},"b9326fa1-d188-49aa-a659-8ec127b80a40":{"url":"http://localhost:8787","description":"Local dev"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Gateway API key (`imp-rt-...`) from POST /v1/accounts or /v1/keys.","scopes":[],"schemeName":"BearerKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Gateway API key (`imp-rt-...`) from POST /v1/accounts or /v1/keys.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerKey","name":"Authorization"}],"title":"BearerKey"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"impossibl","siteName":"impossibl","title":"Create a response (OpenAI Responses API) - impossibl","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-16T00:28:49.679Z","originalFileLocation":"api-reference/create-a-response-openai-responses-api.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Implements OpenAI\u0026#x27;s Responses API for text. Set stream: true for semantic-event SSE.\">\u003cmeta data-mint-head name=\"application-name\" content=\"impossibl\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/impossibl/0tSg0CUa7jlGvPGO/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/impossibl/0tSg0CUa7jlGvPGO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/impossibl/0tSg0CUa7jlGvPGO/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/impossibl/0tSg0CUa7jlGvPGO/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/impossibl/0tSg0CUa7jlGvPGO/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/impossibl/0tSg0CUa7jlGvPGO/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/impossibl/0tSg0CUa7jlGvPGO/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/impossibl/0tSg0CUa7jlGvPGO/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/impossibl/0tSg0CUa7jlGvPGO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a response (OpenAI Responses API) - impossibl\">\u003cmeta data-mint-head property=\"og:description\" content=\"Implements OpenAI\u0026#x27;s Responses API for text. Set stream: true for semantic-event SSE.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"impossibl\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://impossibl.com/docs/api-reference/create-a-response-openai-responses-api\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://impossibl.com/opengraph-image\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a response (OpenAI Responses API) - impossibl\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Implements OpenAI\u0026#x27;s Responses API for text. Set stream: true for semantic-event SSE.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://impossibl.com/opengraph-image\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/impossibl/0tSg0CUa7jlGvPGO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"impossibl\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://impossibl.com/docs/api-reference/create-a-response-openai-responses-api\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/create-a-response-openai-responses-api.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://impossibl.com/#organization\",\"name\":\"impossibl\",\"url\":\"https://impossibl.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://impossibl.com/brand/impossibl-icon.png\"},\"sameAs\":[\"https://x.com/Impossiblai\",\"https://github.com/impossiblco\"]},{\"@type\":\"WebSite\",\"@id\":\"https://impossibl.com/docs#website\",\"name\":\"impossibl\",\"url\":\"https://impossibl.com/docs\",\"publisher\":{\"@id\":\"https://impossibl.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://impossibl.com/docs/api-reference/create-a-response-openai-responses-api#webpage\",\"url\":\"https://impossibl.com/docs/api-reference/create-a-response-openai-responses-api\",\"name\":\"Create a response (OpenAI Responses API)\",\"description\":\"Implements OpenAI's Responses API for text. Set stream: true for semantic-event SSE.\",\"dateModified\":\"2026-10-16T00:28:49.679Z\",\"isPartOf\":{\"@id\":\"https://impossibl.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://impossibl.com/docs/api-reference/create-a-response-openai-responses-api#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://impossibl.com/docs/api-reference/create-a-response-openai-responses-api#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://impossibl.com/docs/api-reference/complete-artificial-analysis-benchmark-snapshot-for-a-serving-model\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a response (OpenAI Responses API)\",\"item\":\"https://impossibl.com/docs/api-reference/create-a-response-openai-responses-api\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://impossibl.com/docs/api-reference/create-a-response-openai-responses-api#apireference\",\"headline\":\"Create a response (OpenAI Responses API)\",\"name\":\"Create a response (OpenAI Responses API)\",\"description\":\"Implements OpenAI's Responses API for text. Set stream: true for semantic-event SSE.\",\"url\":\"https://impossibl.com/docs/api-reference/create-a-response-openai-responses-api\",\"mainEntityOfPage\":{\"@id\":\"https://impossibl.com/docs/api-reference/create-a-response-openai-responses-api#webpage\"},\"image\":\"https://impossibl.com/opengraph-image\",\"dateModified\":\"2026-10-16T00:28:49.679Z\",\"publisher\":{\"@id\":\"https://impossibl.com/#organization\"},\"isPartOf\":{\"@id\":\"https://impossibl.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"impossibl\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"impossibl","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Complete Artificial Analysis benchmark snapshot for a serving model","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/models/{creator}/{model}/benchmarks","href":"/api-reference/complete-artificial-analysis-benchmark-snapshot-for-a-serving-model"},{"title":"Get executable agent onboarding manifest","deprecated":null,"version":null,"openapi":"/openapi.yaml get /auth.md","href":"/api-reference/get-executable-agent-onboarding-manifest"},{"title":"Get auth.md manifest from the well-known compatibility path","deprecated":null,"version":null,"openapi":"/openapi.yaml get /.well-known/auth.md","href":"/api-reference/get-authmd-manifest-from-the-well-known-compatibility-path"},{"title":"Get OAuth protected-resource metadata for agent discovery","deprecated":null,"version":null,"openapi":"/openapi.yaml get /.well-known/oauth-protected-resource","href":"/api-reference/get-oauth-protected-resource-metadata-for-agent-discovery"},{"title":"List available models and pricing","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/models","href":"/api-reference/list-available-models-and-pricing"},{"title":"Create a funded account (agent onboarding)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/accounts","href":"/api-reference/create-a-funded-account-agent-onboarding"},{"title":"Get the authenticated account and balance","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/account","href":"/api-reference/get-the-authenticated-account-and-balance"},{"title":"List API keys (metadata only)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/keys","href":"/api-reference/list-api-keys-metadata-only"},{"title":"Mint a new API key","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/keys","href":"/api-reference/mint-a-new-api-key"},{"title":"Revoke an API key","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/keys/{id}","href":"/api-reference/revoke-an-api-key"},{"title":"Rename an API key","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /v1/keys/{id}","href":"/api-reference/rename-an-api-key"},{"title":"List BYOK provider credentials (metadata only)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/provider-keys","href":"/api-reference/list-byok-provider-credentials-metadata-only"},{"title":"Add (or replace) a BYOK provider credential","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/provider-keys","href":"/api-reference/add-or-replace-a-byok-provider-credential"},{"title":"Revoke a BYOK provider credential","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /v1/provider-keys/{id}","href":"/api-reference/revoke-a-byok-provider-credential"},{"title":"Recent usage ledger","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/usage","href":"/api-reference/recent-usage-ledger"},{"title":"Live usage stream (SSE)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/usage/stream","href":"/api-reference/live-usage-stream-sse"},{"title":"Recent request log","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/requests","href":"/api-reference/recent-request-log"},{"title":"One request with its captured payload","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/requests/{id}","href":"/api-reference/one-request-with-its-captured-payload"},{"title":"Start a claim ceremony (hand the account to a human)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /agent/identity/claim","href":"/api-reference/start-a-claim-ceremony-hand-the-account-to-a-human"},{"title":"Poll a claim ceremony (claim grant)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /oauth2/token","href":"/api-reference/poll-a-claim-ceremony-claim-grant"},{"title":"Complete a claim (called by the frontend after WorkOS sign-in)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/claims/complete","href":"/api-reference/complete-a-claim-called-by-the-frontend-after-workos-sign-in"},{"title":"Current balance and top-up pricing","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/billing","href":"/api-reference/current-balance-and-top-up-pricing"},{"title":"Buy net credits with a hosted Stripe Invoice","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/billing/invoice","href":"/api-reference/buy-net-credits-with-a-hosted-stripe-invoice"},{"title":"Verify Stripe webhook and credit paid invoices","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/billing/webhook","href":"/api-reference/verify-stripe-webhook-and-credit-paid-invoices"},{"title":"Create a chat completion (OpenAI-compatible)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/chat/completions","href":"/api-reference/create-a-chat-completion-openai-compatible"},{"title":"Generate images (OpenAI-compatible)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/images/generations","href":"/api-reference/generate-images-openai-compatible"},{"title":"Transcribe a completed audio file","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/audio/transcriptions","href":"/api-reference/transcribe-a-completed-audio-file"},{"title":"Synthesize speech from text","description":"OpenAI-compatible text to speech. The response body is the raw audio.\n\n`voice` takes the provider's own voice ids, never OpenAI aliases; GET\n/v1/models lists the voices and endpoint for each speech model.\n\nFormats differ by model because the providers do. `xai/grok-voice-tts-1.0`\nencodes natively (mp3, wav, pcm) and bills $15.00 per 1M input characters,\ncapped at 15,000 characters per request. The two Gemini Flash TTS models,\n`google/gemini-3.8-flash-tts` and `google/gemini-3.1-flash-tts-preview`, emit\n24 kHz mono PCM only, so they serve wav (a header over that PCM) and pcm, and\nbill tokens at $1.00/1M in and $20.00/1M out.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/audio/speech","href":"/api-reference/synthesize-speech-from-text"},{"title":"Create a response (OpenAI Responses API)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/responses","href":"/api-reference/create-a-response-openai-responses-api"},{"title":"Create a message (Anthropic Messages API)","description":"Drop-in compatible with Anthropic's Messages API. Authenticate with `x-api-key` (or `Authorization: Bearer`). A bare model id like `claude-haiku-4-5` routes to Anthropic; use `provider/model` for others. Set `stream: true` for SSE.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/messages","href":"/api-reference/create-a-message-anthropic-messages-api"},{"title":"Create embeddings (OpenAI-compatible)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/embeddings","href":"/api-reference/create-embeddings-openai-compatible"},{"title":"Evaluate state against typed questions (TypeSafe System One)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/systemone","href":"/api-reference/evaluate-state-against-typed-questions-typesafe-system-one"},{"title":"Answer typed questions about an input (OpenAI Decisions)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/decisions","href":"/api-reference/answer-typed-questions-about-an-input-openai-decisions"},{"title":"Rerank documents by relevance","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/rerank","href":"/api-reference/rerank-documents-by-relevance"}]}]}]},"title":"Create a response (OpenAI Responses API) - impossibl","buildId":"dpl_DGmhKsAzJdVqypJzon18vViniWRY","deploymentId":"dpl_DGmhKsAzJdVqypJzon18vViniWRY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-2jF_ccbi.js","utils-NNMVb_sb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DdtBhtt6.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D1OxL5O8.js","snippetPresets-DDC-KAXp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BOnTqOyQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-EEWI6FIO.js","shallow-fGZcWzm2.js","getApiPlaygroundDisplay-B3B8qEvw.js","CodeSnippet-BG9nsSU4.js","CodeSnippets-BlRACLKl.js","Page-FtoC8lZ9.js","getPastedJson-COV-Kgnr.js","icon-BXu3lasn.js","MethodPill-DGMUqJKh.js","DuplicateIcon-JEUJDHz_.js","createIcon-BDFucJ34.js","DynamicMarkdown-34OtG_BH.js","SectionHeading-tBbRD59j.js","axios-vUo_bRtp.js","Markdown-SoRz2nk2.js","clsx-BOmkPVIU.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DN0dCbTw.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BcsLYcfW.js"]}