This is the OpenAI-compatible model list, extended with per-model metadata. It’s the machine-readable companion to Choosing a model, poll it if your application selects models dynamically or wants to feature-detect before sending a request.
Treat context_length, max_output_length, supported_sampling_parameters, and the reasoning block as the source of truth for request limits and reasoning behavior, they change when the catalog changes, without a docs release.
Authorizations
inferenceKeyxApiKey
Authorization
string
header
required
Bearer followed by an inference API key (sk-prl-infapi-). Create keys on the API Keys page. Management keys (sk-prl-mgmt-) cannot call models.
Response
The catalog.
data
object[]
One entry per served model, with the fields below.
Show child attributes
pricing_source
enum<string>
registry when every listed model has a price for your organization, partial when some don't (their entries omit pricing).
Available options:
registry,
partial
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Pearl Inference Platform","colors":{"primary":"#2A2623","light":"#EFEDEA","dark":"#2A2623"},"logo":{"light":"https://mintcdn.com/pearl-research/qjVPdghcpi_iWwgo/logo/light.svg?fit=max\u0026auto=format\u0026n=qjVPdghcpi_iWwgo\u0026q=85\u0026s=a969569c61ca3aa40012ac0f3dbbe445","dark":"https://mintcdn.com/pearl-research/qjVPdghcpi_iWwgo/logo/dark.svg?fit=max\u0026auto=format\u0026n=qjVPdghcpi_iWwgo\u0026q=85\u0026s=eacd546258e1218dea6ff14f55e89b4c"},"favicon":{"light":"https://mintcdn.com/pearl-research/jPtzRu8ZOdp5WYZT/favicon/pearl-light.svg?fit=max\u0026auto=format\u0026n=jPtzRu8ZOdp5WYZT\u0026q=85\u0026s=97c85bf573b7866d8612883b555a32c7","dark":"https://mintcdn.com/pearl-research/jPtzRu8ZOdp5WYZT/favicon/pearl-dark.svg?fit=max\u0026auto=format\u0026n=jPtzRu8ZOdp5WYZT\u0026q=85\u0026s=9dc503cf63b998d03fa165c37e0921e1"},"api":{"playground":{"display":"interactive"},"examples":{"prefill":true,"autogenerate":false},"url":"full"},"appearance":{"default":"light","strict":true},"background":{"color":{"light":"#EFEEEB"}},"navbar":{"links":[{"href":"mailto:support@pearlresearch.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://platform.pearlresearch.ai"}},"seo":{"metatags":{"canonical":"https://platform.pearlresearch.ai/docs"}},"fonts":{"heading":{"family":"Urbanist"},"body":{"family":"Inter"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pearl-research","hasAudioNarration":false,"actualSubdomain":"pearl-research","customDomains":[],"gitSource":{"type":"github","owner":"duplex-foundation","repo":"cloud-platform-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6afac147dd50ae575c58a540"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aff1808a4a19f80cc241c5b","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Docs","count":37},{"language":"default","tag":"Integrations","count":16},{"language":"default","tag":"Inference API","count":14},{"language":"default","tag":"API Reference","count":12},{"language":"default","tag":"Account \u0026 Billing","count":6},{"language":"default","tag":"Get Started","count":6},{"language":"default","tag":"Management API","count":5},{"language":"default","tag":"Guides","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","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":"site-roles","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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":true},"customCss":[]}
{"page":{"pagePath":"reference/models","slug":"/reference/models","pageMetadata":{"title":"List models","description":"The live catalog, one entry per served model, with context windows, capabilities, and supported parameters.","deprecated":null,"version":null,"sidebarTitle":"List models","openapi":"/openapi/inference.yaml get /models","href":"/reference/models","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: \"The live catalog, one entry per served model, with context windows, capabilities, and supported parameters.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`This is the OpenAI-compatible model list, extended with per-model metadata. It’s the machine-readable companion to `,_jsx(_components.a,{href:`/models`,children:`Choosing a model`}),`, poll it if your application selects models dynamically or wants to feature-detect before sending a request.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Treat `,_jsx(_components.code,{children:`context_length`}),`, `,_jsx(_components.code,{children:`max_output_length`}),`, `,_jsx(_components.code,{children:`supported_sampling_parameters`}),`, and the `,_jsx(_components.code,{children:`reasoning`}),` block as the source of truth for request limits and reasoning behavior, they change when the catalog changes, without a docs release.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List models","description":"The live catalog, one entry per served model, with context windows, capabilities, and supported parameters.","deprecated":null,"version":null,"sidebarTitle":"List models","openapi":"/openapi/inference.yaml get /models","href":"/reference/models","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"listModels","summary":"List models","description":"The live catalog, one entry per served model, with context windows, capabilities, and supported parameters.","security":["3b24730d-e39c-488d-93e5-1211260ccd77","b8d7456f-4af5-48ca-8a54-d663afebad4c"],"x-mint":{"href":"/reference/models","metadata":{"sidebarTitle":"List models"},"content":"This is the OpenAI-compatible model list, extended with per-model metadata. It's the machine-readable companion to [Choosing a model](/models), poll it if your application selects models dynamically or wants to feature-detect before sending a request.\n\n\u003cNote>\n Treat `context_length`, `max_output_length`, `supported_sampling_parameters`, and the `reasoning` block as the source of truth for request limits and reasoning behavior, they change when the catalog changes, without a docs release.\n\u003c/Note>\n"},"x-codeSamples":[{"lang":"bash","label":"cURL","source":"curl https://inference.pearlresearch.ai/v1/models \\\n -H \"Authorization: Bearer $PEARL_API_KEY\"\n"}],"responses":{"200":"ea8884ac-f1b1-48d6-9310-5dbd72f33bf8","401":"6af4f2eb-f74f-47b8-914d-abbbefd504c3","403":"280746ea-ea16-4313-b64f-01a1d5d2803e","503":"0771661a-708f-4e6c-a12b-99e57538c855"},"method":"get","type":"path","servers":["f6c31a79-dad6-4767-a559-ec5cffb3ed6a"],"path":"/models","baseUrlOptions":["https://inference.pearlresearch.ai/v1"],"title":"List models","codeSamples":[{"label":"cURL","lang":"bash","source":"curl https://inference.pearlresearch.ai/v1/models \\\n -H \"Authorization: Bearer $PEARL_API_KEY\"\n"}],"requiredOnlyExamples":false,"disableCodeSampleGeneration":true,"requestExampleType":"codeSamples","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[],"urlDisplay":"full"},"dependencies":{"parameters":{},"responses":{"ea8884ac-f1b1-48d6-9310-5dbd72f33bf8":{"description":"The catalog.","headers":{"X-Request-ID":{"description":"The request ID. Send your own UUID in `X-Request-ID` to use it as the ID. Include the ID when you contact support.","schema":{"type":"string"},"example":"6f0b6e0a-6a8f-4c62-9b1e-3d2c1a0f9e87"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"One entry per served model, with the fields below.","items":{"type":"object","properties":{"id":{"type":"string","description":"The value you pass as `model` in requests.","uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","description":"Human-readable display name (also used in the dashboard).","uniqueKey":"data.items.[INDEX].name","typeLabel":"string"},"hugging_face_id":{"type":"string","description":"The upstream open-weight checkpoint the deployment serves.","uniqueKey":"data.items.[INDEX].hugging_face_id","typeLabel":"string"},"created":{"type":"integer","description":"Unix timestamp of the model's release.","uniqueKey":"data.items.[INDEX].created","typeLabel":"integer"},"input_modalities":{"type":"array","description":"What the model accepts, `text`, plus `image` on vision models. Check this before sending multimodal content.","items":{"type":"string","enum":["text","image"],"uniqueKey":"data.items.[INDEX].input_modalities.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"data.items.[INDEX].input_modalities","typeLabel":"enum\u003cstring>[]"},"output_modalities":{"type":"array","description":"All catalog models output text.","items":{"type":"string","uniqueKey":"data.items.[INDEX].output_modalities.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.items.[INDEX].output_modalities","typeLabel":"string[]"},"quantization":{"type":"string","enum":["fp4","fp8","int8"],"description":"Serving precision (`fp4`, `fp8`, `int8`), a property of this deployment, not the checkpoint.","uniqueKey":"data.items.[INDEX].quantization","typeLabel":"enum\u003cstring>"},"context_length":{"type":"integer","description":"Maximum tokens (prompt + response) per request.","uniqueKey":"data.items.[INDEX].context_length","typeLabel":"integer"},"max_output_length":{"type":"integer","description":"Ceiling for generated tokens, the effective upper bound for `max_tokens`.","uniqueKey":"data.items.[INDEX].max_output_length","typeLabel":"integer"},"pricing":{"type":"object","description":"Your organization's rates as USD-per-token strings: `prompt`, `completion`, and `input_cache_read` (the discounted cached-input rate, when the model has one). Omitted for a model without a price for your organization. The dashboard [Models](https://platform.pearlresearch.ai/models) page shows the same rates per million tokens.","properties":{"prompt":{"type":"string","uniqueKey":"data.items.[INDEX].pricing.prompt","typeLabel":"string"},"completion":{"type":"string","uniqueKey":"data.items.[INDEX].pricing.completion","typeLabel":"string"},"input_cache_read":{"type":"string","uniqueKey":"data.items.[INDEX].pricing.input_cache_read","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].pricing","typeLabel":"object"},"supported_sampling_parameters":{"type":"array","description":"The authoritative per-model list of accepted sampling parameters (e.g. whether `min_p` is available).","items":{"type":"string","uniqueKey":"data.items.[INDEX].supported_sampling_parameters.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.items.[INDEX].supported_sampling_parameters","typeLabel":"string[]"},"supported_features":{"type":"array","description":"Capability flags: `tools`, `json_mode`, `reasoning`. The [model guide](/models) documents verified capability per model.","items":{"type":"string","enum":["tools","json_mode","reasoning"],"uniqueKey":"data.items.[INDEX].supported_features.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"data.items.[INDEX].supported_features","typeLabel":"enum\u003cstring>[]"},"reasoning":{"type":"object","description":"Per-model reasoning metadata.","properties":{"supported_efforts":{"type":"array","description":"The set of effort levels the model actually serves. A request for any other level is still accepted and rounds up to the next served level, or to the highest one when it asks for more, so this list, not the request schema, is the real menu. `none` is the disable control, not a rung.","items":{"type":"string","uniqueKey":"data.items.[INDEX].reasoning.supported_efforts.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.items.[INDEX].reasoning.supported_efforts","typeLabel":"string[]"},"default_effort":{"type":"string","description":"What omitting the request control gets you (GLM-5.3 defaults to `max`).","uniqueKey":"data.items.[INDEX].reasoning.default_effort","typeLabel":"string"},"mandatory":{"type":"boolean","description":"`true` marks models that always think and reject the disable with `400` (GLM-5.3, GLM-5.3-Flash).","uniqueKey":"data.items.[INDEX].reasoning.mandatory","typeLabel":"boolean"},"supports_max_tokens":{"type":"boolean","description":"Whether a `reasoning.max_tokens` thinking budget is accepted; it is `false` on every model today, and the budget returns `400`, see [Reasoning models](/reasoning).","uniqueKey":"data.items.[INDEX].reasoning.supports_max_tokens","typeLabel":"boolean"}},"uniqueKey":"data.items.[INDEX].reasoning","typeLabel":"object"},"description":{"type":"string","description":"A short human-readable summary of the model, safe to display to users.","uniqueKey":"data.items.[INDEX].description","typeLabel":"string"},"deprecation_date":{"type":"string","description":"When the model is scheduled for retirement, present only once one is set. See [Model deprecation](/deprecation).","uniqueKey":"data.items.[INDEX].deprecation_date","typeLabel":"string"},"datacenters":{"type":"array","description":"Where the model is served, as `{\"country_code\": …}` entries, when known.","items":{"type":"object","properties":{"country_code":{"type":"string","uniqueKey":"data.items.[INDEX].datacenters.items.[INDEX].country_code","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].datacenters.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.items.[INDEX].datacenters","typeLabel":"object[]"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"},"pricing_source":{"type":"string","enum":["registry","partial"],"description":"`registry` when every listed model has a price for your organization, `partial` when some don't (their entries omit `pricing`).","uniqueKey":"pricing_source","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"catalog":{"title":"catalog","summary":"Catalog","value":{"pricing_source":"registry","data":[{"id":"zai-org/GLM-5.3","hugging_face_id":"zai-org/GLM-5.3","name":"Z.AI: GLM-5.3","created":1787640170,"description":"GLM-5.3 is a text mixture-of-experts model supporting tool use, structured output, and low, high, or maximum reasoning effort.","input_modalities":["text"],"output_modalities":["text"],"quantization":"fp4","context_length":1000000,"max_output_length":1000000,"pricing":{"prompt":"…","completion":"…","input_cache_read":"…"},"supported_sampling_parameters":["temperature","top_p","top_k","frequency_penalty","presence_penalty","stop","seed","max_tokens"],"supported_features":["tools","json_mode","reasoning"],"reasoning":{"default_effort":"max","default_enabled":true,"mandatory":true,"supported_efforts":["low","high","max"],"supports_max_tokens":false}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"6af4f2eb-f74f-47b8-914d-abbbefd504c3":{"description":"Missing, unknown, revoked, or expired API key.","headers":{"X-Request-ID":{"description":"The request ID. Send your own UUID in `X-Request-ID` to use it as the ID. Include the ID when you contact support.","schema":{"type":"string"},"example":"6f0b6e0a-6a8f-4c62-9b1e-3d2c1a0f9e87"}},"content":{"application/json":{"schema":{"type":"object","description":"Errors are JSON in OpenAI's shape, with the request ID in the body.","properties":{"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","rate_limit_error","api_error"],"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Present only when set, for example `model_not_found` or `no_capacity`.","uniqueKey":"error.code","typeLabel":"string"},"request_id":{"type":"string","description":"The request ID.","uniqueKey":"error.request_id","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"unknownKey":{"title":"unknownKey","summary":"Unknown API key","value":{"error":{"message":"unknown API key","type":"authentication_error","request_id":"6f0b6e0a-6a8f-4c62-9b1e-3d2c1a0f9e87"}}}},"exampleType":"examples"}},"exampleType":"examples"},"280746ea-ea16-4313-b64f-01a1d5d2803e":{"description":"Wrong endpoint for your organization's [inference region](/data-residency).","headers":{"X-Request-ID":{"description":"The request ID. Send your own UUID in `X-Request-ID` to use it as the ID. Include the ID when you contact support.","schema":{"type":"string"},"example":"6f0b6e0a-6a8f-4c62-9b1e-3d2c1a0f9e87"}},"content":{"application/json":{"schema":{"type":"object","description":"Errors are JSON in OpenAI's shape, with the request ID in the body.","properties":{"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","rate_limit_error","api_error"],"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Present only when set, for example `model_not_found` or `no_capacity`.","uniqueKey":"error.code","typeLabel":"string"},"request_id":{"type":"string","description":"The request ID.","uniqueKey":"error.request_id","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"wrongRegion":{"title":"wrongRegion","summary":"Wrong endpoint for the region","value":{"error":{"message":"wrong endpoint for your organization's inference region","type":"permission_error","request_id":"6f0b6e0a-6a8f-4c62-9b1e-3d2c1a0f9e87"}}}},"exampleType":"examples"}},"exampleType":"examples"},"0771661a-708f-4e6c-a12b-99e57538c855":{"description":"The catalog is temporarily unavailable. Retry with backoff.","headers":{"X-Request-ID":{"description":"The request ID. Send your own UUID in `X-Request-ID` to use it as the ID. Include the ID when you contact support.","schema":{"type":"string"},"example":"6f0b6e0a-6a8f-4c62-9b1e-3d2c1a0f9e87"}},"content":{"application/json":{"schema":{"type":"object","description":"Errors are JSON in OpenAI's shape, with the request ID in the body.","properties":{"error":{"type":"object","properties":{"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","rate_limit_error","api_error"],"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","description":"Present only when set, for example `model_not_found` or `no_capacity`.","uniqueKey":"error.code","typeLabel":"string"},"request_id":{"type":"string","description":"The request ID.","uniqueKey":"error.request_id","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"catalogUnavailable":{"title":"catalogUnavailable","summary":"Catalog unavailable","value":{"error":{"message":"the catalog is temporarily unavailable","type":"api_error","request_id":"6f0b6e0a-6a8f-4c62-9b1e-3d2c1a0f9e87"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"3b24730d-e39c-488d-93e5-1211260ccd77":{"inferenceKey":{"type":"http","scheme":"bearer","description":"`Bearer` followed by an inference API key (`sk-prl-infapi-`). Create keys on the [API Keys](https://platform.pearlresearch.ai/api-keys) page. Management keys (`sk-prl-mgmt-`) cannot call models.","scopes":[],"schemeName":"inferenceKey"}},"b8d7456f-4af5-48ca-8a54-d663afebad4c":{"xApiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your inference API key. Send this or `Authorization`; if you send both, they must carry the same key.","scopes":[],"schemeName":"xApiKey"}}},"servers":{"f6c31a79-dad6-4767-a559-ec5cffb3ed6a":{"url":"https://inference.pearlresearch.ai/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"`Bearer` followed by an inference API key (`sk-prl-infapi-`). Create keys on the [API Keys](https://platform.pearlresearch.ai/api-keys) page. Management keys (`sk-prl-mgmt-`) cannot call models.","scopes":[],"schemeName":"inferenceKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"`Bearer` followed by an inference API key (`sk-prl-infapi-`). Create keys on the [API Keys](https://platform.pearlresearch.ai/api-keys) page. Management keys (`sk-prl-mgmt-`) cannot call models.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"inferenceKey","name":"Authorization"}],"title":"inferenceKey"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your inference API key. Send this or `Authorization`; if you send both, they must carry the same key.","scopes":[],"schemeName":"xApiKey"},"schema":{"title":"x-api-key","type":"string","description":"Your inference API key. Send this or `Authorization`; if you send both, they must carry the same key.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"xApiKey","name":"x-api-key"}],"title":"xApiKey"}]},"originalFileLocation":"openapi/inference.yaml"},"subdomain":"pearl-research","siteName":"Pearl Inference Platform","title":"List models - Pearl Inference Platform","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T15:31:08.216Z","originalFileLocation":"reference/models.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"The live catalog, one entry per served model, with context windows, capabilities, and supported parameters.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Pearl Inference Platform\">\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/pearl-research/k9be1f6J_artjsFA/_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/pearl-research/k9be1f6J_artjsFA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/pearl-research/k9be1f6J_artjsFA/_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/pearl-research/k9be1f6J_artjsFA/_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/pearl-research/k9be1f6J_artjsFA/_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/pearl-research/k9be1f6J_artjsFA/_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/pearl-research/k9be1f6J_artjsFA/_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/pearl-research/k9be1f6J_artjsFA/_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/pearl-research/k9be1f6J_artjsFA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List models - Pearl Inference Platform\">\u003cmeta data-mint-head property=\"og:description\" content=\"The live catalog, one entry per served model, with context windows, capabilities, and supported parameters.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pearl Inference Platform\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://platform.pearlresearch.ai/docs/reference/models\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pearl-research.mintlify.site/docs/_mintlify/api/og/v2?division=Inference+API\u0026amp;title=List+models\u0026amp;description=The+live+catalog%2C+one+entry+per+served+model%2C+with+context+windows%2C+capabilities%2C+and+supported+parameters.\u0026amp;theme=8053f473600c09a776e77e44\u0026amp;signature=bd089dff7ace14f67c36078ee900d5ab2ded2a80d93bd6ea93672df8699eb1f1\">\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=\"List models - Pearl Inference Platform\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The live catalog, one entry per served model, with context windows, capabilities, and supported parameters.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pearl-research.mintlify.site/docs/_mintlify/api/og/v2?division=Inference+API\u0026amp;title=List+models\u0026amp;description=The+live+catalog%2C+one+entry+per+served+model%2C+with+context+windows%2C+capabilities%2C+and+supported+parameters.\u0026amp;theme=8053f473600c09a776e77e44\u0026amp;signature=bd089dff7ace14f67c36078ee900d5ab2ded2a80d93bd6ea93672df8699eb1f1\">\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/pearl-research/k9be1f6J_artjsFA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pearl Inference Platform\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2A2623\">\u003clink data-mint-head rel=\"canonical\" href=\"https://platform.pearlresearch.ai/docs/reference/models\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/reference/models.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://platform.pearlresearch.ai/#organization\",\"name\":\"Pearl Inference Platform\",\"url\":\"https://platform.pearlresearch.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pearl-research/qjVPdghcpi_iWwgo/logo/light.svg?fit=max\u0026auto=format\u0026n=qjVPdghcpi_iWwgo\u0026q=85\u0026s=a969569c61ca3aa40012ac0f3dbbe445\"}},{\"@type\":\"WebSite\",\"@id\":\"https://platform.pearlresearch.ai/docs#website\",\"name\":\"Pearl Inference Platform\",\"url\":\"https://platform.pearlresearch.ai/docs\",\"publisher\":{\"@id\":\"https://platform.pearlresearch.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://platform.pearlresearch.ai/docs/reference/models#webpage\",\"url\":\"https://platform.pearlresearch.ai/docs/reference/models\",\"name\":\"List models\",\"description\":\"The live catalog, one entry per served model, with context windows, capabilities, and supported parameters.\",\"dateModified\":\"2026-11-16T15:31:08.216Z\",\"isPartOf\":{\"@id\":\"https://platform.pearlresearch.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://platform.pearlresearch.ai/docs/reference/models#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://platform.pearlresearch.ai/docs/reference/models#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Inference API\",\"item\":\"https://platform.pearlresearch.ai/docs/reference/inference\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List models\",\"item\":\"https://platform.pearlresearch.ai/docs/reference/models\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://platform.pearlresearch.ai/docs/reference/models#apireference\",\"headline\":\"List models\",\"name\":\"List models\",\"description\":\"The live catalog, one entry per served model, with context windows, capabilities, and supported parameters.\",\"url\":\"https://platform.pearlresearch.ai/docs/reference/models\",\"mainEntityOfPage\":{\"@id\":\"https://platform.pearlresearch.ai/docs/reference/models#webpage\"},\"dateModified\":\"2026-11-16T15:31:08.216Z\",\"publisher\":{\"@id\":\"https://platform.pearlresearch.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://platform.pearlresearch.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Pearl Inference Platform\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Pearl Inference Platform\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/reference/models.md","siteName":"Pearl Inference Platform","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":""}]},{"tab":"API Reference","groups":[{"group":"Inference API","pages":[{"title":"Overview","href":"/reference/inference"},{"title":"Chat completions","deprecated":null,"version":null,"sidebarTitle":"Chat completions","openapi":"/openapi/inference.yaml post /chat/completions","href":"/reference/chat-completions"},{"title":"Responses","deprecated":null,"version":null,"sidebarTitle":"Responses","openapi":"/openapi/inference.yaml post /responses","href":"/reference/responses"},{"title":"Messages","deprecated":null,"version":null,"sidebarTitle":"Messages","openapi":"/openapi/inference.yaml post /messages","href":"/reference/messages"},{"title":"Count tokens","deprecated":null,"version":null,"sidebarTitle":"Count tokens","openapi":"/openapi/inference.yaml post /messages/count_tokens","href":"/reference/messages/count-tokens"},{"title":"Completions (legacy)","description":"Raw-prompt text completion, the pre-chat OpenAI shape, served for tooling that still speaks it.","deprecated":null,"version":null,"sidebarTitle":"Completions (legacy)","openapi":"/openapi/inference.yaml post /completions","href":"/reference/completions"},{"title":"List models","deprecated":null,"version":null,"sidebarTitle":"List models","openapi":"/openapi/inference.yaml get /models","href":"/reference/models"}]},{"group":"Management API","pages":[{"title":"Overview","description":"Read your organization's credits and usage from scripts, dashboards, and finance tools, and let any API key check its own limit and spend.","href":"/reference/management"},{"title":"Rate limits","href":"/reference/management/rate-limits"},{"title":"Get credits","deprecated":null,"version":null,"sidebarTitle":"Credits","openapi":"/openapi/management.yaml get /credits","href":"/reference/management/credits"},{"title":"Get current API key","deprecated":null,"version":null,"sidebarTitle":"Current API key","openapi":"/openapi/management.yaml get /key","href":"/reference/management/key"},{"title":"Get activity","deprecated":null,"version":null,"sidebarTitle":"Activity","openapi":"/openapi/management.yaml get /activity","href":"/reference/management/activity"}]}]}]},"basePath":"","title":"List models - Pearl Inference Platform","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","CodeSnippet-CTZvgJfu.js","getApiPlaygroundDisplay-BK2o1XYu.js","Page--B9YZ09u.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}