A Reflection API key, sent in the Authorization header as Bearer <API key>. Create a key for your project from the Reflection platform.
Path Parameters
model
string
required
The identifier of the model, as returned in the models list. An identifier that contains / may be sent without encoding the /.
Response
The model.
Describes a model offering that can be used with the API.
id
string
required
The model identifier, which can be referenced in the API endpoints.
object
enum<string>
required
The object type, which is always model.
Available options:
model
created
integer<int64>
required
The Unix timestamp (in seconds) when the model was published, or 0 if its publication time is not announced.
owned_by
string
required
The organization serving the model, which is always reflection.
shutdown_date
string | null
required
The date when the model will shut down, or null if not announced.
context_length
integer<int64>
The largest request the model supports, in tokens, counting the prompt and the generated output together. Omitted if not announced.
Required range: x >= 1
max_output_tokens
integer<int64>
The most tokens the model supports generating in response to one request. Omitted if not announced.
Required range: x >= 1
default_parameters
object
The sampling and output settings the model applies to your organization's chat completion requests; they can differ between organizations. A setting a request can send applies only when the request omits it or sets it to null. Settings not listed use the model's own defaults. Omitted if the model sets none.
Show child attributes
reasoning
object
The model's reasoning-effort configuration. Omitted if the model does not announce its supported efforts.
Show child attributes
max_top_logprobs
integer
The largest top_logprobs a chat completion request for this model accepts. Omitted if the model does not return log probabilities, in which case logprobs cannot be true.
Required range: 0 <= x <= 20
availability
string
restricted when your account can call this model, or see it listed, through access not all accounts have, such as early access. Omitted when all accounts have that access; its absence says nothing more. It describes your account at request time and can differ between accounts or change. More values may be added; read an unknown one as saying nothing.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Reflection Developer Docs","colors":{"primary":"#1e3207","light":"#bdc8b5","dark":"#1e3207"},"logo":{"light":"https://mintcdn.com/reflection-ai/QTuxzl6PxhZZjLhq/logo/light.svg?fit=max\u0026auto=format\u0026n=QTuxzl6PxhZZjLhq\u0026q=85\u0026s=58c942f905cb3bd4c0a14b113a3aee89","dark":"https://mintcdn.com/reflection-ai/QTuxzl6PxhZZjLhq/logo/dark.svg?fit=max\u0026auto=format\u0026n=QTuxzl6PxhZZjLhq\u0026q=85\u0026s=72f108f3de1233371ba966d2f4ff3754"},"favicon":{"light":"https://mintcdn.com/reflection-ai/JsnqP0KHndVcbl2Y/favicon-light.svg?fit=max\u0026auto=format\u0026n=JsnqP0KHndVcbl2Y\u0026q=85\u0026s=d06a05d3592404faa659b9776f0c897e","dark":"https://mintcdn.com/reflection-ai/JsnqP0KHndVcbl2Y/favicon-dark.svg?fit=max\u0026auto=format\u0026n=JsnqP0KHndVcbl2Y\u0026q=85\u0026s=890ef9e453a694b505f70db674199964"},"api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript"]}},"background":{"color":{"light":"#f8f6f0","dark":"#1a1b1a"}},"navbar":{"links":[{"href":"https://platform.reflection.ai","label":"Platform"},{"href":"https://status.reflection.ai","label":"Status"}],"primary":{"type":"button","label":"Get an API key","href":"https://platform.reflection.ai/api-keys"}},"footer":{"socials":{"github":"https://github.com/reflection-oss","discord":"https://discord.gg/GyNwCVQf6U"}},"fonts":{"heading":{"family":"NaN Serf Sans","weight":600,"source":"fonts/nan-serf-sans-600.woff2","format":"woff2"},"body":{"family":"Reflection Inter","source":"fonts/inter-400.woff2","format":"woff2"}},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"vitesse-light","dark":"vitesse-dark"}},"latex":false},"banner":{"content":"Beam 1.0 is out, with open weights, the Reflection API, and Mirror CLI (beta). [Read the announcement](https://reflection.ai/blog/beam-is-available)","dismissible":true},"errors":{"404":{"redirect":false,"title":"Page not found","description":"This page may have moved. Search the docs, or start from the [home page](/introduction), the [API quickstart](/quickstart), or the [Mirror quickstart](/coding-agents-quickstart)."}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"preset":"headline","surface":"brand","fonts":{"family":"NaN Serf Sans","source":"fonts/nan-serf-sans-600.woff","format":"woff"},"eyebrow":{"source":"tab","style":"bar","color":"#1e3207"}},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"reflection-ai","hasAudioNarration":false,"actualSubdomain":"reflection-ai","customDomains":["developers.reflection.ai"],"gitSource":{"type":"github","owner":"reflectionai","repo":"developer-docs-web","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe4ffa10e1e2399676d0f5","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API","count":17},{"language":"default","tag":"Deployment","count":14},{"language":"default","tag":"Customization","count":13},{"language":"default","tag":"Self-hosting","count":11},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Get started","count":8},{"language":"default","tag":"Mirror","count":8},{"language":"default","tag":"Supervised fine-tuning","count":7},{"language":"default","tag":"Integration stacks","count":7},{"language":"default","tag":"Safety","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"fonts.css","content":"@font-face{font-family:\"Reflection Inter\";font-style:normal;font-weight:500;font-display:swap;src:url(\"/fonts/inter-500.woff2\") format(\"woff2\")}@font-face{font-family:\"Reflection Inter\";font-style:normal;font-weight:600;font-display:swap;src:url(\"/fonts/inter-600.woff2\") format(\"woff2\")}@font-face{font-family:\"NaN Serf Sans\";font-style:normal;font-weight:500;font-display:swap;src:url(\"/fonts/nan-serf-sans-500.woff2\") format(\"woff2\")}"},{"filePath":"callout-tables.css","content":"#content-area [data-component-part=\"callout-content\"]>[data-component-part=\"scroll-area\"]:first-child{margin-top:0!important;padding-top:0!important}#content-area [data-component-part=\"callout-content\"]>[data-component-part=\"scroll-area\"]:last-child{margin-bottom:0!important;padding-bottom:0!important}#content-area thead:not(:has(th:not(:empty))){display:none}"},{"filePath":"code-links.css","content":"#content-area a.link:has(>code){border-bottom-width:0!important}#content-area a.link>code{text-decoration-line:underline!important;text-decoration-thickness:1px!important;text-decoration-color:rgb(var(--primary))!important;text-underline-offset:3px!important}.dark #content-area a.link>code{text-decoration-color:rgb(var(--primary-light))!important}#content-area [data-component-part=\"callout-content\"] a.link>code{text-decoration-color:currentcolor!important}"}]}
{"page":{"pagePath":"api-reference/models/retrieve-a-model","slug":"/api-reference/models/retrieve-a-model","pageMetadata":{"title":"Retrieve a model","description":"Retrieves one model by its identifier, with the same information the models list returns for it.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /openai/v1/models/{model}","href":"/api-reference/models/retrieve-a-model","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Retrieves one model by its identifier, with the same information the models list returns for it.\"\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":{"codeStyling":{"theme":{"light":"vitesse-light","dark":"vitesse-dark"}},"config":{},"pageMetadata":{"title":"Retrieve a model","description":"Retrieves one model by its identifier, with the same information the models list returns for it.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /openai/v1/models/{model}","href":"/api-reference/models/retrieve-a-model","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"retrieveModel","tags":["Models"],"summary":"Retrieve a model","description":"Retrieves one model by its identifier, with the same information the models list returns for it.","parameters":["be20268c-1107-4a55-8a1f-c42b11b53c85"],"responses":{"200":"2691b9d2-e712-4045-9aa7-375037e44121","401":"97b445f4-1245-40b1-a3b4-01394ae8c476","403":"ac84f8a6-3ea6-4015-b26e-e7eac1186469","404":"6ff849d8-2edb-4a2e-a540-8dc7b22d51a7","429":"8f78544e-aeab-40ee-80a7-a4a86f2d114d","503":"83618432-4e65-4035-ade4-e269c3f38fb1"},"method":"get","type":"path","servers":["06dba7d4-d34c-4888-838a-31b42336a636"],"security":["df4379af-026b-47b4-ad0b-01ad4ab1b74f","bf6175a3-32cb-43d7-b329-8ee22d5b6c9c"],"path":"/openai/v1/models/{model}","baseUrlOptions":["https://api.reflection.ai"],"title":"Retrieve a model","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"be20268c-1107-4a55-8a1f-c42b11b53c85":{"in":"path","name":"model","required":true,"description":"The identifier of the model, as returned in the models list. An identifier that contains `/` may be sent without encoding the `/`.","schema":{"type":"string","isRequired":true,"description":"The identifier of the model, as returned in the models list. An identifier that contains `/` may be sent without encoding the `/`.","uniqueKey":"","typeLabel":"string"},"example":"Beam-1.0-501B-A23B"}},"responses":{"2691b9d2-e712-4045-9aa7-375037e44121":{"description":"The model.","headers":{"x-request-id":{"description":"A unique identifier the server assigns to this request. Include it when contacting support. A request ID you send is not reused.","schema":{"type":"string","format":"uuid"},"example":"7c9e6679-7425-40de-944b-e07fc1f90ae7"},"reflection-data-retention":{"description":"The data retention the request was served under: `standard`, `zero` or `contributor`.","schema":{"type":"string","enum":["standard","zero","contributor"]},"example":"zero"},"x-ratelimit-limit-requests":{"description":"The most requests the organization may use per minute.","schema":{"type":"integer","format":"int64","minimum":0},"example":600},"x-ratelimit-remaining-requests":{"description":"The requests left in the per-minute capacity, rounded down. Reflects this request when it was admitted; a rejected request uses none.","schema":{"type":"integer","format":"int64","minimum":0},"example":599},"x-ratelimit-reset-requests":{"description":"The time until the per-minute capacity is fully replenished if no further requests are used, as seconds with up to millisecond precision and an `s` suffix. Not a retry delay; see `Retry-After`.","schema":{"type":"string"},"example":"0.1s"},"x-ratelimit-limit-requests-day":{"description":"The most requests the organization may use per UTC calendar day.","schema":{"type":"integer","format":"int64","minimum":0},"example":100000},"x-ratelimit-remaining-requests-day":{"description":"The requests left in today's UTC calendar-day capacity, rounded down. Reflects this request when it was admitted; a rejected request uses none.","schema":{"type":"integer","format":"int64","minimum":0},"example":99412},"x-ratelimit-reset-requests-day":{"description":"The time until the next UTC midnight, when the daily count resets, as seconds with up to millisecond precision and an `s` suffix. Not a retry delay; see `Retry-After`.","schema":{"type":"string"},"example":"43200s"}},"content":{"application/json":{"schema":{"type":"object","description":"Describes a model offering that can be used with the API.","required":["id","object","created","owned_by","shutdown_date"],"properties":{"id":{"type":"string","description":"The model identifier, which can be referenced in the API endpoints.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","enum":["model"],"description":"The object type, which is always `model`.","isRequired":true,"uniqueKey":"object","typeLabel":"enum\u003cstring>"},"created":{"type":"integer","format":"int64","description":"The Unix timestamp (in seconds) when the model was published, or 0 if its publication time is not announced.","isRequired":true,"uniqueKey":"created","typeLabel":"integer\u003cint64>"},"owned_by":{"type":"string","description":"The organization serving the model, which is always `reflection`.","isRequired":true,"uniqueKey":"owned_by","typeLabel":"string"},"shutdown_date":{"oneOf":[{"type":"string","description":"The date when the model will shut down, or null if not announced.","isRequired":true,"uniqueKey":"shutdown_date.oneOf.0","typeLabel":"string"},{"type":"null","description":"The date when the model will shut down, or null if not announced.","isRequired":true,"uniqueKey":"shutdown_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"shutdown_date","typeLabel":"string | null"},"context_length":{"type":"integer","format":"int64","minimum":1,"description":"The largest request the model supports, in tokens, counting the prompt and the generated output together. Omitted if not announced.","uniqueKey":"context_length","typeLabel":"integer\u003cint64>"},"max_output_tokens":{"type":"integer","format":"int64","minimum":1,"description":"The most tokens the model supports generating in response to one request. Omitted if not announced.","uniqueKey":"max_output_tokens","typeLabel":"integer\u003cint64>"},"default_parameters":{"type":"object","description":"The sampling and output settings the model applies to your organization's chat completion requests; they can differ between organizations. A setting a request can send applies only when the request omits it or sets it to null. Settings not listed use the model's own defaults. Omitted if the model sets none.","properties":{"temperature":{"type":"number","minimum":0,"maximum":2,"description":"The `temperature` applied when a request omits it or sets it to null.","uniqueKey":"default_parameters.temperature","typeLabel":"number"},"top_p":{"type":"number","minimum":0,"maximum":1,"description":"The `top_p` applied when a request omits it or sets it to null.","uniqueKey":"default_parameters.top_p","typeLabel":"number"},"frequency_penalty":{"type":"number","minimum":-2,"maximum":2,"description":"The `frequency_penalty` applied when a request omits it or sets it to null.","uniqueKey":"default_parameters.frequency_penalty","typeLabel":"number"},"presence_penalty":{"type":"number","minimum":-2,"maximum":2,"description":"The `presence_penalty` applied when a request omits it or sets it to null.","uniqueKey":"default_parameters.presence_penalty","typeLabel":"number"},"max_tokens":{"type":"integer","minimum":1,"description":"The output budget, reasoning tokens included, applied when a request sets neither `max_tokens` nor `max_completion_tokens`, or sets them to null. Without it, the model's own limits apply. A request with `logprobs` true receives at most 8,192.","uniqueKey":"default_parameters.max_tokens","typeLabel":"integer"},"top_k":{"type":"integer","minimum":1,"description":"How many of the most likely tokens the model samples from. Applied to every request; a chat completion request cannot set it.","uniqueKey":"default_parameters.top_k","typeLabel":"integer"},"min_p":{"type":"number","minimum":0,"maximum":1,"description":"The smallest probability, relative to the most likely token, that a token needs to be sampled. Applied to every request; a chat completion request cannot set it.","uniqueKey":"default_parameters.min_p","typeLabel":"number"},"repetition_penalty":{"type":"number","exclusiveMinimum":true,"minimum":0,"maximum":2,"description":"How strongly the model avoids repeating tokens: 1 applies no penalty, and higher values penalize repetition more. Applied to every request; a chat completion request cannot set it.","uniqueKey":"default_parameters.repetition_penalty","typeLabel":"number"}},"uniqueKey":"default_parameters","typeLabel":"object"},"reasoning":{"type":"object","description":"The model's reasoning-effort configuration. Omitted if the model does not announce its supported efforts.","required":["supported_efforts","mandatory"],"properties":{"supported_efforts":{"type":"array","minItems":1,"description":"The `reasoning_effort` values the model accepts, highest effort first. A chat completion request for this model accepts no other value.","items":{"type":"string","enum":["max","xhigh","high","medium","low"],"uniqueKey":"reasoning.supported_efforts.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"reasoning.supported_efforts","typeLabel":"enum\u003cstring>[]"},"mandatory":{"type":"boolean","description":"Whether reasoning is always on. When true, no `reasoning_effort` value disables reasoning.","isRequired":true,"uniqueKey":"reasoning.mandatory","typeLabel":"boolean"},"default_effort":{"type":"string","enum":["max","xhigh","high","medium","low"],"description":"The effort applied to your organization's requests that omit `reasoning_effort` or set it to null; it can differ between organizations. Omitted if the model chooses its own.","uniqueKey":"reasoning.default_effort","typeLabel":"enum\u003cstring>"}},"uniqueKey":"reasoning","typeLabel":"object"},"max_top_logprobs":{"type":"integer","minimum":0,"maximum":20,"description":"The largest `top_logprobs` a chat completion request for this model accepts. Omitted if the model does not return log probabilities, in which case `logprobs` cannot be true.","uniqueKey":"max_top_logprobs","typeLabel":"integer"},"availability":{"type":"string","description":"`restricted` when your account can call this model, or see it listed, through access not all accounts have, such as early access. Omitted when all accounts have that access; its absence says nothing more. It describes your account at request time and can differ between accounts or change. More values may be added; read an unknown one as saying nothing.","uniqueKey":"availability","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Model":{"title":"Model","summary":"Model","value":{"id":"Beam-1.0-501B-A23B","object":"model","created":1791158400,"owned_by":"reflection","shutdown_date":null,"context_length":1048576,"max_output_tokens":131072,"default_parameters":{"max_tokens":32768},"reasoning":{"supported_efforts":["max","xhigh","high","medium","low"],"default_effort":"max","mandatory":true}}}},"exampleType":"examples"}},"exampleType":"examples"},"97b445f4-1245-40b1-a3b4-01394ae8c476":{"description":"The credential is missing, malformed, or not valid. Correct the credential before retrying.","headers":{"x-request-id":{"description":"A unique identifier the server assigns to this request. Include it when contacting support. A request ID you send is not reused.","schema":{"type":"string","format":"uuid"},"example":"7c9e6679-7425-40de-944b-e07fc1f90ae7"}},"content":{"application/json":{"schema":{"type":"object","description":"The body returned with every error status.","required":["error"],"properties":{"error":{"type":"object","description":"An error returned by the API.","required":["message","type","param","code"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"The error category, such as `invalid_request_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"The request parameter the error relates to, or null.","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request parameter the error relates to, or null.","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"A machine-readable error code, or null.","isRequired":true,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"A machine-readable error code, or null.","isRequired":true,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Invalid API key":{"title":"Invalid API key","summary":"Invalid API key","value":{"error":{"message":"Incorrect API key provided. The key may have been revoked or expired.","type":"authentication_error","param":null,"code":"invalid_api_key"}}},"Missing credential":{"title":"Missing credential","summary":"Missing credential","value":{"error":{"message":"Provide an API key or Playground credential in the Authorization header.","type":"authentication_error","param":null,"code":"missing_credentials"}}},"Malformed Authorization header":{"title":"Malformed Authorization header","summary":"Malformed Authorization header","value":{"error":{"message":"The Authorization header must be of the form 'Bearer \u003cAPI key>'.","type":"authentication_error","param":null,"code":"invalid_authorization_header"}}},"Expired Playground credential":{"title":"Expired Playground credential","summary":"Expired Playground credential","value":{"error":{"message":"The Playground credential is unknown or expired. Retry from the Playground.","type":"authentication_error","param":null,"code":"invalid_playground_credential"}}}},"exampleType":"examples"}},"exampleType":"examples"},"ac84f8a6-3ea6-4015-b26e-e7eac1186469":{"description":"The credential is valid, but the request is not allowed: the account awaits platform access or has not finished registration, the caller is not an active organization member, an access restriction applies, or the plan excludes this kind of credential. Retry only after the cause is resolved.","headers":{"x-request-id":{"description":"A unique identifier the server assigns to this request. Include it when contacting support. A request ID you send is not reused.","schema":{"type":"string","format":"uuid"},"example":"7c9e6679-7425-40de-944b-e07fc1f90ae7"},"reflection-data-retention":{"description":"The data retention the request was served under: `standard`, `zero` or `contributor`.","schema":{"type":"string","enum":["standard","zero","contributor"]},"example":"zero"}},"content":{"application/json":{"schema":{"type":"object","description":"The body returned with every error status.","required":["error"],"properties":{"error":{"type":"object","description":"An error returned by the API.","required":["message","type","param","code"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"The error category, such as `invalid_request_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"The request parameter the error relates to, or null.","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request parameter the error relates to, or null.","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"A machine-readable error code, or null.","isRequired":true,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"A machine-readable error code, or null.","isRequired":true,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Credential not in plan":{"title":"Credential not in plan","summary":"Credential not in plan","value":{"error":{"message":"Your organization's plan does not include access with this kind of credential.","type":"permission_error","param":null,"code":"plan_access_denied"}}},"Waiting for platform access":{"title":"Waiting for platform access","summary":"Waiting for platform access","value":{"error":{"message":"Your account is waiting for platform access.","type":"permission_error","param":null,"code":"platform_access_required"}}},"Registration unfinished":{"title":"Registration unfinished","summary":"Registration unfinished","value":{"error":{"message":"Complete registration before using the Playground.","type":"permission_error","param":null,"code":"onboarding_pending"}}},"Not an organization member":{"title":"Not an organization member","summary":"Not an organization member","value":{"error":{"message":"You are not an active member of the credential's organization.","type":"permission_error","param":null,"code":"organization_membership_required"}}},"Account restricted":{"title":"Account restricted","summary":"Account restricted","value":{"error":{"message":"This account is restricted from using the API.","type":"permission_error","param":null,"code":"account_restricted"}}}},"exampleType":"examples"}},"exampleType":"examples"},"6ff849d8-2edb-4a2e-a540-8dc7b22d51a7":{"description":"The requested model does not exist or is not available to you. Choose a model from the models list before retrying.","headers":{"x-request-id":{"description":"A unique identifier the server assigns to this request. Include it when contacting support. A request ID you send is not reused.","schema":{"type":"string","format":"uuid"},"example":"7c9e6679-7425-40de-944b-e07fc1f90ae7"},"reflection-data-retention":{"description":"The data retention the request was served under: `standard`, `zero` or `contributor`.","schema":{"type":"string","enum":["standard","zero","contributor"]},"example":"zero"},"x-ratelimit-limit-requests":{"description":"The most requests the organization may use per minute.","schema":{"type":"integer","format":"int64","minimum":0},"example":600},"x-ratelimit-remaining-requests":{"description":"The requests left in the per-minute capacity, rounded down. Reflects this request when it was admitted; a rejected request uses none.","schema":{"type":"integer","format":"int64","minimum":0},"example":599},"x-ratelimit-reset-requests":{"description":"The time until the per-minute capacity is fully replenished if no further requests are used, as seconds with up to millisecond precision and an `s` suffix. Not a retry delay; see `Retry-After`.","schema":{"type":"string"},"example":"0.1s"},"x-ratelimit-limit-requests-day":{"description":"The most requests the organization may use per UTC calendar day.","schema":{"type":"integer","format":"int64","minimum":0},"example":100000},"x-ratelimit-remaining-requests-day":{"description":"The requests left in today's UTC calendar-day capacity, rounded down. Reflects this request when it was admitted; a rejected request uses none.","schema":{"type":"integer","format":"int64","minimum":0},"example":99412},"x-ratelimit-reset-requests-day":{"description":"The time until the next UTC midnight, when the daily count resets, as seconds with up to millisecond precision and an `s` suffix. Not a retry delay; see `Retry-After`.","schema":{"type":"string"},"example":"43200s"}},"content":{"application/json":{"schema":{"type":"object","description":"The body returned with every error status.","required":["error"],"properties":{"error":{"type":"object","description":"An error returned by the API.","required":["message","type","param","code"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"The error category, such as `invalid_request_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"The request parameter the error relates to, or null.","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request parameter the error relates to, or null.","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"A machine-readable error code, or null.","isRequired":true,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"A machine-readable error code, or null.","isRequired":true,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Unknown model":{"title":"Unknown model","summary":"Unknown model","value":{"error":{"message":"The model [reflection-large] you requested is unavailable.","type":"invalid_request_error","param":"model","code":"model_not_found"}}}},"exampleType":"examples"}},"exampleType":"examples"},"8f78544e-aeab-40ee-80a7-a4a86f2d114d":{"description":"The request was rejected because a rate limit was exceeded. Wait for the number of seconds in `Retry-After`, when present, then retry. A spent daily request limit also sends `x-should-retry: false`: it resets at 00:00 UTC.","headers":{"Retry-After":{"description":"The minimum number of seconds to wait before retrying. Omitted when no retry delay is known.","schema":{"type":"integer","minimum":1}},"x-should-retry":{"description":"`false` when the organization's daily request limit is spent. Do not retry automatically: `Retry-After` then gives the seconds until it resets at 00:00 UTC. Browsers may read it.","schema":{"type":"string","enum":["false"]}},"x-request-id":{"description":"A unique identifier the server assigns to this request. Include it when contacting support. A request ID you send is not reused.","schema":{"type":"string","format":"uuid"},"example":"7c9e6679-7425-40de-944b-e07fc1f90ae7"},"reflection-data-retention":{"description":"The data retention the request was served under: `standard`, `zero` or `contributor`.","schema":{"type":"string","enum":["standard","zero","contributor"]},"example":"zero"},"x-ratelimit-limit-requests":{"description":"The most requests the organization may use per minute.","schema":{"type":"integer","format":"int64","minimum":0},"example":600},"x-ratelimit-remaining-requests":{"description":"The requests left in the per-minute capacity, rounded down. Reflects this request when it was admitted; a rejected request uses none.","schema":{"type":"integer","format":"int64","minimum":0},"example":599},"x-ratelimit-reset-requests":{"description":"The time until the per-minute capacity is fully replenished if no further requests are used, as seconds with up to millisecond precision and an `s` suffix. Not a retry delay; see `Retry-After`.","schema":{"type":"string"},"example":"0.1s"},"x-ratelimit-limit-requests-day":{"description":"The most requests the organization may use per UTC calendar day.","schema":{"type":"integer","format":"int64","minimum":0},"example":100000},"x-ratelimit-remaining-requests-day":{"description":"The requests left in today's UTC calendar-day capacity, rounded down. Reflects this request when it was admitted; a rejected request uses none.","schema":{"type":"integer","format":"int64","minimum":0},"example":99412},"x-ratelimit-reset-requests-day":{"description":"The time until the next UTC midnight, when the daily count resets, as seconds with up to millisecond precision and an `s` suffix. Not a retry delay; see `Retry-After`.","schema":{"type":"string"},"example":"43200s"}},"content":{"application/json":{"schema":{"type":"object","description":"The body returned with every error status.","required":["error"],"properties":{"error":{"type":"object","description":"An error returned by the API.","required":["message","type","param","code"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"The error category, such as `invalid_request_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"The request parameter the error relates to, or null.","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request parameter the error relates to, or null.","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"A machine-readable error code, or null.","isRequired":true,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"A machine-readable error code, or null.","isRequired":true,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Request rate limit":{"title":"Request rate limit","summary":"Request rate limit","value":{"error":{"message":"Your organization has reached its request limit. Retry after the indicated delay. View your usage and billing here: https://platform.reflection.ai/billing","type":"rate_limit_error","param":null,"code":"rate_limit_exceeded"}}},"Daily request limit":{"title":"Daily request limit","summary":"Daily request limit","value":{"error":{"message":"Your organization has reached its daily request limit. It resets at 00:00 UTC. View your usage and billing here: https://platform.reflection.ai/billing","type":"rate_limit_error","param":null,"code":"rate_limit_exceeded"}}}},"exampleType":"examples"}},"exampleType":"examples"},"83618432-4e65-4035-ade4-e269c3f38fb1":{"description":"The service is temporarily unavailable. The request may be retried, after the number of seconds in `Retry-After` when present.","headers":{"Retry-After":{"description":"The minimum number of seconds to wait before retrying. Sent when a check the request depends on cannot answer; omitted with `model_availability_unavailable`.","schema":{"type":"integer","minimum":1}},"x-request-id":{"description":"A unique identifier the server assigns to this request. Include it when contacting support. A request ID you send is not reused.","schema":{"type":"string","format":"uuid"},"example":"7c9e6679-7425-40de-944b-e07fc1f90ae7"},"reflection-data-retention":{"description":"The data retention the request was served under: `standard`, `zero` or `contributor`.","schema":{"type":"string","enum":["standard","zero","contributor"]},"example":"zero"},"x-ratelimit-limit-requests":{"description":"The most requests the organization may use per minute.","schema":{"type":"integer","format":"int64","minimum":0},"example":600},"x-ratelimit-remaining-requests":{"description":"The requests left in the per-minute capacity, rounded down. Reflects this request when it was admitted; a rejected request uses none.","schema":{"type":"integer","format":"int64","minimum":0},"example":599},"x-ratelimit-reset-requests":{"description":"The time until the per-minute capacity is fully replenished if no further requests are used, as seconds with up to millisecond precision and an `s` suffix. Not a retry delay; see `Retry-After`.","schema":{"type":"string"},"example":"0.1s"},"x-ratelimit-limit-requests-day":{"description":"The most requests the organization may use per UTC calendar day.","schema":{"type":"integer","format":"int64","minimum":0},"example":100000},"x-ratelimit-remaining-requests-day":{"description":"The requests left in today's UTC calendar-day capacity, rounded down. Reflects this request when it was admitted; a rejected request uses none.","schema":{"type":"integer","format":"int64","minimum":0},"example":99412},"x-ratelimit-reset-requests-day":{"description":"The time until the next UTC midnight, when the daily count resets, as seconds with up to millisecond precision and an `s` suffix. Not a retry delay; see `Retry-After`.","schema":{"type":"string"},"example":"43200s"}},"content":{"application/json":{"schema":{"type":"object","description":"The body returned with every error status.","required":["error"],"properties":{"error":{"type":"object","description":"An error returned by the API.","required":["message","type","param","code"],"properties":{"message":{"type":"string","description":"A human-readable description of the error.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","description":"The error category, such as `invalid_request_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"The request parameter the error relates to, or null.","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request parameter the error relates to, or null.","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","description":"A machine-readable error code, or null.","isRequired":true,"uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","description":"A machine-readable error code, or null.","isRequired":true,"uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Rate limiting unavailable":{"title":"Rate limiting unavailable","summary":"Rate limiting unavailable","value":{"error":{"message":"Rate limiting is temporarily unavailable. Retry the request.","type":"api_error","param":null,"code":"rate_limit_unavailable"}}},"Model availability check unavailable":{"title":"Model availability check unavailable","summary":"Model availability check unavailable","value":{"error":{"message":"Model availability is temporarily unavailable.","type":"api_error","param":null,"code":"model_availability_unavailable"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"df4379af-026b-47b4-ad0b-01ad4ab1b74f":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"Reflection API key","description":"A Reflection API key, sent in the `Authorization` header as `Bearer \u003cAPI key>`. Create a key for your project from the [Reflection platform](https://platform.reflection.ai/api-keys).","scopes":[],"schemeName":"apiKey"}},"bf6175a3-32cb-43d7-b329-8ee22d5b6c9c":{"playgroundCredential":{"type":"http","scheme":"bearer","bearerFormat":"Reflection Playground credential","description":"A short-lived, project-scoped credential that the Reflection Playground issues to itself while you use it. It is not meant for direct use; send an API key instead.","scopes":[],"schemeName":"playgroundCredential"}}},"servers":{"06dba7d4-d34c-4888-838a-31b42336a636":{"url":"https://api.reflection.ai","description":"The Reflection API."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"Reflection API key","description":"A Reflection API key, sent in the `Authorization` header as `Bearer \u003cAPI key>`. Create a key for your project from the [Reflection platform](https://platform.reflection.ai/api-keys).","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A Reflection API key, sent in the `Authorization` header as `Bearer \u003cAPI key>`. Create a key for your project from the [Reflection platform](https://platform.reflection.ai/api-keys).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"Reflection Playground credential","description":"A short-lived, project-scoped credential that the Reflection Playground issues to itself while you use it. It is not meant for direct use; send an API key instead.","scopes":[],"schemeName":"playgroundCredential"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A short-lived, project-scoped credential that the Reflection Playground issues to itself while you use it. It is not meant for direct use; send an API key instead.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"playgroundCredential","name":"Authorization"}],"title":"playgroundCredential"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"reflection-ai","siteName":"Reflection Developer Docs","title":"Retrieve a model - Reflection Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/models/retrieve-a-model.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=\"Retrieves one model by its identifier, with the same information the models list returns for it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Reflection Developer Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/reflection-ai/jwXyL2gkH91EW3EL/_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=\"/mintlify-assets/_mintlify/favicons/reflection-ai/jwXyL2gkH91EW3EL/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/reflection-ai/jwXyL2gkH91EW3EL/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/reflection-ai/jwXyL2gkH91EW3EL/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/reflection-ai/jwXyL2gkH91EW3EL/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/reflection-ai/jwXyL2gkH91EW3EL/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/reflection-ai/jwXyL2gkH91EW3EL/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/reflection-ai/jwXyL2gkH91EW3EL/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/reflection-ai/jwXyL2gkH91EW3EL/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve a model - Reflection Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves one model by its identifier, with the same information the models list returns for it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Reflection Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.reflection.ai/api-reference/models/retrieve-a-model\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://reflection-ai.mintlify.site/_mintlify/api/og/v2?division=API\u0026amp;title=Retrieve+a+model\u0026amp;description=Retrieves+one+model+by+its+identifier%2C+with+the+same+information+the+models+list+returns+for+it.\u0026amp;theme=042e12ebdcff97fefb737062\u0026amp;signature=58707dde0c036385f89deaa531f2b6d9a7e4847f244c64f806c7a46a933cbc89\">\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=\"Retrieve a model - Reflection Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves one model by its identifier, with the same information the models list returns for it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://reflection-ai.mintlify.site/_mintlify/api/og/v2?division=API\u0026amp;title=Retrieve+a+model\u0026amp;description=Retrieves+one+model+by+its+identifier%2C+with+the+same+information+the+models+list+returns+for+it.\u0026amp;theme=042e12ebdcff97fefb737062\u0026amp;signature=58707dde0c036385f89deaa531f2b6d9a7e4847f244c64f806c7a46a933cbc89\">\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=\"/mintlify-assets/_mintlify/favicons/reflection-ai/jwXyL2gkH91EW3EL/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Reflection Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1e3207\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.reflection.ai/api-reference/models/retrieve-a-model\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/models/retrieve-a-model.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.reflection.ai/#organization\",\"name\":\"Reflection Developer Docs\",\"url\":\"https://developers.reflection.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/reflection-ai/QTuxzl6PxhZZjLhq/logo/light.svg?fit=max\u0026auto=format\u0026n=QTuxzl6PxhZZjLhq\u0026q=85\u0026s=58c942f905cb3bd4c0a14b113a3aee89\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.reflection.ai#website\",\"name\":\"Reflection Developer Docs\",\"url\":\"https://developers.reflection.ai\",\"publisher\":{\"@id\":\"https://developers.reflection.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.reflection.ai/api-reference/models/retrieve-a-model#webpage\",\"url\":\"https://developers.reflection.ai/api-reference/models/retrieve-a-model\",\"name\":\"Retrieve a model\",\"description\":\"Retrieves one model by its identifier, with the same information the models list returns for it.\",\"isPartOf\":{\"@id\":\"https://developers.reflection.ai#website\"},\"breadcrumb\":{\"@id\":\"https://developers.reflection.ai/api-reference/models/retrieve-a-model#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.reflection.ai/api-reference/models/retrieve-a-model#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://developers.reflection.ai/api-reference/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Models\",\"item\":\"https://developers.reflection.ai/api-reference/models/list-models\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Retrieve a model\",\"item\":\"https://developers.reflection.ai/api-reference/models/retrieve-a-model\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.reflection.ai/api-reference/models/retrieve-a-model#apireference\",\"headline\":\"Retrieve a model\",\"name\":\"Retrieve a model\",\"description\":\"Retrieves one model by its identifier, with the same information the models list returns for it.\",\"url\":\"https://developers.reflection.ai/api-reference/models/retrieve-a-model\",\"mainEntityOfPage\":{\"@id\":\"https://developers.reflection.ai/api-reference/models/retrieve-a-model#webpage\"},\"publisher\":{\"@id\":\"https://developers.reflection.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.reflection.ai#website\"}}]}\u003c/script>","agentPointerHref":"/api-reference/models/retrieve-a-model.md","siteName":"Reflection Developer Docs","nav":{"global":null,"tabs":[{"tab":"Home","icon":"house","pages":[{"title":"Home","href":"/introduction"}]},{"tab":"API","icon":"code","groups":[{"group":"Get started","pages":[{"title":"Reflection API overview","sidebarTitle":"Overview","href":"/api-overview"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/authentication"},{"title":"Models","href":"/models"}]},{"group":"Guides","pages":[{"title":"Text generation","href":"/text-generation"},{"title":"Streaming","href":"/streaming"},{"title":"Reasoning","href":"/reasoning"},{"title":"Tool calling","href":"/tool-calling"},{"title":"Structured outputs","href":"/structured-outputs"}]},{"group":"Resources","pages":[{"title":"OpenAI compatibility","href":"/openai-compatibility"},{"title":"MCP endpoint","href":"/mcp-endpoint"},{"title":"Errors","href":"/errors"},{"title":"Rate limits","href":"/rate-limits"}]},{"group":"API reference","pages":[{"title":"API reference overview","sidebarTitle":"Overview","href":"/api-reference/overview"},{"group":"Models","pages":[{"title":"List models","description":"Lists the models available to you, with basic information about each one such as its limits and reasoning settings. The list can differ between organizations and plans.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /openai/v1/models","href":"/api-reference/models/list-models"},{"title":"Retrieve a model","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /openai/v1/models/{model}","href":"/api-reference/models/retrieve-a-model"}]},{"group":"Chat","pages":[{"title":"Create a chat completion","description":"Creates a model response for the given chat conversation. Learn more in the [text generation guide](/text-generation).\nReturns a chat completion object or, if the request is streamed, a sequence of server-sent events; chat completion chunks arrive as `data:` lines, and a completed stream ends with `data: [DONE]`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /openai/v1/chat/completions","href":"/api-reference/chat/create-a-chat-completion"}]}]},{"group":"Other sources","hidden":true,"pages":[]}]},{"tab":"Mirror","icon":"terminal","pages":[{"title":"Mirror","href":"/mirror-overview"}]},{"tab":"Deployment","icon":"server","pages":[{"title":"Deployment","href":"/deployment-overview"}]},{"tab":"Customization","icon":"sliders","pages":[{"title":"Customization","href":"/customization-overview"}]},{"tab":"Safety","icon":"shield-check","pages":[{"title":"Safety","href":"/laser-overview"}]},{"tab":"Gallery","icon":"images","pages":[{"title":"Gallery","href":"/gallery"}]}]},"basePath":"","title":"Retrieve a model - Reflection Developer Docs","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-DnSAhvaM.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js"]}