{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Ambral","colors":{"primary":"#9bc8ff","light":"#9bc8ff","dark":"#9bc8ff"},"logo":{"light":"https://mintcdn.com/ambral/mNU6JDLZnKAVd0V1/logo/wordmark.svg?fit=max\u0026auto=format\u0026n=mNU6JDLZnKAVd0V1\u0026q=85\u0026s=596a52a908104c66b885d491b7c3dcda","dark":"https://mintcdn.com/ambral/mNU6JDLZnKAVd0V1/logo/wordmark.svg?fit=max\u0026auto=format\u0026n=mNU6JDLZnKAVd0V1\u0026q=85\u0026s=596a52a908104c66b885d491b7c3dcda","href":"https://ambral.ai"},"favicon":{"light":"https://mintcdn.com/ambral/mNU6JDLZnKAVd0V1/favicon.svg?fit=max\u0026auto=format\u0026n=mNU6JDLZnKAVd0V1\u0026q=85\u0026s=3abef413d4aec8053161e3de204de153","dark":"https://mintcdn.com/ambral/mNU6JDLZnKAVd0V1/favicon-dark.svg?fit=max\u0026auto=format\u0026n=mNU6JDLZnKAVd0V1\u0026q=85\u0026s=f21b3123d3781dc4f7ec13985b75ee4c"},"api":{"playground":{"display":"simple"},"examples":{"languages":["bash","python","javascript"]}},"appearance":{"default":"dark","strict":true},"background":{"color":{"dark":"#000000"}},"fonts":{"family":"DM Sans"},"contextual":{"options":["copy","view","claude","download-spec"],"display":"header"},"markdown":{"instructions":"To set Ambral up in a project, run `npx ambral@latest skill install` in the project's root. It installs Ambral's skill, matched to the CLI's version, and the skill says how to do everything these pages describe with the `ambral` CLI. Prefer it to working from these pages. Never ask anyone for an Ambral API key, and never handle one: the person creates it in the web app and stores it where their app reads its secrets."},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ambral","hasAudioNarration":false,"actualSubdomain":"ambral","customDomains":[],"gitSource":{"type":"github","owner":"ambralai","repo":"cerberus","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":"","_id":"6af490beb159d2b5cc770299"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afbc357a7f246b263e1c460","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Docs","count":15},{"language":"default","tag":"CLI","count":14},{"language":"default","tag":"Command reference","count":13},{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"Shadow evals","count":9},{"language":"default","tag":"API reference","count":7},{"language":"default","tag":"Examples","count":7},{"language":"default","tag":"SDKs","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Gateway","count":3}]},"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--edge: #ffffff17}*,::before,::after{border-radius:0!important}#navbar,#sidebar,#footer,#content-area hr,#content-area table,#content-area th,#content-area td{border-color:var(--edge)!important}html:not([data-current-path^=\"/api-reference/\"]) #header>.prose{display:none}"}],"page":{"pagePath":"api-reference/inference/list-models","slug":"/api-reference/inference/list-models","pageMetadata":{"title":"List models","description":"Lists `ambral/auto`, the model every request names, in the shape OpenAI's SDKs and model pickers read.","deprecated":null,"version":null,"openapi":"/api-reference/gateway.json get /v1/models","href":"/api-reference/inference/list-models","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Lists \", _jsx(_components.code, {\n children: \"ambral/auto\"\n }), \", the model every request names, in the shape OpenAI’s SDKs and model pickers read.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List models","description":"Lists `ambral/auto`, the model every request names, in the shape OpenAI's SDKs and model pickers read.","deprecated":null,"version":null,"openapi":"/api-reference/gateway.json get /v1/models","href":"/api-reference/inference/list-models","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["inference"],"operationId":"inference.models","parameters":[],"security":["57ef8e0d-1cda-425c-b8d9-b162b84d7c64"],"responses":{"200":"09e371a9-c69c-468e-9ede-888730a614de","401":"0fec39f1-d163-4a22-857a-de2b3c93b1f1","503":"78099588-dcf9-4356-bd48-b5135838289e"},"description":"Lists `ambral/auto`, the model every request names, in the shape OpenAI's SDKs and model pickers read.","summary":"List models","method":"get","type":"path","servers":["877871e7-928f-489e-aa40-52010c2fae17"],"path":"/v1/models","baseUrlOptions":["https://api.ambral.ai"],"title":"List models","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"09e371a9-c69c-468e-9ede-888730a614de":{"description":"The models the key can name, as OpenAI's SDKs and model pickers read a list of models.","content":{"application/json":{"schema":{"type":"object","properties":{"object":{"type":"string","enum":["list"],"isRequired":true,"uniqueKey":"object","typeLabel":"enum\u003cstring>"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256,"isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"object":{"type":"string","enum":["model"],"isRequired":true,"uniqueKey":"data.items.[INDEX].object","typeLabel":"enum\u003cstring>"},"created":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"data.items.[INDEX].created","typeLabel":"integer"},"owned_by":{"type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].owned_by","typeLabel":"string"}},"required":["id","object","created","owned_by"],"additionalProperties":false,"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"}},"required":["object","data"],"additionalProperties":false,"description":"The models the key can name, as OpenAI's SDKs and model pickers read a list of models.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"object":"list","data":[{"id":"\u003cstring>","object":"model","created":4503599627370495,"owned_by":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"0fec39f1-d163-4a22-857a-de2b3c93b1f1":{"description":"No inference key, or one that is unknown or revoked, or whose org isn't active.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"}},"required":["message","type","code"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"\u003cstring>","code":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"78099588-dcf9-4356-bd48-b5135838289e":{"description":"The key, or the route of the workload the request names, couldn't be read. Retry the request.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"}},"required":["message","type","code"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"\u003cstring>","code":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"57ef8e0d-1cda-425c-b8d9-b162b84d7c64":{"bearer":{"description":"An inference key, made on the API keys page of Ambral's app.","type":"http","scheme":"Bearer","scopes":[],"schemeName":"bearer"}}},"servers":{"877871e7-928f-489e-aa40-52010c2fae17":{"url":"https://api.ambral.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"An inference key, made on the API keys page of Ambral's app.","type":"http","scheme":"Bearer","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An inference key, made on the API keys page of Ambral's app.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"api-reference/gateway.json"},"subdomain":"ambral","siteName":"Ambral","title":"List models - Ambral","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T03:00:46.154Z","originalFileLocation":"api-reference/inference/list-models.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"dark\"}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=\"Lists ambral/auto, the model every request names, in the shape OpenAI\u0026#x27;s SDKs and model pickers read.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ambral\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ambral/kBWGgyOFROdBeDfg/_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/ambral/kBWGgyOFROdBeDfg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ambral/kBWGgyOFROdBeDfg/_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/ambral/kBWGgyOFROdBeDfg/_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/ambral/kBWGgyOFROdBeDfg/_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/ambral/kBWGgyOFROdBeDfg/_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/ambral/kBWGgyOFROdBeDfg/_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/ambral/kBWGgyOFROdBeDfg/_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/ambral/kBWGgyOFROdBeDfg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List models - Ambral\">\u003cmeta data-mint-head property=\"og:description\" content=\"Lists ambral/auto, the model every request names, in the shape OpenAI\u0026#x27;s SDKs and model pickers read.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ambral\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://ambral.mintlify.app/api-reference/inference/list-models\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ambral.mintlify.site/_mintlify/api/og/v2?division=inference\u0026amp;title=List+models\u0026amp;description=Lists+%60ambral%2Fauto%60%2C+the+model+every+request+names%2C+in+the+shape+OpenAI%27s+SDKs+and+model+pickers+read.\u0026amp;theme=4ec1078c93ea1a79a60ccd87\u0026amp;signature=646739eb4cdd5fe287401f413cd32e79f0a90c11abb68c15f48c0c1a68fa7e69\">\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 - Ambral\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Lists ambral/auto, the model every request names, in the shape OpenAI\u0026#x27;s SDKs and model pickers read.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ambral.mintlify.site/_mintlify/api/og/v2?division=inference\u0026amp;title=List+models\u0026amp;description=Lists+%60ambral%2Fauto%60%2C+the+model+every+request+names%2C+in+the+shape+OpenAI%27s+SDKs+and+model+pickers+read.\u0026amp;theme=4ec1078c93ea1a79a60ccd87\u0026amp;signature=646739eb4cdd5fe287401f413cd32e79f0a90c11abb68c15f48c0c1a68fa7e69\">\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/ambral/kBWGgyOFROdBeDfg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ambral\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9bc8ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://ambral.mintlify.app/api-reference/inference/list-models\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/inference/list-models.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://ambral.mintlify.app/#organization\",\"name\":\"Ambral\",\"url\":\"https://ambral.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ambral/mNU6JDLZnKAVd0V1/logo/wordmark.svg?fit=max\u0026auto=format\u0026n=mNU6JDLZnKAVd0V1\u0026q=85\u0026s=596a52a908104c66b885d491b7c3dcda\"}},{\"@type\":\"WebSite\",\"@id\":\"https://ambral.mintlify.app#website\",\"name\":\"Ambral\",\"url\":\"https://ambral.mintlify.app\",\"publisher\":{\"@id\":\"https://ambral.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://ambral.mintlify.app/api-reference/inference/list-models#webpage\",\"url\":\"https://ambral.mintlify.app/api-reference/inference/list-models\",\"name\":\"List models\",\"description\":\"Lists ambral/auto, the model every request names, in the shape OpenAI's SDKs and model pickers read.\",\"dateModified\":\"2026-11-17T03:00:46.154Z\",\"isPartOf\":{\"@id\":\"https://ambral.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://ambral.mintlify.app/api-reference/inference/list-models#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://ambral.mintlify.app/api-reference/inference/list-models#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Gateway\",\"item\":\"https://ambral.mintlify.app/api-reference/inference/create-a-chat-completion\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"inference\",\"item\":\"https://ambral.mintlify.app/api-reference/inference/create-a-chat-completion\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List models\",\"item\":\"https://ambral.mintlify.app/api-reference/inference/list-models\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://ambral.mintlify.app/api-reference/inference/list-models#apireference\",\"headline\":\"List models\",\"name\":\"List models\",\"description\":\"Lists ambral/auto, the model every request names, in the shape OpenAI's SDKs and model pickers read.\",\"url\":\"https://ambral.mintlify.app/api-reference/inference/list-models\",\"mainEntityOfPage\":{\"@id\":\"https://ambral.mintlify.app/api-reference/inference/list-models#webpage\"},\"dateModified\":\"2026-11-17T03:00:46.154Z\",\"publisher\":{\"@id\":\"https://ambral.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://ambral.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ambral\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ambral\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/inference/list-models.md","siteName":"Ambral","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":""}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks/typescript"}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API overview","href":"/api-reference"}]},{"group":"Gateway","pages":[{"group":"inference","pages":[{"title":"Create a chat completion","description":"OpenAI's Chat Completions API. `model` is `ambral/auto` with an `x-workload` header (or `ambral/auto:\u003cworkload>`), which serves the workload's primary model and records the call to its traces. The answer is in Chat Completions' own response schema, with `id` the call's own id, `model` the model that served it, and `usage.cost` what the call costs, in USD; any other key the provider adds is removed. With `stream: true` the answer is server-sent events, one chunk each, ending with `data: [DONE]`. A failure after the 200 is a chunk whose `error` says what failed, or the error envelope when Ambral couldn't read the provider's event, and a provider whose connection drops ends the stream without `[DONE]`. Otherwise it is one JSON completion, or the error envelope when Ambral couldn't read it. An error the provider answers reaches the client with the provider's status, in the same error envelope. Every top-level key Chat Completions names, and the provider's own extension keys, are passed through as they were sent; any other key is left out. A request Ambral must price and can't is a 400: one that would let the provider choose another model, or run a tool or add-on Ambral doesn't price.","deprecated":null,"version":null,"openapi":"/api-reference/gateway.json post /v1/chat/completions","href":"/api-reference/inference/create-a-chat-completion"},{"title":"List models","deprecated":null,"version":null,"openapi":"/api-reference/gateway.json get /v1/models","href":"/api-reference/inference/list-models"}]},{"group":"messages","pages":[{"title":"Create a message","description":"Anthropic's Messages API. `model` is `ambral/auto` with an `x-workload` header (or `ambral/auto:\u003cworkload>`), which serves the workload's primary model and records the call to its traces. The answer is in the Messages API's own response schema, with `id` the call's own id, `model` the model that served it, and `usage.cost` what the call costs, in USD; any other key the provider adds to the message, its usage, a block or an event is removed (a block or delta of a type the schema doesn't name is kept whole). With `stream: true` the answer is named server-sent events, as the Messages API streams them: `message_start` with the id and model, each block's start, deltas and stop, `message_delta` with the stop reason and the whole call's usage and cost, then `message_stop`, which ends the stream; `ping` keeps it open, and an `error` event is a failure after the 200, or Ambral couldn't read the provider's event. Otherwise it is one JSON message, or the error envelope when Ambral couldn't read it. Every error is Anthropic's envelope, with Ambral's `code` beside its `type`, and an error the provider answers reaches the client with the provider's status. The request's content blocks, the top-level keys the Messages API names, and the provider's own extension keys are passed through as they were sent; any other key is left out. A request Ambral must price and can't is a 400: one that would let the provider choose another model, or run a tool or add-on Ambral doesn't price, or that asks for a premium setting Ambral doesn't price yet (fast `speed`, a regional `inference_geo`). A client tool, which has no `type`, `custom`, or one of Anthropic's versioned client tools (`bash_20250124`, `text_editor_*`, `computer_*`, `memory_*`), is priced; any other tool is run by the provider.","deprecated":null,"version":null,"openapi":"/api-reference/gateway.json post /v1/messages","href":"/api-reference/messages/create-a-message"}]}]},{"group":"Report API","pages":[{"group":"Runs","pages":[{"title":"Open an offline run","deprecated":null,"version":null,"openapi":"/api-reference/report.json post /api/report/v1/runs","href":"/api-reference/runs/open-an-offline-run"},{"title":"Report scenarios to an offline run","deprecated":null,"version":null,"openapi":"/api-reference/report.json post /api/report/v1/runs/{run}/reports","href":"/api-reference/runs/report-scenarios-to-an-offline-run"},{"title":"Close an offline run","deprecated":null,"version":null,"openapi":"/api-reference/report.json post /api/report/v1/runs/{run}/close","href":"/api-reference/runs/close-an-offline-run"}]}]}]}]},"basePath":"","title":"List models - Ambral","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-C7x-eUfk.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}