One model or preset with input_schema, the JSON Schema (2020-12) of the input it takes. Build your request from it: required fields, allowed values and defaults are all there, and unknown fields are refused.
Needs an API key with the generations:read scope.
GET
https://api.tryleap.ai
/
v1
/
models
/
{creator}
/
{name}
Retrieve a model
curl --request GET \
--url https://api.tryleap.ai/v1/models/{creator}/{name} \
--header 'x-api-key: <api-key>'
model for a raw model, preset for a ready-made recipe built on one.
Available options:
model,
preset
name
string
required
Its display name.
creator
string
required
Who made it.
modality
enum<string>
required
What it makes: image, video, audio, 3d or text.
Available options:
image,
video,
audio,
3d,
text
tasks
enum<string>[]
required
What it does, main task first, such as text-to-image or image-to-video.
Available options:
text-to-image,
image-edit,
outpaint,
upscale-image,
remove-background,
try-on,
text-to-video,
image-to-video,
video-to-video,
upscale-video,
lip-sync,
talking-avatar,
text-to-speech,
voice-clone,
text-to-music,
sound-effects,
image-to-3d,
text-to-3d,
video-to-audio,
speech-to-speech,
motion-transfer,
speech-to-text,
captions
description
string
required
What it's good at, in a sentence.
revision
string
required
The date of its current schema and price.
Pattern: ^\d{4}-\d{2}-\d{2}$
version
integer | null
required
A preset's version, the N in @N; null for a model.
Required range: 0 < x <= 9007199254740991
latest
boolean
required
Whether a preset ID without @N runs this version. Always true for a model.
status
enum<string>
required
preview (may still change), stable, deprecated (runs until its sunset) or retired (doesn't run).
Available options:
preview,
stable,
deprecated,
retired
deprecation
object | null
required
When and why it's going away; null unless it's deprecated.
Show child attributes
pricing
object
required
Show child attributes
input_schema
object
required
A JSON Schema (2020-12) of the input it takes: required fields, types, allowed values and defaults. Unknown fields are refused, and a field that takes a file has the pattern ^file_[0-9A-Za-z]{24}$.
added
string
Pattern: ^\d{4}-\d{2}-\d{2}$
guide
object
Show child attributes
outcome
object
For a recipe sold as a finished set at one price: title, what you add (uploads), what you get (gets), how many images one run makes (count), and a recipe that makes a cheap first sample from the same upload (sample). Absent for the rest.
Show child attributes
cover
object
Show child attributes
gallery
object[]
Show child attributes
photo
object
For an effect: what its photo must show. framing is the least of the person it needs, full (head to toe), waist (waist up) or face; setting is outdoor when it needs sky or open ground around them, any otherwise. Check a photo against it with POST /v1/photo-checks.
Show child attributes
still
object
For a video recipe that makes a still from the photo first: the frame of the clip it becomes (first_frame or last_frame, or images for a storyboard sheet the clip follows as its first reference image, or character_image for the performer a reference clip moves), and whether it shows as the generation's preview while the clip renders (never for images). Absent for a recipe that makes none.
Show child attributes
expected_seconds
integer
How long Leap's own runs of it took at its defaults, in seconds, from the request to the stored file. A hint for how long to wait, not a promise. Absent until Leap has timed one.
Required range: x <= 9007199254740991
first_image_free
boolean
true for a picture whose first run, at its defaults, is free for a new person in the Leap studio: one image, once per person. A run started with an API key or over MCP is never free. Absent for everything else.
⌘I
Retrieve a model
curl --request GET \
--url https://api.tryleap.ai/v1/models/{creator}/{name} \
--header 'x-api-key: <api-key>'
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Leap","description":"Generate images, video and audio with Veo, Kling, Seedance, FLUX, GPT Image, ElevenLabs and more, through one REST API and one balance. No key yet? Browse models and schemas at https://api.tryleap.ai/v1/public/models.","colors":{"primary":"#4F39F6","light":"#777FFF","dark":"#4F39F6"},"logo":{"light":"https://mintcdn.com/leap-0e8117eb/HU8mATp2ehtMskps/logo/light.svg?fit=max\u0026auto=format\u0026n=HU8mATp2ehtMskps\u0026q=85\u0026s=a5c8ec9980a555c60231ada77cecaeb3","dark":"https://mintcdn.com/leap-0e8117eb/HU8mATp2ehtMskps/logo/dark.svg?fit=max\u0026auto=format\u0026n=HU8mATp2ehtMskps\u0026q=85\u0026s=1fcfe7f18026357dff94cf9682fb329a"},"favicon":"https://mintcdn.com/leap-0e8117eb/HU8mATp2ehtMskps/favicon.svg?fit=max\u0026auto=format\u0026n=HU8mATp2ehtMskps\u0026q=85\u0026s=cadb07c0e43b32f72651cb7e3dcb63ba","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","typescript","python"],"prefill":true},"url":"full"},"appearance":{"default":"system","strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#171715"}},"navbar":{"links":[{"href":"https://app.tryleap.ai/go","label":"Studio"}],"primary":{"type":"button","label":"Get an API key","href":"https://app.tryleap.ai/go/api?utm_source=tryleap\u0026utm_medium=docs\u0026utm_campaign=%2Fdocs\u0026utm_content=navbar"}},"footer":{"socials":{"website":"https://www.tryleap.ai"},"links":[{"header":"Product","items":[{"label":"Studio","href":"https://app.tryleap.ai/go"},{"label":"Models","href":"https://www.tryleap.ai/models"},{"label":"Recipes","href":"https://www.tryleap.ai/recipes"},{"label":"Pricing","href":"https://www.tryleap.ai/pricing"}]},{"header":"Developers","items":[{"label":"Get an API key","href":"https://app.tryleap.ai/go/api?utm_source=tryleap\u0026utm_medium=docs\u0026utm_campaign=%2Fdocs\u0026utm_content=footer"},{"label":"Connect an agent","href":"https://app.tryleap.ai/go/connect?utm_source=tryleap\u0026utm_medium=docs\u0026utm_campaign=%2Fdocs\u0026utm_content=footer"},{"label":"Leap skill","href":"https://www.tryleap.ai/skills/leap/SKILL.md"},{"label":"llms.txt","href":"https://www.tryleap.ai/docs/llms.txt"}]},{"header":"Legal","items":[{"label":"Terms","href":"https://app.tryleap.ai/legal/terms"},{"label":"Privacy","href":"https://app.tryleap.ai/legal/privacy"},{"label":"Acceptable use","href":"https://app.tryleap.ai/legal/acceptable-use"}]}]},"search":{"prompt":"Search the Leap docs"},"seo":{"metatags":{"og:site_name":"Leap","og:type":"website","twitter:card":"summary_large_image"},"organization":{"name":"Leap","url":"https://www.tryleap.ai","logo":"https://www.tryleap.ai/icon-512.png"},"indexing":"navigable"},"fonts":{"family":"Geist","weight":400},"icons":{"library":"lucide"},"styling":{"eyebrows":"section","codeblocks":{"theme":"css-variables"},"latex":true},"integrations":{"posthog":{"apiKey":"phc_y6yy24Kn4vwUkaMxb5LCWJrffeBzUQZRh2p4UhsETqYe","apiHost":"https://www.tryleap.ai/ingest","sessionRecording":true}},"errors":{"404":{"redirect":false,"title":"Page not found","description":"Search the docs, or start from the [quickstart](/quickstart)."}},"contextual":{"options":["copy","view","claude","chatgpt",{"title":"Install the Leap skill","description":"Teach Claude Code, Codex and other agents the Leap API","icon":"terminal","href":"https://www.tryleap.ai/skills/leap/SKILL.md"},{"title":"Connect Leap's MCP server","description":"Make images, video and audio from Claude, ChatGPT, Cursor or VS Code","icon":"plug","href":"https://app.tryleap.ai/go/connect?utm_source=tryleap\u0026utm_medium=docs\u0026utm_campaign=%2Fdocs\u0026utm_content=card"}],"display":"header"},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/leap-0e8117eb/HU8mATp2ehtMskps/images/og-background.png?fit=max\u0026auto=format\u0026n=HU8mATp2ehtMskps\u0026q=85\u0026s=3475b40ff2d9769cd0ad2ba9e37c1a96","fonts":{"family":"Geist"}},"metadata":{"timestamp":true},"markdown":{"instructions":["Leap's API is at https://api.tryleap.ai. Send the key in the x-api-key header or as Authorization: Bearer; keys start with leap_.","Take model IDs and input schemas from GET /v1/models/{creator}/{name}, or from https://api.tryleap.ai/v1/public/models without a key. Never guess an input field: unknown fields are a 400.","Model inputs take uploaded file IDs (file_...), never URLs. A kept character's ID (chr_..., POST /v1/characters) goes wherever an image file does and keeps the character the same across runs.","To give a coding agent the whole API, install the Leap skill: curl -fsSL https://www.tryleap.ai/install.sh | sh","To make media from ChatGPT, Claude or another MCP client without code, connect Leap's MCP server at https://app.tryleap.ai/api/mcp; see https://www.tryleap.ai/docs/mcp.","The full OpenAPI 3.1 spec is at https://www.tryleap.ai/docs/openapi.json."]},"navigation":{"global":{"anchors":[{"anchor":"Model catalog","icon":"sparkles","href":"https://www.tryleap.ai/models"},{"anchor":"Connect an agent","icon":"plug","href":"https://app.tryleap.ai/go/connect?utm_source=tryleap\u0026utm_medium=docs\u0026utm_campaign=%2Fdocs\u0026utm_content=anchor"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"leap-0e8117eb","hasAudioNarration":false,"actualSubdomain":"leap-0e8117eb","customDomains":["www.tryleap.ai"],"gitSource":{"type":"github","owner":"goatedventures","repo":"leap-neo","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ae36428f2e535e50ffb93a5","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API reference","count":36},{"language":"default","tag":"Guides","count":23},{"language":"default","tag":"Build","count":8},{"language":"default","tag":"Webhooks","count":8},{"language":"default","tag":"MCP server","count":7},{"language":"default","tag":"Characters","count":5},{"language":"default","tag":"Files","count":5},{"language":"default","tag":"Generations","count":5},{"language":"default","tag":"Get started","count":4},{"language":"default","tag":"Events","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":true},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\ncode,pre,kbd,samp{font-family:\"Geist Mono\", ui-monospace, SFMono-Regular, Menlo, monospace!important}.eyebrow,.sidebar-group-header{text-transform:none!important}html.dark #topbar-cta-button a{background-color:#4f39f6!important}html.dark #topbar-cta-button span{color:#ffffff!important}:root{--mint-color-background: #171715;--mint-foreground: #ededed;--mint-color-text: #ededed;--mint-token-string: #777fff;--mint-token-string-expression: #777fff;--mint-token-link: #777fff;--mint-token-constant: #ededed;--mint-token-keyword: #ededed;--mint-token-function: #ededed;--mint-token-parameter: #ededed;--mint-token-comment: #a1a1a1;--mint-token-punctuation: #a1a1a1}.code-block,.code-group{background-color:#171715!important}"}],"page":{"pagePath":"api-reference/models/retrieve-a-model","slug":"/api-reference/models/retrieve-a-model","pageMetadata":{"title":"Retrieve a model","description":"One model or preset with `input_schema`, the JSON Schema (2020-12) of the `input` it takes. Build your request from it: required fields, allowed values and defaults are all there, and unknown fields are refused.\n\nNeeds an API key with the `generations:read` scope.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/models/{creator}/{name}","href":"/api-reference/models/retrieve-a-model","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, 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(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"One model or preset with \", _jsx(_components.code, {\n children: \"input_schema\"\n }), \", the JSON Schema (2020-12) of the \", _jsx(_components.code, {\n children: \"input\"\n }), \" it takes. Build your request from it: required fields, allowed values and defaults are all there, and unknown fields are refused.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Needs an API key with the \", _jsx(_components.code, {\n children: \"generations:read\"\n }), \" scope.\"]\n })]\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":"css-variables"},"config":{},"pageMetadata":{"title":"Retrieve a model","description":"One model or preset with `input_schema`, the JSON Schema (2020-12) of the `input` it takes. Build your request from it: required fields, allowed values and defaults are all there, and unknown fields are refused.\n\nNeeds an API key with the `generations:read` scope.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/models/{creator}/{name}","href":"/api-reference/models/retrieve-a-model","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"retrieveModel","summary":"Retrieve a model","description":"One model or preset with `input_schema`, the JSON Schema (2020-12) of the `input` it takes. Build your request from it: required fields, allowed values and defaults are all there, and unknown fields are refused.\n\nNeeds an API key with the `generations:read` scope.","tags":["Models"],"parameters":["ff56eb3c-1c4c-49fd-b0fa-8d36022e0355","88451f95-32cc-4f45-8992-a3ad44198dbc"],"responses":{"200":"fdf521ac-7dc7-4b35-8d38-3fa7c581e6e8","400":"b1e9ff4f-394d-4530-9df2-197b98c3c404","401":"f7720b54-a3f0-4e69-b0a7-56ea0fe49ef1","403":"c4fa9585-7af9-4db4-bccb-c481cd2d436e","404":"a1585cb7-19d6-493f-9c89-fe234b2318f1","410":"02ff8eaf-6ce3-4483-a6e7-46423e09ba5a","429":"f965f126-bec5-4253-a3aa-42f0195564ff"},"method":"get","type":"path","servers":["f01f3dd6-cc2d-41e2-a009-e8c7b8d34abd"],"security":["8f394945-6e6a-438b-a713-b9b98ddec0d5","f875416d-92de-4b7b-ae9f-7c93b205b653"],"path":"/v1/models/{creator}/{name}","baseUrlOptions":["https://api.tryleap.ai"],"title":"Retrieve a model","codeSamples":[],"requestExampleLanguages":["bash","typescript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[],"urlDisplay":"full"},"dependencies":{"parameters":{"ff56eb3c-1c4c-49fd-b0fa-8d36022e0355":{"in":"path","name":"creator","schema":{"type":"string","description":"The first part of the model ID, such as `black-forest-labs` or `leap`.","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"The first part of the model ID, such as `black-forest-labs` or `leap`."},"88451f95-32cc-4f45-8992-a3ad44198dbc":{"in":"path","name":"name","schema":{"type":"string","description":"The second part, such as `flux-2-pro`, or `restore-photo@1` for a preset.","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"The second part, such as `flux-2-pro`, or `restore-photo@1` for a preset."}},"responses":{"fdf521ac-7dc7-4b35-8d38-3fa7c581e6e8":{"description":"The model and its input schema.","headers":{"X-Request-Id":{"required":true,"description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","schema":{"type":"string","description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","example":"req_01J9Z8Q4N2K7T5V3X6Y8B0C1D2"}},"RateLimit-Limit":{"required":true,"description":"Requests allowed per window from your client.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests allowed per window from your client.","example":300}},"RateLimit-Remaining":{"required":true,"description":"Requests left in the current window.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests left in the current window.","example":299}},"RateLimit-Reset":{"required":true,"description":"Seconds until the window resets.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Seconds until the window resets.","example":42}},"Deprecation":{"schema":{"type":"string","description":"Present when the model or preset is deprecated: when it was, as `@` and a Unix time (RFC 9745)."}},"Sunset":{"schema":{"type":"string","description":"Present when the model or preset is deprecated: the date it stops running, as an HTTP date (RFC 8594)."}},"Link":{"schema":{"type":"string","description":"For a deprecated model with a replacement: `\u003c/v1/models/{id}>; rel=\"successor-version\"`."}}},"content":{"application/json":{"example":{"id":"black-forest-labs/flux-2-pro","object":"model","type":"model","name":"FLUX.2 [pro]","creator":"Black Forest Labs","modality":"image","tasks":["text-to-image"],"description":"Black Forest Labs' second generation: sharper detail and text than FLUX1.1, at a lower price.","revision":"2026-10-02","version":null,"latest":true,"status":"stable","deprecation":null,"pricing":{"unit":"image","usd":"0.033","overrides":[],"drivers":["n"]},"input_schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"type":"string","pattern":"\\S"},"aspect_ratio":{"type":"string","enum":["1:1","3:2","2:3","4:3","3:4","16:9","9:16","21:9","9:21"],"default":"1:1"},"n":{"type":"integer","minimum":1,"maximum":4,"default":1},"seed":{"type":"integer","minimum":0,"maximum":4294967295}}}},"schema":{"type":"object","properties":{"id":{"type":"string","maxLength":100,"pattern":"^[a-z0-9][a-z0-9-]*\\/[a-z0-9][a-z0-9.-]*(@[1-9][0-9]{0,3})?$","description":"The ID to run it by: `creator/name` for a model, `leap/name@N` for a preset.","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","const":"model","isRequired":true,"uniqueKey":"object","typeLabel":"string"},"type":{"type":"string","enum":["model","preset"],"description":"`model` for a raw model, `preset` for a ready-made recipe built on one.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"Its display name.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"creator":{"type":"string","description":"Who made it.","isRequired":true,"uniqueKey":"creator","typeLabel":"string"},"modality":{"type":"string","enum":["image","video","audio","3d","text"],"description":"What it makes: `image`, `video`, `audio`, `3d` or `text`.","isRequired":true,"uniqueKey":"modality","typeLabel":"enum\u003cstring>"},"tasks":{"type":"array","items":{"type":"string","enum":["text-to-image","image-edit","outpaint","upscale-image","remove-background","try-on","text-to-video","image-to-video","video-to-video","upscale-video","lip-sync","talking-avatar","text-to-speech","voice-clone","text-to-music","sound-effects","image-to-3d","text-to-3d","video-to-audio","speech-to-speech","motion-transfer","speech-to-text","captions"],"uniqueKey":"tasks.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"What it does, main task first, such as `text-to-image` or `image-to-video`.","isRequired":true,"uniqueKey":"tasks","typeLabel":"enum\u003cstring>[]"},"description":{"type":"string","description":"What it's good at, in a sentence.","isRequired":true,"uniqueKey":"description","typeLabel":"string"},"revision":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"The date of its current schema and price.","isRequired":true,"uniqueKey":"revision","typeLabel":"string"},"version":{"oneOf":[{"type":"integer","description":"A preset's version, the `N` in `@N`; null for a model.","maximum":9007199254740991,"minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"version.oneOf.0","typeLabel":"integer"},{"type":"null","description":"A preset's version, the `N` in `@N`; null for a model.","isRequired":true,"uniqueKey":"version.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"version","typeLabel":"integer | null"},"latest":{"type":"boolean","description":"Whether a preset ID without `@N` runs this version. Always true for a model.","isRequired":true,"uniqueKey":"latest","typeLabel":"boolean"},"status":{"type":"string","enum":["preview","stable","deprecated","retired"],"description":"`preview` (may still change), `stable`, `deprecated` (runs until its sunset) or `retired` (doesn't run).","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"deprecation":{"oneOf":[{"type":"object","description":"When and why it's going away; null unless it's deprecated.","required":["deprecated_on","sunset","replaced_by","reason"],"properties":{"deprecated_on":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"When it was deprecated.","isRequired":true,"uniqueKey":"deprecation.oneOf.0.deprecated_on","typeLabel":"string"},"sunset":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"The day it stops running.","isRequired":true,"uniqueKey":"deprecation.oneOf.0.sunset","typeLabel":"string"},"replaced_by":{"oneOf":[{"description":"The model or preset to move to, if any.","type":"string","isRequired":true,"uniqueKey":"deprecation.oneOf.0.replaced_by.oneOf.0","typeLabel":"string"},{"description":"The model or preset to move to, if any.","type":"null","isRequired":true,"uniqueKey":"deprecation.oneOf.0.replaced_by.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deprecation.oneOf.0.replaced_by","typeLabel":"string | null"},"reason":{"type":"string","enum":["upstream_retired","superseded","discontinued"],"description":"Why it's going away.","isRequired":true,"uniqueKey":"deprecation.oneOf.0.reason","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"deprecation.oneOf.0","typeLabel":"object"},{"type":"null","description":"When and why it's going away; null unless it's deprecated.","isRequired":true,"uniqueKey":"deprecation.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deprecation","typeLabel":"object | null"},"pricing":{"type":"object","properties":{"unit":{"type":"string","enum":["image","megapixel","second","character","output","minute"],"isRequired":true,"uniqueKey":"pricing.unit","typeLabel":"enum\u003cstring>"},"usd":{"type":"string","isRequired":true,"uniqueKey":"pricing.usd","typeLabel":"string"},"overrides":{"default":[],"type":"array","items":{"type":"object","properties":{"when":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"pricing.overrides.items.[INDEX].when.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"number","uniqueKey":"pricing.overrides.items.[INDEX].when.additionalProperties.oneOf.1","typeLabel":"number"},{"type":"boolean","uniqueKey":"pricing.overrides.items.[INDEX].when.additionalProperties.oneOf.2","typeLabel":"boolean"}],"uniqueKey":"pricing.overrides.items.[INDEX].when.additionalProperties","typeLabel":"string | number | boolean"},"isRequired":true,"uniqueKey":"pricing.overrides.items.[INDEX].when","typeLabel":"object"},"usd":{"type":"string","isRequired":true,"uniqueKey":"pricing.overrides.items.[INDEX].usd","typeLabel":"string"}},"required":["when","usd"],"additionalProperties":false,"uniqueKey":"pricing.overrides.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"pricing.overrides","typeLabel":"object[]"},"drivers":{"type":"array","items":{"type":"string","uniqueKey":"pricing.drivers.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"pricing.drivers","typeLabel":"string[]"},"adds":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","required":["per","of","usd","overrides"],"properties":{"per":{"type":"string","const":"input_second","isRequired":true,"uniqueKey":"pricing.adds.items.[INDEX].oneOf.0.per","typeLabel":"string"},"of":{"minItems":1,"type":"array","items":{"type":"string","uniqueKey":"pricing.adds.items.[INDEX].oneOf.0.of.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"pricing.adds.items.[INDEX].oneOf.0.of","typeLabel":"string[]"},"usd":{"type":"string","isRequired":true,"uniqueKey":"pricing.adds.items.[INDEX].oneOf.0.usd","typeLabel":"string"},"overrides":{"default":[],"type":"array","items":{"type":"object","properties":{"when":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"pricing.adds.items.[INDEX].oneOf.0.overrides.items.[INDEX].when.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"number","uniqueKey":"pricing.adds.items.[INDEX].oneOf.0.overrides.items.[INDEX].when.additionalProperties.oneOf.1","typeLabel":"number"},{"type":"boolean","uniqueKey":"pricing.adds.items.[INDEX].oneOf.0.overrides.items.[INDEX].when.additionalProperties.oneOf.2","typeLabel":"boolean"}],"uniqueKey":"pricing.adds.items.[INDEX].oneOf.0.overrides.items.[INDEX].when.additionalProperties","typeLabel":"string | number | boolean"},"isRequired":true,"uniqueKey":"pricing.adds.items.[INDEX].oneOf.0.overrides.items.[INDEX].when","typeLabel":"object"},"usd":{"type":"string","isRequired":true,"uniqueKey":"pricing.adds.items.[INDEX].oneOf.0.overrides.items.[INDEX].usd","typeLabel":"string"}},"required":["when","usd"],"additionalProperties":false,"uniqueKey":"pricing.adds.items.[INDEX].oneOf.0.overrides.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"pricing.adds.items.[INDEX].oneOf.0.overrides","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"pricing.adds.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["per","over","usd"],"properties":{"per":{"type":"string","const":"prompt_character","isRequired":true,"uniqueKey":"pricing.adds.items.[INDEX].oneOf.1.per","typeLabel":"string"},"over":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"pricing.adds.items.[INDEX].oneOf.1.over","typeLabel":"integer"},"usd":{"type":"string","isRequired":true,"uniqueKey":"pricing.adds.items.[INDEX].oneOf.1.usd","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"pricing.adds.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"pricing.adds.items.[INDEX]","typeLabel":"object"},"uniqueKey":"pricing.adds","typeLabel":"object[]"},"length_of":{"type":"array","items":{"type":"string","uniqueKey":"pricing.length_of.items.[INDEX]","typeLabel":"string"},"uniqueKey":"pricing.length_of","typeLabel":"string[]"},"length_step":{"type":"number","exclusiveMinimum":0,"uniqueKey":"pricing.length_step","typeLabel":"number"}},"required":["unit","usd","overrides","drivers"],"additionalProperties":false,"isRequired":true,"uniqueKey":"pricing","typeLabel":"object"},"input_schema":{"type":"object","additionalProperties":true,"description":"A JSON Schema (2020-12) of the `input` it takes: required fields, types, allowed values and defaults. Unknown fields are refused, and a field that takes a file has the pattern `^file_[0-9A-Za-z]{24}$`.","isRequired":true,"uniqueKey":"input_schema","typeLabel":"object"},"added":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","uniqueKey":"added","typeLabel":"string"},"guide":{"type":"object","properties":{"hook":{"type":"string","isRequired":true,"uniqueKey":"guide.hook","typeLabel":"string"},"steps":{"type":"object","_tupleOriginal":true,"properties":{"[0]":{"type":"string","uniqueKey":"guide.steps.[0]","typeLabel":"string"},"[1]":{"type":"string","uniqueKey":"guide.steps.[1]","typeLabel":"string"},"[2]":{"type":"string","uniqueKey":"guide.steps.[2]","typeLabel":"string"}},"isRequired":true,"uniqueKey":"guide.steps","typeLabel":"tuple"},"next":{"type":"array","items":{"type":"string","maxLength":100,"pattern":"^[a-z0-9][a-z0-9-]*\\/[a-z0-9][a-z0-9.-]*(@[1-9][0-9]{0,3})?$","description":"The model to call, as creator/name. GET /v1/models lists them.","uniqueKey":"guide.next.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"guide.next","typeLabel":"string[]"},"poster":{"type":"object","properties":{"at":{"type":"number","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"guide.poster.at","typeLabel":"number"}},"required":["at"],"additionalProperties":false,"uniqueKey":"guide.poster","typeLabel":"object"}},"required":["hook","steps","next"],"additionalProperties":false,"uniqueKey":"guide","typeLabel":"object"},"outcome":{"description":"For a recipe sold as a finished set at one price: `title`, what you add (`uploads`), what you get (`gets`), how many images one run makes (`count`), and a recipe that makes a cheap first sample from the same upload (`sample`). Absent for the rest.","type":"object","properties":{"title":{"type":"string","isRequired":true,"uniqueKey":"outcome.title","typeLabel":"string"},"uploads":{"type":"string","isRequired":true,"uniqueKey":"outcome.uploads","typeLabel":"string"},"gets":{"type":"string","isRequired":true,"uniqueKey":"outcome.gets","typeLabel":"string"},"count":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"outcome.count","typeLabel":"integer"},"sample":{"type":"string","maxLength":100,"pattern":"^[a-z0-9][a-z0-9-]*\\/[a-z0-9][a-z0-9.-]*(@[1-9][0-9]{0,3})?$","description":"The model to call, as creator/name. GET /v1/models lists them.","uniqueKey":"outcome.sample","typeLabel":"string"}},"required":["title","uploads","gets","count"],"additionalProperties":false,"uniqueKey":"outcome","typeLabel":"object"},"cover":{"type":"object","properties":{"poster":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"cover.poster","typeLabel":"string\u003curi>"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"cover.width","typeLabel":"integer"},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"cover.height","typeLabel":"integer"},"alt":{"type":"string","isRequired":true,"uniqueKey":"cover.alt","typeLabel":"string"},"clip":{"type":"object","properties":{"mp4":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"cover.clip.mp4","typeLabel":"string\u003curi>"},"webm":{"type":"string","format":"uri","uniqueKey":"cover.clip.webm","typeLabel":"string\u003curi>"},"captions":{"type":"string","format":"uri","uniqueKey":"cover.clip.captions","typeLabel":"string\u003curi>"},"sound":{"type":"boolean","const":true,"uniqueKey":"cover.clip.sound","typeLabel":"boolean"}},"required":["mp4"],"additionalProperties":false,"uniqueKey":"cover.clip","typeLabel":"object"},"peak":{"type":"number","minimum":0,"uniqueKey":"cover.peak","typeLabel":"number"},"input":{"type":"object","properties":{"poster":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"cover.input.poster","typeLabel":"string\u003curi>"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"cover.input.width","typeLabel":"integer"},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"cover.input.height","typeLabel":"integer"},"alt":{"type":"string","isRequired":true,"uniqueKey":"cover.input.alt","typeLabel":"string"},"kept":{"type":"string","const":"product","uniqueKey":"cover.input.kept","typeLabel":"string"}},"required":["poster","width","height","alt"],"additionalProperties":false,"uniqueKey":"cover.input","typeLabel":"object"}},"required":["poster","width","height","alt"],"additionalProperties":false,"uniqueKey":"cover","typeLabel":"object"},"gallery":{"type":"array","items":{"type":"object","properties":{"poster":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"gallery.items.[INDEX].poster","typeLabel":"string\u003curi>"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"gallery.items.[INDEX].width","typeLabel":"integer"},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"gallery.items.[INDEX].height","typeLabel":"integer"},"alt":{"type":"string","isRequired":true,"uniqueKey":"gallery.items.[INDEX].alt","typeLabel":"string"},"clip":{"type":"object","properties":{"mp4":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"gallery.items.[INDEX].clip.mp4","typeLabel":"string\u003curi>"},"webm":{"type":"string","format":"uri","uniqueKey":"gallery.items.[INDEX].clip.webm","typeLabel":"string\u003curi>"},"captions":{"type":"string","format":"uri","uniqueKey":"gallery.items.[INDEX].clip.captions","typeLabel":"string\u003curi>"},"sound":{"type":"boolean","const":true,"uniqueKey":"gallery.items.[INDEX].clip.sound","typeLabel":"boolean"}},"required":["mp4"],"additionalProperties":false,"uniqueKey":"gallery.items.[INDEX].clip","typeLabel":"object"},"peak":{"type":"number","minimum":0,"uniqueKey":"gallery.items.[INDEX].peak","typeLabel":"number"},"input":{"type":"object","properties":{"poster":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"gallery.items.[INDEX].input.poster","typeLabel":"string\u003curi>"},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"gallery.items.[INDEX].input.width","typeLabel":"integer"},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"gallery.items.[INDEX].input.height","typeLabel":"integer"},"alt":{"type":"string","isRequired":true,"uniqueKey":"gallery.items.[INDEX].input.alt","typeLabel":"string"},"kept":{"type":"string","const":"product","uniqueKey":"gallery.items.[INDEX].input.kept","typeLabel":"string"}},"required":["poster","width","height","alt"],"additionalProperties":false,"uniqueKey":"gallery.items.[INDEX].input","typeLabel":"object"}},"required":["poster","width","height","alt"],"additionalProperties":false,"uniqueKey":"gallery.items.[INDEX]","typeLabel":"object"},"uniqueKey":"gallery","typeLabel":"object[]"},"photo":{"description":"For an effect: what its photo must show. `framing` is the least of the person it needs, `full` (head to toe), `waist` (waist up) or `face`; `setting` is `outdoor` when it needs sky or open ground around them, `any` otherwise. Check a photo against it with `POST /v1/photo-checks`.","type":"object","properties":{"framing":{"type":"string","enum":["full","waist","face"],"isRequired":true,"uniqueKey":"photo.framing","typeLabel":"enum\u003cstring>"},"setting":{"type":"string","enum":["outdoor","any"],"isRequired":true,"uniqueKey":"photo.setting","typeLabel":"enum\u003cstring>"}},"required":["framing","setting"],"additionalProperties":false,"uniqueKey":"photo","typeLabel":"object"},"still":{"description":"For a video recipe that makes a still from the photo first: the frame of the clip it becomes (`first_frame` or `last_frame`, or `images` for a storyboard sheet the clip follows as its first reference image, or `character_image` for the performer a reference clip moves), and whether it shows as the generation's `preview` while the clip renders (never for `images`). Absent for a recipe that makes none.","type":"object","properties":{"becomes":{"type":"string","enum":["first_frame","last_frame","images","character_image"],"isRequired":true,"uniqueKey":"still.becomes","typeLabel":"enum\u003cstring>"},"preview":{"type":"boolean","isRequired":true,"uniqueKey":"still.preview","typeLabel":"boolean"}},"required":["becomes","preview"],"additionalProperties":false,"uniqueKey":"still","typeLabel":"object"},"expected_seconds":{"description":"How long Leap's own runs of it took at its defaults, in seconds, from the request to the stored file. A hint for how long to wait, not a promise. Absent until Leap has timed one.","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"uniqueKey":"expected_seconds","typeLabel":"integer"},"first_image_free":{"description":"`true` for a picture whose first run, at its defaults, is free for a new person in the Leap studio: one image, once per person. A run started with an API key or over MCP is never free. Absent for everything else.","type":"boolean","const":true,"uniqueKey":"first_image_free","typeLabel":"boolean"}},"required":["id","object","type","name","creator","modality","tasks","description","revision","version","latest","status","deprecation","pricing","input_schema"],"additionalProperties":false,"description":"A model or preset with the JSON Schema of its input.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"black-forest-labs/flux-2-pro","object":"model","type":"model","name":"FLUX.2 [pro]","creator":"Black Forest Labs","modality":"image","tasks":["text-to-image"],"description":"Black Forest Labs' second generation: sharper detail and text than FLUX1.1, at a lower price.","revision":"2026-10-02","version":null,"latest":true,"status":"stable","deprecation":null,"pricing":{"unit":"image","usd":"0.033","overrides":[],"drivers":["n"]},"input_schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"type":"string","pattern":"\\S"},"aspect_ratio":{"type":"string","enum":["1:1","3:2","2:3","4:3","3:4","16:9","9:16","21:9","9:21"],"default":"1:1"},"n":{"type":"integer","minimum":1,"maximum":4,"default":1},"seed":{"type":"integer","minimum":0,"maximum":4294967295}}}}}},"exampleType":"examples"}},"exampleType":"examples"},"b1e9ff4f-394d-4530-9df2-197b98c3c404":{"description":"`conflicting_credentials`","headers":{"X-Request-Id":{"required":true,"description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","schema":{"type":"string","description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","example":"req_01J9Z8Q4N2K7T5V3X6Y8B0C1D2"}},"RateLimit-Limit":{"required":true,"description":"Requests allowed per window from your client.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests allowed per window from your client.","example":300}},"RateLimit-Remaining":{"required":true,"description":"Requests left in the current window.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests left in the current window.","example":299}},"RateLimit-Reset":{"required":true,"description":"Seconds until the window resets.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Seconds until the window resets.","example":42}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","rate_limit_error","authentication_error","permission_error","conflict_error","billing_error","api_error"],"description":"The kind of error. Branch on `type` and `code`, never on `message`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["invalid_parameter","invalid_request","conflicting_credentials","placeholder_in_path","method_not_allowed","payload_too_large","unsupported_media_type","ip_rate_limit_exceeded","authentication_required","missing_api_key","invalid_api_key","permission_denied","not_found","resource_not_found","gone","conflict","file_in_use","unpaid_failure_cap","photo_blocked","sexualized_real_person","rate_limit_exceeded","insufficient_credit","top_up_required","service_unavailable","internal_error"],"description":"A stable code for this error. Each one is explained at https://www.tryleap.ai/docs/errors.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"What went wrong, written for a person. It can change; don't parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"description":"For a `400`, the field at fault, such as `input.prompt`; otherwise null.","type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"description":"For a `400`, the field at fault, such as `input.prompt`; otherwise null.","type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"description":"A page that explains this error, when there is one.","type":"string","isRequired":true,"uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"description":"A page that explains this error, when there is one.","type":"null","isRequired":true,"uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"type":"string","description":"This request's ID, as in the `X-Request-Id` header. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"moderation_reason":{"description":"Only on `photo_blocked`: why the photo check refused the photo, `minor` (someone in it may be under 18) or `nudity`.","type":"string","enum":["minor","nudity"],"uniqueKey":"error.moderation_reason","typeLabel":"enum\u003cstring>"}},"required":["type","code","message","param","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"conflicting_credentials":{"title":"conflicting_credentials","value":{"error":{"type":"invalid_request_error","code":"conflicting_credentials","message":"Send one API key.","param":null,"doc_url":null,"request_id":"req_8kQ2vX9mR4tL6nB1cW3yZ5aD"}}}},"exampleType":"examples"}},"exampleType":"examples"},"f7720b54-a3f0-4e69-b0a7-56ea0fe49ef1":{"description":"`authentication_required`","headers":{"X-Request-Id":{"required":true,"description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","schema":{"type":"string","description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","example":"req_01J9Z8Q4N2K7T5V3X6Y8B0C1D2"}},"RateLimit-Limit":{"required":true,"description":"Requests allowed per window from your client.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests allowed per window from your client.","example":300}},"RateLimit-Remaining":{"required":true,"description":"Requests left in the current window.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests left in the current window.","example":299}},"RateLimit-Reset":{"required":true,"description":"Seconds until the window resets.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Seconds until the window resets.","example":42}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","rate_limit_error","authentication_error","permission_error","conflict_error","billing_error","api_error"],"description":"The kind of error. Branch on `type` and `code`, never on `message`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["invalid_parameter","invalid_request","conflicting_credentials","placeholder_in_path","method_not_allowed","payload_too_large","unsupported_media_type","ip_rate_limit_exceeded","authentication_required","missing_api_key","invalid_api_key","permission_denied","not_found","resource_not_found","gone","conflict","file_in_use","unpaid_failure_cap","photo_blocked","sexualized_real_person","rate_limit_exceeded","insufficient_credit","top_up_required","service_unavailable","internal_error"],"description":"A stable code for this error. Each one is explained at https://www.tryleap.ai/docs/errors.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"What went wrong, written for a person. It can change; don't parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"description":"For a `400`, the field at fault, such as `input.prompt`; otherwise null.","type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"description":"For a `400`, the field at fault, such as `input.prompt`; otherwise null.","type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"description":"A page that explains this error, when there is one.","type":"string","isRequired":true,"uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"description":"A page that explains this error, when there is one.","type":"null","isRequired":true,"uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"type":"string","description":"This request's ID, as in the `X-Request-Id` header. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"moderation_reason":{"description":"Only on `photo_blocked`: why the photo check refused the photo, `minor` (someone in it may be under 18) or `nudity`.","type":"string","enum":["minor","nudity"],"uniqueKey":"error.moderation_reason","typeLabel":"enum\u003cstring>"}},"required":["type","code","message","param","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"authentication_required":{"title":"authentication_required","value":{"error":{"type":"authentication_error","code":"authentication_required","message":"Authentication is required.","param":null,"doc_url":null,"request_id":"req_8kQ2vX9mR4tL6nB1cW3yZ5aD"}}}},"exampleType":"examples"}},"exampleType":"examples"},"c4fa9585-7af9-4db4-bccb-c481cd2d436e":{"description":"`permission_denied`","headers":{"X-Request-Id":{"required":true,"description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","schema":{"type":"string","description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","example":"req_01J9Z8Q4N2K7T5V3X6Y8B0C1D2"}},"RateLimit-Limit":{"required":true,"description":"Requests allowed per window from your client.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests allowed per window from your client.","example":300}},"RateLimit-Remaining":{"required":true,"description":"Requests left in the current window.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests left in the current window.","example":299}},"RateLimit-Reset":{"required":true,"description":"Seconds until the window resets.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Seconds until the window resets.","example":42}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","rate_limit_error","authentication_error","permission_error","conflict_error","billing_error","api_error"],"description":"The kind of error. Branch on `type` and `code`, never on `message`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["invalid_parameter","invalid_request","conflicting_credentials","placeholder_in_path","method_not_allowed","payload_too_large","unsupported_media_type","ip_rate_limit_exceeded","authentication_required","missing_api_key","invalid_api_key","permission_denied","not_found","resource_not_found","gone","conflict","file_in_use","unpaid_failure_cap","photo_blocked","sexualized_real_person","rate_limit_exceeded","insufficient_credit","top_up_required","service_unavailable","internal_error"],"description":"A stable code for this error. Each one is explained at https://www.tryleap.ai/docs/errors.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"What went wrong, written for a person. It can change; don't parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"description":"For a `400`, the field at fault, such as `input.prompt`; otherwise null.","type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"description":"For a `400`, the field at fault, such as `input.prompt`; otherwise null.","type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"description":"A page that explains this error, when there is one.","type":"string","isRequired":true,"uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"description":"A page that explains this error, when there is one.","type":"null","isRequired":true,"uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"type":"string","description":"This request's ID, as in the `X-Request-Id` header. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"moderation_reason":{"description":"Only on `photo_blocked`: why the photo check refused the photo, `minor` (someone in it may be under 18) or `nudity`.","type":"string","enum":["minor","nudity"],"uniqueKey":"error.moderation_reason","typeLabel":"enum\u003cstring>"}},"required":["type","code","message","param","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"permission_denied":{"title":"permission_denied","value":{"error":{"type":"permission_error","code":"permission_denied","message":"Permission denied.","param":null,"doc_url":null,"request_id":"req_8kQ2vX9mR4tL6nB1cW3yZ5aD"}}}},"exampleType":"examples"}},"exampleType":"examples"},"a1585cb7-19d6-493f-9c89-fe234b2318f1":{"description":"`resource_not_found`","headers":{"X-Request-Id":{"required":true,"description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","schema":{"type":"string","description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","example":"req_01J9Z8Q4N2K7T5V3X6Y8B0C1D2"}},"RateLimit-Limit":{"required":true,"description":"Requests allowed per window from your client.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests allowed per window from your client.","example":300}},"RateLimit-Remaining":{"required":true,"description":"Requests left in the current window.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests left in the current window.","example":299}},"RateLimit-Reset":{"required":true,"description":"Seconds until the window resets.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Seconds until the window resets.","example":42}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","rate_limit_error","authentication_error","permission_error","conflict_error","billing_error","api_error"],"description":"The kind of error. Branch on `type` and `code`, never on `message`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["invalid_parameter","invalid_request","conflicting_credentials","placeholder_in_path","method_not_allowed","payload_too_large","unsupported_media_type","ip_rate_limit_exceeded","authentication_required","missing_api_key","invalid_api_key","permission_denied","not_found","resource_not_found","gone","conflict","file_in_use","unpaid_failure_cap","photo_blocked","sexualized_real_person","rate_limit_exceeded","insufficient_credit","top_up_required","service_unavailable","internal_error"],"description":"A stable code for this error. Each one is explained at https://www.tryleap.ai/docs/errors.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"What went wrong, written for a person. It can change; don't parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"description":"For a `400`, the field at fault, such as `input.prompt`; otherwise null.","type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"description":"For a `400`, the field at fault, such as `input.prompt`; otherwise null.","type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"description":"A page that explains this error, when there is one.","type":"string","isRequired":true,"uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"description":"A page that explains this error, when there is one.","type":"null","isRequired":true,"uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"type":"string","description":"This request's ID, as in the `X-Request-Id` header. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"moderation_reason":{"description":"Only on `photo_blocked`: why the photo check refused the photo, `minor` (someone in it may be under 18) or `nudity`.","type":"string","enum":["minor","nudity"],"uniqueKey":"error.moderation_reason","typeLabel":"enum\u003cstring>"}},"required":["type","code","message","param","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"resource_not_found":{"title":"resource_not_found","value":{"error":{"type":"invalid_request_error","code":"resource_not_found","message":"That resource does not exist.","param":null,"doc_url":null,"request_id":"req_8kQ2vX9mR4tL6nB1cW3yZ5aD"}}}},"exampleType":"examples"}},"exampleType":"examples"},"02ff8eaf-6ce3-4483-a6e7-46423e09ba5a":{"description":"`gone`","headers":{"X-Request-Id":{"required":true,"description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","schema":{"type":"string","description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","example":"req_01J9Z8Q4N2K7T5V3X6Y8B0C1D2"}},"RateLimit-Limit":{"required":true,"description":"Requests allowed per window from your client.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests allowed per window from your client.","example":300}},"RateLimit-Remaining":{"required":true,"description":"Requests left in the current window.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests left in the current window.","example":299}},"RateLimit-Reset":{"required":true,"description":"Seconds until the window resets.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Seconds until the window resets.","example":42}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","rate_limit_error","authentication_error","permission_error","conflict_error","billing_error","api_error"],"description":"The kind of error. Branch on `type` and `code`, never on `message`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["invalid_parameter","invalid_request","conflicting_credentials","placeholder_in_path","method_not_allowed","payload_too_large","unsupported_media_type","ip_rate_limit_exceeded","authentication_required","missing_api_key","invalid_api_key","permission_denied","not_found","resource_not_found","gone","conflict","file_in_use","unpaid_failure_cap","photo_blocked","sexualized_real_person","rate_limit_exceeded","insufficient_credit","top_up_required","service_unavailable","internal_error"],"description":"A stable code for this error. Each one is explained at https://www.tryleap.ai/docs/errors.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"What went wrong, written for a person. It can change; don't parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"description":"For a `400`, the field at fault, such as `input.prompt`; otherwise null.","type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"description":"For a `400`, the field at fault, such as `input.prompt`; otherwise null.","type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"description":"A page that explains this error, when there is one.","type":"string","isRequired":true,"uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"description":"A page that explains this error, when there is one.","type":"null","isRequired":true,"uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"type":"string","description":"This request's ID, as in the `X-Request-Id` header. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"moderation_reason":{"description":"Only on `photo_blocked`: why the photo check refused the photo, `minor` (someone in it may be under 18) or `nudity`.","type":"string","enum":["minor","nudity"],"uniqueKey":"error.moderation_reason","typeLabel":"enum\u003cstring>"}},"required":["type","code","message","param","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"gone":{"title":"gone","value":{"error":{"type":"invalid_request_error","code":"gone","message":"That resource was retired.","param":null,"doc_url":null,"request_id":"req_8kQ2vX9mR4tL6nB1cW3yZ5aD"}}}},"exampleType":"examples"}},"exampleType":"examples"},"f965f126-bec5-4253-a3aa-42f0195564ff":{"description":"`rate_limit_exceeded`","headers":{"X-Request-Id":{"required":true,"description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","schema":{"type":"string","description":"This request's ID. Include it when you contact support; it's also `request_id` in an error.","example":"req_01J9Z8Q4N2K7T5V3X6Y8B0C1D2"}},"RateLimit-Limit":{"required":true,"description":"Requests allowed per window from your client.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests allowed per window from your client.","example":300}},"RateLimit-Remaining":{"required":true,"description":"Requests left in the current window.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Requests left in the current window.","example":299}},"RateLimit-Reset":{"required":true,"description":"Seconds until the window resets.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Seconds until the window resets.","example":42}},"Retry-After":{"required":true,"description":"Seconds to wait before you retry.","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Seconds to wait before you retry.","example":42}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","rate_limit_error","authentication_error","permission_error","conflict_error","billing_error","api_error"],"description":"The kind of error. Branch on `type` and `code`, never on `message`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["invalid_parameter","invalid_request","conflicting_credentials","placeholder_in_path","method_not_allowed","payload_too_large","unsupported_media_type","ip_rate_limit_exceeded","authentication_required","missing_api_key","invalid_api_key","permission_denied","not_found","resource_not_found","gone","conflict","file_in_use","unpaid_failure_cap","photo_blocked","sexualized_real_person","rate_limit_exceeded","insufficient_credit","top_up_required","service_unavailable","internal_error"],"description":"A stable code for this error. Each one is explained at https://www.tryleap.ai/docs/errors.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"What went wrong, written for a person. It can change; don't parse it.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"description":"For a `400`, the field at fault, such as `input.prompt`; otherwise null.","type":"string","isRequired":true,"uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"description":"For a `400`, the field at fault, such as `input.prompt`; otherwise null.","type":"null","isRequired":true,"uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"description":"A page that explains this error, when there is one.","type":"string","isRequired":true,"uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"description":"A page that explains this error, when there is one.","type":"null","isRequired":true,"uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.doc_url","typeLabel":"string | null"},"request_id":{"type":"string","description":"This request's ID, as in the `X-Request-Id` header. Include it when you contact support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"moderation_reason":{"description":"Only on `photo_blocked`: why the photo check refused the photo, `minor` (someone in it may be under 18) or `nudity`.","type":"string","enum":["minor","nudity"],"uniqueKey":"error.moderation_reason","typeLabel":"enum\u003cstring>"}},"required":["type","code","message","param","doc_url","request_id"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"rate_limit_exceeded":{"title":"rate_limit_exceeded","value":{"error":{"type":"rate_limit_error","code":"rate_limit_exceeded","message":"Too Many Requests","param":null,"doc_url":null,"request_id":"req_8kQ2vX9mR4tL6nB1cW3yZ5aD"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"8f394945-6e6a-438b-a713-b9b98ddec0d5":{"ApiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your workspace API key, `leap_...`. Create one at https://app.tryleap.ai/go/api, and keep it on your server.","scopes":[],"schemeName":"ApiKey"}},"f875416d-92de-4b7b-ae9f-7c93b205b653":{"Bearer":{"type":"http","scheme":"bearer","description":"The same API key as `Authorization: Bearer leap_...`, the way most HTTP clients and coding agents send one. Send one header or the other; two different keys are a `400`.","scopes":[],"schemeName":"Bearer"}}},"servers":{"f01f3dd6-cc2d-41e2-a009-e8c7b8d34abd":{"url":"https://api.tryleap.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your workspace API key, `leap_...`. Create one at https://app.tryleap.ai/go/api, and keep it on your server.","scopes":[],"schemeName":"ApiKey"},"schema":{"title":"x-api-key","type":"string","description":"Your workspace API key, `leap_...`. Create one at https://app.tryleap.ai/go/api, and keep it on your server.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKey","name":"x-api-key"}],"title":"ApiKey"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"The same API key as `Authorization: Bearer leap_...`, the way most HTTP clients and coding agents send one. Send one header or the other; two different keys are a `400`.","scopes":[],"schemeName":"Bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"The same API key as `Authorization: Bearer leap_...`, the way most HTTP clients and coding agents send one. Send one header or the other; two different keys are a `400`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"Bearer","name":"Authorization"}],"title":"Bearer"}]},"originalFileLocation":"openapi.json"},"subdomain":"leap-0e8117eb","siteName":"Leap","title":"Retrieve a model - Leap","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=\"One model or preset with input_schema, the JSON Schema (2020-12) of the input it takes. Build your request from it: required fields, allowed values and defaults are all there, and unknown fields are refused. Needs an API key with the generations:read scope.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Leap\">\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/leap-0e8117eb/i0HgQd8phxMdNawg/_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/leap-0e8117eb/i0HgQd8phxMdNawg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/leap-0e8117eb/i0HgQd8phxMdNawg/_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/leap-0e8117eb/i0HgQd8phxMdNawg/_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/leap-0e8117eb/i0HgQd8phxMdNawg/_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/leap-0e8117eb/i0HgQd8phxMdNawg/_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/leap-0e8117eb/i0HgQd8phxMdNawg/_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/leap-0e8117eb/i0HgQd8phxMdNawg/_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/leap-0e8117eb/i0HgQd8phxMdNawg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve a model - Leap\">\u003cmeta data-mint-head property=\"og:description\" content=\"One model or preset with input_schema, the JSON Schema (2020-12) of the input it takes. Build your request from it: required fields, allowed values and defaults are all there, and unknown fields are refused. Needs an API key with the generations:read scope.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Leap\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.tryleap.ai/docs/api-reference/models/retrieve-a-model\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://leap-0e8117eb.mintlify.site/docs/_mintlify/api/og/v2?division=Models\u0026amp;title=Retrieve+a+model\u0026amp;description=One+model+or+preset+with+%60input_schema%60%2C+the+JSON+Schema+%282020-12%29+of+the+%60input%60+it+takes.+Build+your+request+from+it%3A+required+fields%2C+allowed+values+and+defa\u0026amp;theme=04bb91a9020a32e360b3acb4\u0026amp;signature=8fcf86f69f6b66525a2c9d38cb8615109d4b3e96c0909b60512180036a74cb11\">\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 - Leap\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"One model or preset with input_schema, the JSON Schema (2020-12) of the input it takes. Build your request from it: required fields, allowed values and defaults are all there, and unknown fields are refused. Needs an API key with the generations:read scope.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://leap-0e8117eb.mintlify.site/docs/_mintlify/api/og/v2?division=Models\u0026amp;title=Retrieve+a+model\u0026amp;description=One+model+or+preset+with+%60input_schema%60%2C+the+JSON+Schema+%282020-12%29+of+the+%60input%60+it+takes.+Build+your+request+from+it%3A+required+fields%2C+allowed+values+and+defa\u0026amp;theme=04bb91a9020a32e360b3acb4\u0026amp;signature=8fcf86f69f6b66525a2c9d38cb8615109d4b3e96c0909b60512180036a74cb11\">\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/leap-0e8117eb/i0HgQd8phxMdNawg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Leap\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4F39F6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.tryleap.ai/docs/api-reference/models/retrieve-a-model\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/models/retrieve-a-model.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.tryleap.ai/#organization\",\"name\":\"Leap\",\"url\":\"https://www.tryleap.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://www.tryleap.ai/icon-512.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.tryleap.ai/docs#website\",\"name\":\"Leap\",\"url\":\"https://www.tryleap.ai/docs\",\"publisher\":{\"@id\":\"https://www.tryleap.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.tryleap.ai/docs/api-reference/models/retrieve-a-model#webpage\",\"url\":\"https://www.tryleap.ai/docs/api-reference/models/retrieve-a-model\",\"name\":\"Retrieve a model\",\"description\":\"One model or preset with input_schema, the JSON Schema (2020-12) of the input it takes. Build your request from it: required fields, allowed values and defaults are all there, and unknown fields are refused. Needs an API key with the generations:read scope.\",\"isPartOf\":{\"@id\":\"https://www.tryleap.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.tryleap.ai/docs/api-reference/models/retrieve-a-model#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.tryleap.ai/docs/api-reference/models/retrieve-a-model#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Models\",\"item\":\"https://www.tryleap.ai/docs/api-reference/models/list-models\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve a model\",\"item\":\"https://www.tryleap.ai/docs/api-reference/models/retrieve-a-model\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.tryleap.ai/docs/api-reference/models/retrieve-a-model#apireference\",\"headline\":\"Retrieve a model\",\"name\":\"Retrieve a model\",\"description\":\"One model or preset with input_schema, the JSON Schema (2020-12) of the input it takes. Build your request from it: required fields, allowed values and defaults are all there, and unknown fields are refused. Needs an API key with the generations:read scope.\",\"url\":\"https://www.tryleap.ai/docs/api-reference/models/retrieve-a-model\",\"mainEntityOfPage\":{\"@id\":\"https://www.tryleap.ai/docs/api-reference/models/retrieve-a-model#webpage\"},\"publisher\":{\"@id\":\"https://www.tryleap.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://www.tryleap.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Leap\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Leap\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/models/retrieve-a-model.md","siteName":"Leap","nav":{"global":{"anchors":[{"anchor":"Model catalog","icon":"sparkles","href":"https://www.tryleap.ai/models"},{"anchor":"Connect an agent","icon":"plug","href":"https://app.tryleap.ai/go/connect?utm_source=tryleap\u0026utm_medium=docs\u0026utm_campaign=%2Fdocs\u0026utm_content=anchor"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","icon":"book-open","pages":[{"title":"API reference","sidebarTitle":"Introduction","href":"/api-reference/introduction"}]},{"group":"Models","pages":[{"title":"List models","description":"Every model and preset your key can run, with its price, in one answer. Filter it on your side by `modality` or `tasks`. Read one model for the JSON Schema of its input.\n\nNeeds an API key with the `generations:read` scope.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/models","href":"/api-reference/models/list-models"},{"title":"Retrieve a model","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/models/{creator}/{name}","href":"/api-reference/models/retrieve-a-model"},{"title":"List models without a key","description":"The same catalog as `GET /v1/models`, for anyone: browse models and prices before you sign up.\n\nNo API key needed.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/public/models","href":"/api-reference/models/list-models-without-a-key"},{"title":"Retrieve a model without a key","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/public/models/{creator}/{name}","href":"/api-reference/models/retrieve-a-model-without-a-key"}]},{"group":"Quotes","pages":[{"title":"Create a quote","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/quotes","href":"/api-reference/quotes/create-a-quote"}]},{"group":"Generations","pages":[{"title":"List generations","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/generations","href":"/api-reference/generations/list-generations"},{"title":"Create a generation","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/generations","href":"/api-reference/generations/create-a-generation"},{"title":"Retrieve a generation","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/generations/{id}","href":"/api-reference/generations/retrieve-a-generation"},{"title":"Cancel a generation","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/generations/{id}/cancel","href":"/api-reference/generations/cancel-a-generation"},{"title":"Keep an output as a file","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/generations/{id}/outputs/{index}/file","href":"/api-reference/generations/keep-an-output-as-a-file"}]},{"group":"Batches","pages":[{"title":"Create a batch","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/batches","href":"/api-reference/batches/create-a-batch"},{"title":"Retrieve a batch","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/batches/{id}","href":"/api-reference/batches/retrieve-a-batch"}]},{"group":"Webhooks","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhook_endpoints","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhook_endpoints","href":"/api-reference/webhooks/create-a-webhook-endpoint"},{"title":"Retrieve a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhook_endpoints/{id}","href":"/api-reference/webhooks/retrieve-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/webhook_endpoints/{id}","href":"/api-reference/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/webhook_endpoints/{id}","href":"/api-reference/webhooks/update-a-webhook-endpoint"},{"title":"Rotate a webhook secret","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhook_endpoints/{id}/rotate_secret","href":"/api-reference/webhooks/rotate-a-webhook-secret"},{"title":"Send a test event","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhook_endpoints/{id}/test","href":"/api-reference/webhooks/send-a-test-event"},{"title":"Retrieve the default webhook secret","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/default/secret","href":"/api-reference/webhooks/retrieve-the-default-webhook-secret"}]},{"group":"Events","pages":[{"title":"List events","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/events","href":"/api-reference/events/list-events"},{"title":"Retrieve an event","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/events/{id}","href":"/api-reference/events/retrieve-an-event"},{"title":"List an event's deliveries","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/events/{id}/deliveries","href":"/api-reference/events/list-an-events-deliveries"},{"title":"Redeliver an event","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/events/{id}/redeliver","href":"/api-reference/events/redeliver-an-event"}]},{"group":"Files","pages":[{"title":"Upload an image","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/files","href":"/api-reference/files/upload-an-image"},{"title":"Retrieve a file","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/files/{id}","href":"/api-reference/files/retrieve-a-file"},{"title":"Delete a file","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/files/{id}","href":"/api-reference/files/delete-a-file"},{"title":"Start a video or sound upload","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/uploads","href":"/api-reference/files/start-a-video-or-sound-upload"},{"title":"Complete an upload","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/uploads/{id}/complete","href":"/api-reference/files/complete-an-upload"}]},{"group":"Characters","pages":[{"title":"List characters","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/characters","href":"/api-reference/characters/list-characters"},{"title":"Create a character","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/characters","href":"/api-reference/characters/create-a-character"},{"title":"Retrieve a character","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/characters/{id}","href":"/api-reference/characters/retrieve-a-character"},{"title":"Delete a character","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/characters/{id}","href":"/api-reference/characters/delete-a-character"},{"title":"Update a character","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/characters/{id}","href":"/api-reference/characters/update-a-character"}]},{"group":"Credits","pages":[{"title":"Retrieve your balance","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/credits","href":"/api-reference/credits/retrieve-your-balance"}]}]}]},"basePath":"","title":"Retrieve a model - Leap","deploymentId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","buildId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-tiVafkWW.js","utils-CURQcKis.js","cloneDeep-D7WNbvHt.js","_Uint8Array-BY_XlfVz.js","isObject-FP1Yky1u.js","utils-CdFTKPRO.js","addUniqueKeysToSchema-BSfwE63N.js","snippetPresets-BHyg8yZ0.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-CTsmHnLF.js","ApiExamples-CQdVXSju.js","isEqual-ft5OxoSH.js","usePlaygroundInputsStore-BILH4rrw.js","shallow-DterCiSU.js","getApiPlaygroundDisplay-uFtORr6j.js","CodeSnippet-BeuhEvUS.js","CodeSnippets-laCoJsvn.js","getPastedJson-DOT1n5Lt.js","icon-COH-nmcZ.js","MethodPill-BbAWkCf6.js","DuplicateIcon-CpagiAFQ.js","createIcon-Bw2Dnowf.js","DynamicMarkdown-DzuINhDe.js","SectionHeading-B3H20qI6.js","axios-vUo_bRtp.js","Markdown-DBdbz5B3.js","dist-DWEsd3cZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-DuX7jTnG.js"]}