curl --request POST \ --url https://nemonist.com/api/v1/images \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "bytedance-seed/seedream-4.5", "prompt": "a red panda astronaut floating in space, studio lighting"}'
import requests
url = "https://nemonist.com/api/v1/images"
payload = {
"model": "bytedance-seed/seedream-4.5",
"prompt": "a red panda astronaut floating in space, studio lighting"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'bytedance-seed/seedream-4.5',
prompt: 'a red panda astronaut floating in space, studio lighting'
})
};
fetch('https://nemonist.com/api/v1/images', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
Generates an image from a text prompt via the image generation router
POST
/
images
Generate an image
curl --request POST \ --url https://nemonist.com/api/v1/images \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "bytedance-seed/seedream-4.5", "prompt": "a red panda astronaut floating in space, studio lighting"}'
import requests
url = "https://nemonist.com/api/v1/images"
payload = {
"model": "bytedance-seed/seedream-4.5",
"prompt": "a red panda astronaut floating in space, studio lighting"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'bytedance-seed/seedream-4.5',
prompt: 'a red panda astronaut floating in space, studio lighting'
})
};
fetch('https://nemonist.com/api/v1/images', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
A Nemonist key (sk-nm-...) as a bearer token in the Authorization header.
Headers
HTTP-Referer
string
The app identifier should be your app's URL and is used as the primary identifier for rankings.
This is used to track API usage per application.
X-OpenRouter-Title
string
The app display name allows you to customize how your app appears in OpenRouter's dashboard.
X-OpenRouter-Categories
string
Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
Body
application/json
Image generation request input
model
string
required
The image generation model to use
Example:
"bytedance-seed/seedream-4.5"
prompt
string
required
Text description of the desired image
Minimum string length: 1
Example:
"a red panda astronaut floating in space, studio lighting"
aspect_ratio
enum<string>
Normalized aspect ratio of the generated image. Providers clamp to their supported subset.
Available options:
1:1,
1:2,
1:4,
1:8,
2:1,
2:3,
2.35:1,
3:2,
3:4,
4:1,
4:3,
4:5,
5:2,
5:4,
5:7,
7:5,
8:1,
9:16,
16:9,
9:19.5,
19.5:9,
9:20,
20:9,
9:21,
21:9,
auto
Example:
"16:9"
background
enum<string>
Background treatment. transparent requires an output_format that supports alpha (png or webp).
Available options:
auto,
transparent,
opaque
Example:
"auto"
input_references
object[]
Reference images to guide image-to-image generation, as base64 data URLs or HTTP(S) URLs.
Maximum array length: 16
Show child attributes
n
integer
Upper bound on the number of images to generate (1-10). Providers may return fewer images, and providers that only support single-image generation reject n > 1.
Example:
1
output_compression
integer
Compression level (0-100) for jpeg/webp output. Ignored by providers without a compression knob; providers that honor it may reject it with other output formats (e.g. OpenAI requires output_format "jpeg" or "webp").
Example:
100
output_format
enum<string>
Encoding of the returned image bytes. Most models produce raster formats (png, jpeg, webp). SVG is supported by vectorization models (e.g. Quiver) — the SVG markup is UTF-8 base64-encoded in b64_json.
Available options:
png,
jpeg,
webp,
svg
Example:
"png"
provider
object
Provider routing preferences and provider-specific passthrough configuration.
Rendering quality. Providers without a quality knob ignore this.
Available options:
auto,
low,
medium,
high,
xhigh,
max
Example:
"high"
resolution
enum<string>
Normalized resolution tier of the generated image. Concrete pixel dimensions are derived per-provider.
Available options:
512,
768,
1K,
1.5K,
2K,
4K
Example:
"2K"
seed
integer
If specified, the generation will sample deterministically, such that repeated requests with the same seed and parameters should return the same result. Determinism is not guaranteed for all providers.
session_id
string
A unique identifier for grouping related requests (e.g., a conversation or agent workflow). Used for observability grouping in Broadcast and private logging; never sent to the provider. If provided in both the request body and the x-session-id header, the body value takes precedence. Maximum of 256 characters.
Maximum string length: 256
Example:
"session-1234"
size
string
Optional. A convenience shorthand for output dimensions — pass a tier ("2K", "4K") or explicit pixels ("2048x2048"). A tier size is equivalent to setting resolution and combines with aspect_ratio. Explicit pixel sizes are provider-dependent: providers that accept them treat the value as authoritative and reject a mismatched resolution or aspect_ratio alongside it with a 400. xAI and Sourceful V2/V2.5 reject explicit pixel sizes (use resolution and aspect_ratio there); Sourceful V2.6 supports them within its dimension limits and does not allow combining them with resolution or aspect_ratio.
Example:
"2K"
stream
boolean
If true, partial images are streamed as SSE events as they become available. Only supported by providers with native streaming (currently OpenAI). Non-streaming providers ignore this flag and return a buffered response.
trace
object
Metadata for observability and tracing. Known keys (trace_id, trace_name, span_name, generation_name, parent_span_id) have special handling. Additional keys are passed through as custom metadata to configured broadcast destinations.
A stable identifier for your end-users. Used to help detect and prevent abuse. Never sent to providers verbatim: for providers whose data policy requires user IDs, it is folded into a hashed, per-account upstream user identifier.
Maximum string length: 256
Example:
"end-user-abc123"
Response
Image generation response
Image generation response
created
integer
required
Unix timestamp (seconds) when the image was generated
Example:
1748372400
data
object[]
required
Generated images
Show child attributes
usage
object
Token and cost usage for the image generation request, when available
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"nemonist","description":"Memory and learning for your coding agent, behind one OpenRouter-compatible URL.","colors":{"primary":"#6366f1","light":"#818cf8","dark":"#4f46e5"},"logo":{"light":"https://mintcdn.com/nemonist/O63iSHDIbHFIFLsR/logo/light.svg?fit=max\u0026auto=format\u0026n=O63iSHDIbHFIFLsR\u0026q=85\u0026s=78e0f2fecc2ad48dcf82fc4287a5dc8d","dark":"https://mintcdn.com/nemonist/O63iSHDIbHFIFLsR/logo/dark.svg?fit=max\u0026auto=format\u0026n=O63iSHDIbHFIFLsR\u0026q=85\u0026s=f51164f7521678900239881a908c13c6","href":"https://nemonist.com/"},"favicon":"https://mintcdn.com/nemonist/O63iSHDIbHFIFLsR/favicon.svg?fit=max\u0026auto=format\u0026n=O63iSHDIbHFIFLsR\u0026q=85\u0026s=b2688a9b65db5595cb13ad19c8f25c5a","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript"]}},"background":{"color":{"light":"#ffffff","dark":"#09090b"}},"navbar":{"links":[{"href":"https://nemonist.com/pricing","label":"Pricing"},{"href":"https://nemonist.com/models","label":"Models"}],"primary":{"type":"button","label":"Sign in","href":"https://nemonist.com/#signin"}},"footer":{"links":[{"header":"nemonist","items":[{"label":"Docs","href":"https://nemonist.com/docs"},{"label":"Pricing","href":"https://nemonist.com/pricing"},{"label":"Models","href":"https://nemonist.com/models"},{"label":"Providers","href":"https://nemonist.com/providers"},{"label":"Status","href":"https://nemonist.com/status"},{"label":"Privacy","href":"https://nemonist.com/privacy"},{"label":"Terms","href":"https://nemonist.com/terms"},{"label":"Support","href":"https://nemonist.com/support"}]}]},"seo":{"metatags":{"canonical":"https://nemonist.com/docs"}},"fonts":{"family":"Inter Variable","source":"https://nemonist.com/docs/fonts/inter.woff2","format":"woff2"},"contextual":{"options":["copy","view","chatgpt","claude","cursor"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nemonist","hasAudioNarration":false,"actualSubdomain":"nemonist","customDomains":["nemonist.com"],"gitSource":{"type":"github","owner":"ntwins-internal","repo":"nemonist-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6adbe103c87e3d756f7d1643"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6afe0e0df413882676535db2","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":132},{"language":"default","tag":"Folders","count":48},{"language":"default","tag":"Docs","count":21},{"language":"default","tag":"Clients","count":18},{"language":"default","tag":"Workspaces","count":12},{"language":"default","tag":"Concepts","count":10},{"language":"default","tag":"Guardrails","count":9},{"language":"default","tag":"Private Endpoints","count":9},{"language":"default","tag":"Model runs","count":8},{"language":"default","tag":"Enterprise","count":6}]},"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":false},"customCss":[{"filePath":"nemonist.css","content":"@font-face{font-family:\"JetBrains Mono Variable\";font-style:normal;font-display:swap;font-weight:100 900;src:url(\"https://nemonist.com/docs/fonts/jetbrains-mono.woff2\") format(\"woff2\")}code,pre,kbd,samp{font-family:\"JetBrains Mono Variable\", \"JetBrains Mono\", ui-monospace, SFMono-Regular, Menlo, monospace!important}h1,h2,h3,h4{font-family:\"Inter Tight Variable\", \"Inter Variable\", \"Inter\", ui-sans-serif, system-ui, sans-serif;letter-spacing:-.025em}#navbar img,pre,[class*=\"code-block\"]{box-shadow:none!important;filter:none!important}:root{--nm-bg: #ffffff;--nm-text: #09090b;--nm-text-muted: #71717a;--nm-text-faint: #a1a1aa;--nm-border: #e4e4e7;--nm-surface-hover: #f4f4f5}html.dark{--nm-bg: #09090b;--nm-text: #fafafa;--nm-text-muted: #a1a1aa;--nm-text-faint: #71717a;--nm-border: #27272a;--nm-surface-hover: #1c1c21}#navbar #navbar-transition{background:color-mix(in srgb, var(--nm-bg) 82%, transparent)!important;backdrop-filter:saturate(1.5) blur(12px);border-bottom:1px solid var(--nm-border)!important}#navbar .h-16{height:60px}#navbar .h-16>div{border-bottom:0!important}#navbar .nav-logo.h-7{height:22px!important}#navbar nav a,#navbar .nav-tabs a{font-size:13px;font-weight:500}#topbar-cta-button a{height:36px;padding:0 16px!important;border-radius:8px;font-size:13px;font-weight:500}#topbar-cta-button a>span:first-child{background:transparent!important;border-radius:inherit;transition:background var(--transition, 120ms ease)}#topbar-cta-button a:hover>span:first-child{background:var(--nm-surface-hover)!important}#topbar-cta-button a,#topbar-cta-button a .text-white,#topbar-cta-button a svg{color:var(--nm-text-muted)!important}#topbar-cta-button a:hover .text-white{color:var(--nm-text)!important}#topbar-cta-button a svg{display:none}html.nm-signed-in #topbar-cta-button a>span:first-child{background:var(--nm-text)!important}html.nm-signed-in #topbar-cta-button a,html.nm-signed-in #topbar-cta-button a .text-white{color:var(--nm-bg)!important}html.nm-signed-in #topbar-cta-button a:hover>span:first-child{background:var(--nm-text)!important;opacity:.85}#navbar nav:has(#topbar-cta-button),#navbar nav:has(#topbar-cta-button)>ul{display:contents}#navbar div:has(>#theme-preference-menu-trigger){order:1;margin-left:24px}#topbar-cta-button{order:2;margin-left:8px!important}#search-bar-entry,#assistant-entry{border-radius:8px!important}#footer{border-top:1px solid var(--nm-border)!important;font-size:13px;color:var(--nm-text-faint)}#footer>div{max-width:1120px!important;padding:24px 24px!important;gap:0!important}#footer>div>div:first-child{flex-direction:row!important;align-items:center}#footer>div>div:first-child>div:first-child{min-width:0!important;gap:0!important;flex-direction:row!important;align-items:center!important}#footer .nav-logo{height:18px!important}#footer>div>div:first-child>div:first-child::after{content:\"\\00a9 2026 nTwins, Inc.\";margin-left:12px;white-space:nowrap}#footer>div>div:first-child>div:last-child>div>div{flex-direction:row!important;justify-content:flex-start!important;flex-wrap:wrap;gap:8px 24px!important}#footer>div>div:first-child{flex-wrap:wrap;gap:16px!important}#footer>div>div:first-child>div:last-child{flex:0 1 auto!important;max-width:100%!important;display:flex!important}#footer a.text-sm{font-size:13px!important;color:var(--nm-text-muted)!important}#footer a.text-sm:hover{color:var(--nm-text)!important}#footer>div>div:nth-child(2),#footer>div>div:nth-child(3){display:none!important}#page-title{font-size:28px!important;font-weight:640!important;letter-spacing:-.03em!important;line-height:1.15!important}#page-title,#content h2,#content h3,#content h4{color:var(--nm-text)!important}#content{font-size:15px;line-height:1.6}#content h2{font-size:20px;font-weight:600}#content h3{font-size:16px;font-weight:600}#sidebar a{font-size:14px;border-radius:6px!important}#sidebar a[aria-current=page]{background:var(--nm-surface-hover)!important;color:var(--nm-text)!important;font-weight:500;text-shadow:none!important}"}],"page":{"pagePath":"api-reference/images/generate-an-image","slug":"/api-reference/images/generate-an-image","pageMetadata":{"title":"Generate an image","description":"Generates an image from a text prompt via the image generation router","deprecated":null,"version":null,"openapi":"/openapi.json post /images","href":"/api-reference/images/generate-an-image","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Generates an image from a text prompt via the image generation router\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Generate an image","description":"Generates an image from a text prompt via the image generation router","deprecated":null,"version":null,"openapi":"/openapi.json post /images","href":"/api-reference/images/generate-an-image","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/nemonist/5b5d33ba16a44814/nemonist.js"],"openApiReferenceData":{"operation":{"description":"Generates an image from a text prompt via the image generation router","operationId":"createImages","requestBody":"1860c82e-83e8-4e4f-ba2b-03a4771fdeee","responses":{"200":"8862d518-69c3-473a-9365-875b539a4b99","400":"3a206650-5d89-4bc2-aa0f-a74e7aeff3d4","401":"d4ba549c-b2e0-40e5-a431-05698cfda61a","402":"c2801951-9100-4d0b-ad5e-b634455a76e7","403":"0731c625-e1a7-47b9-ba65-7ea4c42ab5ae","404":"e5339725-67e9-433e-9ddd-c703ec7f5a9c","413":"f5ad2503-a888-44e5-b611-6118702d9567","429":"c6726412-0bc5-4e3a-918f-f6644a572297","500":"a4f6b1f5-3659-45b5-87b1-e682460c3ee0","502":"f4ffae2c-ad72-4739-be21-381ed27751d0","503":"63600094-4276-4046-99e7-0d84a8b0d704","524":"dc7c7df2-8835-4f13-b4cf-0ebf13a057a0","529":"c6cb4e6b-071b-4fb7-9df0-c16970791289"},"summary":"Generate an image","tags":["Images"],"x-speakeasy-name-override":"generate","method":"post","type":"path","servers":["f904a986-b1a7-4390-beb0-f994b9f6d9ad"],"security":["5c64c600-8820-448c-b999-87c9f6ba628f"],"path":"/images","baseUrlOptions":["https://nemonist.com/api/v1"],"title":"Generate an image","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"84a9520d-bae0-4fd0-bdcc-9bded1a8e0a0":{"name":"HTTP-Referer","in":"header","schema":{"type":"string","description":"The app identifier should be your app's URL and is used as the primary identifier for rankings.\nThis is used to track API usage per application.\n","uniqueKey":"","typeLabel":"string"},"description":"The app identifier should be your app's URL and is used as the primary identifier for rankings.\nThis is used to track API usage per application.\n"},"165fff68-799f-41f2-8b33-a117378cd20c":{"name":"X-OpenRouter-Title","in":"header","x-speakeasy-name-override":"appTitle","schema":{"type":"string","description":"The app display name allows you to customize how your app appears in OpenRouter's dashboard.\n","uniqueKey":"","typeLabel":"string"},"description":"The app display name allows you to customize how your app appears in OpenRouter's dashboard.\n"},"e3c20bf0-fb49-4c95-890a-6319d81c15d4":{"name":"X-OpenRouter-Categories","in":"header","x-speakeasy-name-override":"appCategories","schema":{"type":"string","description":"Comma-separated list of app categories (e.g. \"cli-agent,cloud-agent\"). Used for marketplace rankings.\n","uniqueKey":"","typeLabel":"string"},"description":"Comma-separated list of app categories (e.g. \"cli-agent,cloud-agent\"). Used for marketplace rankings.\n"}},"requestBody":{"content":{"application/json":{"example":{"model":"bytedance-seed/seedream-4.5","prompt":"a red panda astronaut floating in space, studio lighting"},"schema":{"description":"Image generation request input","example":{"model":"bytedance-seed/seedream-4.5","prompt":"a red panda astronaut floating in space, studio lighting"},"properties":{"model":{"description":"The image generation model to use","example":"bytedance-seed/seedream-4.5","type":"string","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"prompt":{"description":"Text description of the desired image","example":"a red panda astronaut floating in space, studio lighting","minLength":1,"type":"string","isRequired":true,"uniqueKey":"prompt","typeLabel":"string"},"aspect_ratio":{"description":"Normalized aspect ratio of the generated image. Providers clamp to their supported subset.","enum":["1:1","1:2","1:4","1:8","2:1","2:3","2.35:1","3:2","3:4","4:1","4:3","4:5","5:2","5:4","5:7","7:5","8:1","9:16","16:9","9:19.5","19.5:9","9:20","20:9","9:21","21:9","auto"],"example":"16:9","type":"string","x-speakeasy-unknown-values":"allow","uniqueKey":"aspect_ratio","typeLabel":"enum\u003cstring>"},"background":{"description":"Background treatment. `transparent` requires an output_format that supports alpha (png or webp).","enum":["auto","transparent","opaque"],"example":"auto","type":"string","x-speakeasy-unknown-values":"allow","uniqueKey":"background","typeLabel":"enum\u003cstring>"},"input_references":{"description":"Reference images to guide image-to-image generation, as base64 data URLs or HTTP(S) URLs.","items":{"example":{"image_url":{"url":"https://example.com/image.png"},"type":"image_url"},"properties":{"image_url":{"properties":{"url":{"type":"string","description":"The image's URL or base64 data URL.","isRequired":true,"uniqueKey":"input_references.items.[INDEX].image_url.url","typeLabel":"string"}},"required":["url"],"type":"object","description":"The image: an object whose url is the image's URL or base64 data URL.","isRequired":true,"uniqueKey":"input_references.items.[INDEX].image_url","typeLabel":"object"},"type":{"enum":["image_url"],"type":"string","description":"One of \"image_url\".","isRequired":true,"uniqueKey":"input_references.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"required":["type","image_url"],"type":"object","uniqueKey":"input_references.items.[INDEX]","typeLabel":"object"},"maxItems":16,"type":"array","uniqueKey":"input_references","typeLabel":"object[]"},"n":{"description":"Upper bound on the number of images to generate (1-10). Providers may return fewer images, and providers that only support single-image generation reject n > 1.","example":1,"type":"integer","uniqueKey":"n","typeLabel":"integer"},"output_compression":{"description":"Compression level (0-100) for jpeg/webp output. Ignored by providers without a compression knob; providers that honor it may reject it with other output formats (e.g. OpenAI requires output_format \"jpeg\" or \"webp\").","example":100,"type":"integer","uniqueKey":"output_compression","typeLabel":"integer"},"output_format":{"description":"Encoding of the returned image bytes. Most models produce raster formats (png, jpeg, webp). SVG is supported by vectorization models (e.g. Quiver) — the SVG markup is UTF-8 base64-encoded in `b64_json`.","enum":["png","jpeg","webp","svg"],"example":"png","type":"string","x-speakeasy-unknown-values":"allow","uniqueKey":"output_format","typeLabel":"enum\u003cstring>"},"provider":{"description":"Provider routing preferences and provider-specific passthrough configuration.","example":{"allow_fallbacks":false,"only":["google-ai-studio"]},"properties":{"allow_fallbacks":{"oneOf":[{"description":"Whether to allow backup providers to serve requests\n- true: (default) when the primary provider (or your custom providers in \"order\") is unavailable, use the next best provider.\n- false: use only the primary/custom provider, and return the upstream error if it's unavailable.\n","type":"boolean","uniqueKey":"provider.allow_fallbacks.oneOf.0","typeLabel":"boolean"},{"description":"Whether to allow backup providers to serve requests\n- true: (default) when the primary provider (or your custom providers in \"order\") is unavailable, use the next best provider.\n- false: use only the primary/custom provider, and return the upstream error if it's unavailable.\n","type":"null","uniqueKey":"provider.allow_fallbacks.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider.allow_fallbacks","typeLabel":"boolean | null"},"ignore":{"oneOf":[{"description":"List of provider slugs to ignore. If provided, this list is merged with your account-wide ignored provider settings for this request.","example":["openai","anthropic"],"items":{"oneOf":[{"type":"string","description":"The display name of the provider serving the endpoint, such as \"OpenAI\", \"Anthropic\", \"Google Vertex\" or \"Azure\". New providers appear over time, so accept names not listed here.","enum":["Modal","AkashML","AI21","AionLabs","Alibaba","Ambient","Ant Digital","Baidu","Amazon Bedrock","Amazon Nova","Anthropic","Arcee AI","AssemblyAI","AtlasCloud","Avian","Azure","BaseTen","BytePlus","Black Forest Labs","Cerebras","Chutes","Cirrascale","Claude Platform on AWS","Clarifai","Cloudflare","Cohere","CoreWeave","Cosine","Crucible","Crusoe","Darkbloom","Databricks","Decart","Deepgram","DeepInfra","DeepSeek","DekaLLM","DigitalOcean","ElevenLabs","Featherless","Fireworks","Fish Audio","Friendli","GMICloud","Google","Google AI Studio","Groq","HeyGen","Inception","Inceptron","InferenceNet","Ionstream","Infermatic","Io Net","Inferact vLLM","Inflection","KT","Liquid","Makora","Mara","Mancer 2","Meta","Minimax","ModelRun","Mistral","Modular","Moonshot AI","Morph","VoyageAI by MongoDB","TypeSafe","Near AI","Nebius","Nex AGI","NextBit","Novita","Nvidia","Ollama","OpenAI","OpenInference","Parallel","Parasail","ParetoAlpha","Particle AI","Pearl Research","Poolside","PrimaLabs","PrimeIntellect","Perceptron","Perplexity","Phala","Recraft","Recursive","Reka","Relace","Respan","Sail Research","Sakana AI","SambaNova","ScaleDown","Seed","SiliconFlow","Sourceful","StepFun","Stealth","StreamLake","Switchpoint","Tencent","Tenstorrent","Thinking Machines","Together","Unbiased","Upstage","Venice","Wafer","WandB","Quiver","Krea","Runway","Xiaomi","xAI","Z.AI","FakeProvider"],"x-speakeasy-unknown-values":"allow","example":"OpenAI","uniqueKey":"provider.ignore.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","uniqueKey":"provider.ignore.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"string"}],"uniqueKey":"provider.ignore.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring> | string"},"type":"array","uniqueKey":"provider.ignore.oneOf.0","typeLabel":"(enum\u003cstring> | string)[]"},{"description":"List of provider slugs to ignore. If provided, this list is merged with your account-wide ignored provider settings for this request.","example":["openai","anthropic"],"items":{"oneOf":[{"type":"string","description":"The display name of the provider serving the endpoint, such as \"OpenAI\", \"Anthropic\", \"Google Vertex\" or \"Azure\". New providers appear over time, so accept names not listed here.","enum":["Modal","AkashML","AI21","AionLabs","Alibaba","Ambient","Ant Digital","Baidu","Amazon Bedrock","Amazon Nova","Anthropic","Arcee AI","AssemblyAI","AtlasCloud","Avian","Azure","BaseTen","BytePlus","Black Forest Labs","Cerebras","Chutes","Cirrascale","Claude Platform on AWS","Clarifai","Cloudflare","Cohere","CoreWeave","Cosine","Crucible","Crusoe","Darkbloom","Databricks","Decart","Deepgram","DeepInfra","DeepSeek","DekaLLM","DigitalOcean","ElevenLabs","Featherless","Fireworks","Fish Audio","Friendli","GMICloud","Google","Google AI Studio","Groq","HeyGen","Inception","Inceptron","InferenceNet","Ionstream","Infermatic","Io Net","Inferact vLLM","Inflection","KT","Liquid","Makora","Mara","Mancer 2","Meta","Minimax","ModelRun","Mistral","Modular","Moonshot AI","Morph","VoyageAI by MongoDB","TypeSafe","Near AI","Nebius","Nex AGI","NextBit","Novita","Nvidia","Ollama","OpenAI","OpenInference","Parallel","Parasail","ParetoAlpha","Particle AI","Pearl Research","Poolside","PrimaLabs","PrimeIntellect","Perceptron","Perplexity","Phala","Recraft","Recursive","Reka","Relace","Respan","Sail Research","Sakana AI","SambaNova","ScaleDown","Seed","SiliconFlow","Sourceful","StepFun","Stealth","StreamLake","Switchpoint","Tencent","Tenstorrent","Thinking Machines","Together","Unbiased","Upstage","Venice","Wafer","WandB","Quiver","Krea","Runway","Xiaomi","xAI","Z.AI","FakeProvider"],"x-speakeasy-unknown-values":"allow","example":"OpenAI"},{"type":"string"}]},"type":"null","uniqueKey":"provider.ignore.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider.ignore","typeLabel":"(enum\u003cstring> | string)[] | null"},"only":{"oneOf":[{"description":"List of provider slugs to allow. If provided, this list is merged with your account-wide allowed provider settings for this request.","example":["openai","anthropic"],"items":{"oneOf":[{"type":"string","description":"The display name of the provider serving the endpoint, such as \"OpenAI\", \"Anthropic\", \"Google Vertex\" or \"Azure\". New providers appear over time, so accept names not listed here.","enum":["Modal","AkashML","AI21","AionLabs","Alibaba","Ambient","Ant Digital","Baidu","Amazon Bedrock","Amazon Nova","Anthropic","Arcee AI","AssemblyAI","AtlasCloud","Avian","Azure","BaseTen","BytePlus","Black Forest Labs","Cerebras","Chutes","Cirrascale","Claude Platform on AWS","Clarifai","Cloudflare","Cohere","CoreWeave","Cosine","Crucible","Crusoe","Darkbloom","Databricks","Decart","Deepgram","DeepInfra","DeepSeek","DekaLLM","DigitalOcean","ElevenLabs","Featherless","Fireworks","Fish Audio","Friendli","GMICloud","Google","Google AI Studio","Groq","HeyGen","Inception","Inceptron","InferenceNet","Ionstream","Infermatic","Io Net","Inferact vLLM","Inflection","KT","Liquid","Makora","Mara","Mancer 2","Meta","Minimax","ModelRun","Mistral","Modular","Moonshot AI","Morph","VoyageAI by MongoDB","TypeSafe","Near AI","Nebius","Nex AGI","NextBit","Novita","Nvidia","Ollama","OpenAI","OpenInference","Parallel","Parasail","ParetoAlpha","Particle AI","Pearl Research","Poolside","PrimaLabs","PrimeIntellect","Perceptron","Perplexity","Phala","Recraft","Recursive","Reka","Relace","Respan","Sail Research","Sakana AI","SambaNova","ScaleDown","Seed","SiliconFlow","Sourceful","StepFun","Stealth","StreamLake","Switchpoint","Tencent","Tenstorrent","Thinking Machines","Together","Unbiased","Upstage","Venice","Wafer","WandB","Quiver","Krea","Runway","Xiaomi","xAI","Z.AI","FakeProvider"],"x-speakeasy-unknown-values":"allow","example":"OpenAI","uniqueKey":"provider.only.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","uniqueKey":"provider.only.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"string"}],"uniqueKey":"provider.only.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring> | string"},"type":"array","uniqueKey":"provider.only.oneOf.0","typeLabel":"(enum\u003cstring> | string)[]"},{"description":"List of provider slugs to allow. If provided, this list is merged with your account-wide allowed provider settings for this request.","example":["openai","anthropic"],"items":{"oneOf":[{"type":"string","description":"The display name of the provider serving the endpoint, such as \"OpenAI\", \"Anthropic\", \"Google Vertex\" or \"Azure\". New providers appear over time, so accept names not listed here.","enum":["Modal","AkashML","AI21","AionLabs","Alibaba","Ambient","Ant Digital","Baidu","Amazon Bedrock","Amazon Nova","Anthropic","Arcee AI","AssemblyAI","AtlasCloud","Avian","Azure","BaseTen","BytePlus","Black Forest Labs","Cerebras","Chutes","Cirrascale","Claude Platform on AWS","Clarifai","Cloudflare","Cohere","CoreWeave","Cosine","Crucible","Crusoe","Darkbloom","Databricks","Decart","Deepgram","DeepInfra","DeepSeek","DekaLLM","DigitalOcean","ElevenLabs","Featherless","Fireworks","Fish Audio","Friendli","GMICloud","Google","Google AI Studio","Groq","HeyGen","Inception","Inceptron","InferenceNet","Ionstream","Infermatic","Io Net","Inferact vLLM","Inflection","KT","Liquid","Makora","Mara","Mancer 2","Meta","Minimax","ModelRun","Mistral","Modular","Moonshot AI","Morph","VoyageAI by MongoDB","TypeSafe","Near AI","Nebius","Nex AGI","NextBit","Novita","Nvidia","Ollama","OpenAI","OpenInference","Parallel","Parasail","ParetoAlpha","Particle AI","Pearl Research","Poolside","PrimaLabs","PrimeIntellect","Perceptron","Perplexity","Phala","Recraft","Recursive","Reka","Relace","Respan","Sail Research","Sakana AI","SambaNova","ScaleDown","Seed","SiliconFlow","Sourceful","StepFun","Stealth","StreamLake","Switchpoint","Tencent","Tenstorrent","Thinking Machines","Together","Unbiased","Upstage","Venice","Wafer","WandB","Quiver","Krea","Runway","Xiaomi","xAI","Z.AI","FakeProvider"],"x-speakeasy-unknown-values":"allow","example":"OpenAI"},{"type":"string"}]},"type":"null","uniqueKey":"provider.only.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider.only","typeLabel":"(enum\u003cstring> | string)[] | null"},"options":{"type":"object","description":"Options sent only to one provider, keyed by provider slug, e.g. {\"black-forest-labs\": {\"steps\": 40}}.","example":{"openai":{"max_tokens":1000},"black-forest-labs":{"guidance":3,"steps":40}},"properties":{"01ai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.01ai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the 01ai provider.","uniqueKey":"provider.options.01ai","typeLabel":"object"},"ai21":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.ai21.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the ai21 provider.","uniqueKey":"provider.options.ai21","typeLabel":"object"},"aion-labs":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.aion-labs.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the aion-labs provider.","uniqueKey":"provider.options.aion-labs","typeLabel":"object"},"akashml":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.akashml.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the akashml provider.","uniqueKey":"provider.options.akashml","typeLabel":"object"},"alibaba":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.alibaba.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the alibaba provider.","uniqueKey":"provider.options.alibaba","typeLabel":"object"},"amazon-bedrock":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.amazon-bedrock.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the amazon-bedrock provider.","uniqueKey":"provider.options.amazon-bedrock","typeLabel":"object"},"amazon-bedrock/claude-on-aws":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.amazon-bedrock/claude-on-aws.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the amazon-bedrock/claude-on-aws provider.","uniqueKey":"provider.options.amazon-bedrock/claude-on-aws","typeLabel":"object"},"amazon-nova":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.amazon-nova.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the amazon-nova provider.","uniqueKey":"provider.options.amazon-nova","typeLabel":"object"},"ambient":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.ambient.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the ambient provider.","uniqueKey":"provider.options.ambient","typeLabel":"object"},"antdigital":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.antdigital.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the antdigital provider.","uniqueKey":"provider.options.antdigital","typeLabel":"object"},"anthropic":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.anthropic.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the anthropic provider.","uniqueKey":"provider.options.anthropic","typeLabel":"object"},"anthropic/2":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.anthropic/2.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the anthropic/2 provider.","uniqueKey":"provider.options.anthropic/2","typeLabel":"object"},"anyscale":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.anyscale.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the anyscale provider.","uniqueKey":"provider.options.anyscale","typeLabel":"object"},"arcee-ai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.arcee-ai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the arcee-ai provider.","uniqueKey":"provider.options.arcee-ai","typeLabel":"object"},"assemblyai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.assemblyai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the assemblyai provider.","uniqueKey":"provider.options.assemblyai","typeLabel":"object"},"atlas-cloud":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.atlas-cloud.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the atlas-cloud provider.","uniqueKey":"provider.options.atlas-cloud","typeLabel":"object"},"atoma":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.atoma.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the atoma provider.","uniqueKey":"provider.options.atoma","typeLabel":"object"},"avian":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.avian.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the avian provider.","uniqueKey":"provider.options.avian","typeLabel":"object"},"azure":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.azure.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the azure provider.","uniqueKey":"provider.options.azure","typeLabel":"object"},"baidu":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.baidu.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the baidu provider.","uniqueKey":"provider.options.baidu","typeLabel":"object"},"baseten":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.baseten.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the baseten provider.","uniqueKey":"provider.options.baseten","typeLabel":"object"},"black-forest-labs":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.black-forest-labs.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the black-forest-labs provider.","uniqueKey":"provider.options.black-forest-labs","typeLabel":"object"},"byteplus":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.byteplus.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the byteplus provider.","uniqueKey":"provider.options.byteplus","typeLabel":"object"},"centml":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.centml.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the centml provider.","uniqueKey":"provider.options.centml","typeLabel":"object"},"cerebras":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.cerebras.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the cerebras provider.","uniqueKey":"provider.options.cerebras","typeLabel":"object"},"chutes":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.chutes.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the chutes provider.","uniqueKey":"provider.options.chutes","typeLabel":"object"},"cirrascale":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.cirrascale.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the cirrascale provider.","uniqueKey":"provider.options.cirrascale","typeLabel":"object"},"clarifai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.clarifai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the clarifai provider.","uniqueKey":"provider.options.clarifai","typeLabel":"object"},"claude-on-aws":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.claude-on-aws.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the claude-on-aws provider.","uniqueKey":"provider.options.claude-on-aws","typeLabel":"object"},"cloudflare":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.cloudflare.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the cloudflare provider.","uniqueKey":"provider.options.cloudflare","typeLabel":"object"},"cohere":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.cohere.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the cohere provider.","uniqueKey":"provider.options.cohere","typeLabel":"object"},"coreweave":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.coreweave.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the coreweave provider.","uniqueKey":"provider.options.coreweave","typeLabel":"object"},"cosine":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.cosine.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the cosine provider.","uniqueKey":"provider.options.cosine","typeLabel":"object"},"crofai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.crofai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the crofai provider.","uniqueKey":"provider.options.crofai","typeLabel":"object"},"crucible":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.crucible.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the crucible provider.","uniqueKey":"provider.options.crucible","typeLabel":"object"},"crusoe":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.crusoe.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the crusoe provider.","uniqueKey":"provider.options.crusoe","typeLabel":"object"},"darkbloom":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.darkbloom.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the darkbloom provider.","uniqueKey":"provider.options.darkbloom","typeLabel":"object"},"databricks":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.databricks.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the databricks provider.","uniqueKey":"provider.options.databricks","typeLabel":"object"},"decart":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.decart.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the decart provider.","uniqueKey":"provider.options.decart","typeLabel":"object"},"deepgram":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.deepgram.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the deepgram provider.","uniqueKey":"provider.options.deepgram","typeLabel":"object"},"deepinfra":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.deepinfra.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the deepinfra provider.","uniqueKey":"provider.options.deepinfra","typeLabel":"object"},"deepseek":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.deepseek.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the deepseek provider.","uniqueKey":"provider.options.deepseek","typeLabel":"object"},"dekallm":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.dekallm.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the dekallm provider.","uniqueKey":"provider.options.dekallm","typeLabel":"object"},"digitalocean":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.digitalocean.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the digitalocean provider.","uniqueKey":"provider.options.digitalocean","typeLabel":"object"},"elevenlabs":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.elevenlabs.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the elevenlabs provider.","uniqueKey":"provider.options.elevenlabs","typeLabel":"object"},"enfer":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.enfer.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the enfer provider.","uniqueKey":"provider.options.enfer","typeLabel":"object"},"fake-provider":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.fake-provider.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the fake-provider provider.","uniqueKey":"provider.options.fake-provider","typeLabel":"object"},"featherless":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.featherless.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the featherless provider.","uniqueKey":"provider.options.featherless","typeLabel":"object"},"fireworks":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.fireworks.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the fireworks provider.","uniqueKey":"provider.options.fireworks","typeLabel":"object"},"fish-audio":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.fish-audio.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the fish-audio provider.","uniqueKey":"provider.options.fish-audio","typeLabel":"object"},"friendli":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.friendli.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the friendli provider.","uniqueKey":"provider.options.friendli","typeLabel":"object"},"gmicloud":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.gmicloud.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the gmicloud provider.","uniqueKey":"provider.options.gmicloud","typeLabel":"object"},"google-ai-studio":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.google-ai-studio.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the google-ai-studio provider.","uniqueKey":"provider.options.google-ai-studio","typeLabel":"object"},"google-vertex":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.google-vertex.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the google-vertex provider.","uniqueKey":"provider.options.google-vertex","typeLabel":"object"},"gopomelo":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.gopomelo.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the gopomelo provider.","uniqueKey":"provider.options.gopomelo","typeLabel":"object"},"groq":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.groq.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the groq provider.","uniqueKey":"provider.options.groq","typeLabel":"object"},"heygen":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.heygen.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the heygen provider.","uniqueKey":"provider.options.heygen","typeLabel":"object"},"huggingface":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.huggingface.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the huggingface provider.","uniqueKey":"provider.options.huggingface","typeLabel":"object"},"hyperbolic":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.hyperbolic.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the hyperbolic provider.","uniqueKey":"provider.options.hyperbolic","typeLabel":"object"},"hyperbolic-quantized":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.hyperbolic-quantized.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the hyperbolic-quantized provider.","uniqueKey":"provider.options.hyperbolic-quantized","typeLabel":"object"},"inception":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.inception.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the inception provider.","uniqueKey":"provider.options.inception","typeLabel":"object"},"inceptron":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.inceptron.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the inceptron provider.","uniqueKey":"provider.options.inceptron","typeLabel":"object"},"inferact-vllm":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.inferact-vllm.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the inferact-vllm provider.","uniqueKey":"provider.options.inferact-vllm","typeLabel":"object"},"inference-net":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.inference-net.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the inference-net provider.","uniqueKey":"provider.options.inference-net","typeLabel":"object"},"infermatic":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.infermatic.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the infermatic provider.","uniqueKey":"provider.options.infermatic","typeLabel":"object"},"inflection":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.inflection.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the inflection provider.","uniqueKey":"provider.options.inflection","typeLabel":"object"},"inocloud":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.inocloud.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the inocloud provider.","uniqueKey":"provider.options.inocloud","typeLabel":"object"},"io-net":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.io-net.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the io-net provider.","uniqueKey":"provider.options.io-net","typeLabel":"object"},"ionstream":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.ionstream.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the ionstream provider.","uniqueKey":"provider.options.ionstream","typeLabel":"object"},"klusterai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.klusterai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the klusterai provider.","uniqueKey":"provider.options.klusterai","typeLabel":"object"},"krea":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.krea.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the krea provider.","uniqueKey":"provider.options.krea","typeLabel":"object"},"kt":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.kt.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the kt provider.","uniqueKey":"provider.options.kt","typeLabel":"object"},"lambda":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.lambda.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the lambda provider.","uniqueKey":"provider.options.lambda","typeLabel":"object"},"lepton":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.lepton.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the lepton provider.","uniqueKey":"provider.options.lepton","typeLabel":"object"},"liquid":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.liquid.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the liquid provider.","uniqueKey":"provider.options.liquid","typeLabel":"object"},"lynn":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.lynn.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the lynn provider.","uniqueKey":"provider.options.lynn","typeLabel":"object"},"lynn-private":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.lynn-private.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the lynn-private provider.","uniqueKey":"provider.options.lynn-private","typeLabel":"object"},"makora":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.makora.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the makora provider.","uniqueKey":"provider.options.makora","typeLabel":"object"},"mancer":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.mancer.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the mancer provider.","uniqueKey":"provider.options.mancer","typeLabel":"object"},"mancer-old":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.mancer-old.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the mancer-old provider.","uniqueKey":"provider.options.mancer-old","typeLabel":"object"},"mara":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.mara.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the mara provider.","uniqueKey":"provider.options.mara","typeLabel":"object"},"meta":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.meta.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the meta provider.","uniqueKey":"provider.options.meta","typeLabel":"object"},"minimax":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.minimax.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the minimax provider.","uniqueKey":"provider.options.minimax","typeLabel":"object"},"mistral":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.mistral.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the mistral provider.","uniqueKey":"provider.options.mistral","typeLabel":"object"},"modal":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.modal.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the modal provider.","uniqueKey":"provider.options.modal","typeLabel":"object"},"modelrun":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.modelrun.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the modelrun provider.","uniqueKey":"provider.options.modelrun","typeLabel":"object"},"modular":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.modular.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the modular provider.","uniqueKey":"provider.options.modular","typeLabel":"object"},"moonshotai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.moonshotai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the moonshotai provider.","uniqueKey":"provider.options.moonshotai","typeLabel":"object"},"morph":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.morph.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the morph provider.","uniqueKey":"provider.options.morph","typeLabel":"object"},"ncompass":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.ncompass.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the ncompass provider.","uniqueKey":"provider.options.ncompass","typeLabel":"object"},"near-ai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.near-ai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the near-ai provider.","uniqueKey":"provider.options.near-ai","typeLabel":"object"},"nebius":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.nebius.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the nebius provider.","uniqueKey":"provider.options.nebius","typeLabel":"object"},"nex-agi":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.nex-agi.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the nex-agi provider.","uniqueKey":"provider.options.nex-agi","typeLabel":"object"},"nextbit":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.nextbit.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the nextbit provider.","uniqueKey":"provider.options.nextbit","typeLabel":"object"},"nineteen":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.nineteen.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the nineteen provider.","uniqueKey":"provider.options.nineteen","typeLabel":"object"},"novita":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.novita.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the novita provider.","uniqueKey":"provider.options.novita","typeLabel":"object"},"nvidia":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.nvidia.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the nvidia provider.","uniqueKey":"provider.options.nvidia","typeLabel":"object"},"octoai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.octoai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the octoai provider.","uniqueKey":"provider.options.octoai","typeLabel":"object"},"ollama":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.ollama.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the ollama provider.","uniqueKey":"provider.options.ollama","typeLabel":"object"},"open-inference":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.open-inference.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the open-inference provider.","uniqueKey":"provider.options.open-inference","typeLabel":"object"},"openai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.openai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the openai provider.","uniqueKey":"provider.options.openai","typeLabel":"object"},"parallel":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.parallel.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the parallel provider.","uniqueKey":"provider.options.parallel","typeLabel":"object"},"parasail":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.parasail.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the parasail provider.","uniqueKey":"provider.options.parasail","typeLabel":"object"},"pareto-alpha":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.pareto-alpha.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the pareto-alpha provider.","uniqueKey":"provider.options.pareto-alpha","typeLabel":"object"},"particle-ai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.particle-ai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the particle-ai provider.","uniqueKey":"provider.options.particle-ai","typeLabel":"object"},"pearl-research":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.pearl-research.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the pearl-research provider.","uniqueKey":"provider.options.pearl-research","typeLabel":"object"},"perceptron":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.perceptron.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the perceptron provider.","uniqueKey":"provider.options.perceptron","typeLabel":"object"},"perplexity":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.perplexity.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the perplexity provider.","uniqueKey":"provider.options.perplexity","typeLabel":"object"},"phala":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.phala.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the phala provider.","uniqueKey":"provider.options.phala","typeLabel":"object"},"poolside":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.poolside.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the poolside provider.","uniqueKey":"provider.options.poolside","typeLabel":"object"},"primalabs":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.primalabs.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the primalabs provider.","uniqueKey":"provider.options.primalabs","typeLabel":"object"},"primeintellect":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.primeintellect.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the primeintellect provider.","uniqueKey":"provider.options.primeintellect","typeLabel":"object"},"quiver":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.quiver.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the quiver provider.","uniqueKey":"provider.options.quiver","typeLabel":"object"},"recraft":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.recraft.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the recraft provider.","uniqueKey":"provider.options.recraft","typeLabel":"object"},"recursal":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.recursal.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the recursal provider.","uniqueKey":"provider.options.recursal","typeLabel":"object"},"recursive":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.recursive.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the recursive provider.","uniqueKey":"provider.options.recursive","typeLabel":"object"},"reflection":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.reflection.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the reflection provider.","uniqueKey":"provider.options.reflection","typeLabel":"object"},"reka":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.reka.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the reka provider.","uniqueKey":"provider.options.reka","typeLabel":"object"},"relace":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.relace.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the relace provider.","uniqueKey":"provider.options.relace","typeLabel":"object"},"replicate":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.replicate.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the replicate provider.","uniqueKey":"provider.options.replicate","typeLabel":"object"},"respan":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.respan.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the respan provider.","uniqueKey":"provider.options.respan","typeLabel":"object"},"runway":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.runway.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the runway provider.","uniqueKey":"provider.options.runway","typeLabel":"object"},"sail-research":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.sail-research.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the sail-research provider.","uniqueKey":"provider.options.sail-research","typeLabel":"object"},"sakana":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.sakana.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the sakana provider.","uniqueKey":"provider.options.sakana","typeLabel":"object"},"sakana-ai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.sakana-ai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the sakana-ai provider.","uniqueKey":"provider.options.sakana-ai","typeLabel":"object"},"sambanova":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.sambanova.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the sambanova provider.","uniqueKey":"provider.options.sambanova","typeLabel":"object"},"sambanova-cloaked":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.sambanova-cloaked.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the sambanova-cloaked provider.","uniqueKey":"provider.options.sambanova-cloaked","typeLabel":"object"},"scaledown":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.scaledown.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the scaledown provider.","uniqueKey":"provider.options.scaledown","typeLabel":"object"},"seed":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.seed.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the seed provider.","uniqueKey":"provider.options.seed","typeLabel":"object"},"sf-compute":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.sf-compute.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the sf-compute provider.","uniqueKey":"provider.options.sf-compute","typeLabel":"object"},"siliconflow":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.siliconflow.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the siliconflow provider.","uniqueKey":"provider.options.siliconflow","typeLabel":"object"},"sourceful":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.sourceful.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the sourceful provider.","uniqueKey":"provider.options.sourceful","typeLabel":"object"},"stealth":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.stealth.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the stealth provider.","uniqueKey":"provider.options.stealth","typeLabel":"object"},"stepfun":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.stepfun.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the stepfun provider.","uniqueKey":"provider.options.stepfun","typeLabel":"object"},"streamlake":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.streamlake.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the streamlake provider.","uniqueKey":"provider.options.streamlake","typeLabel":"object"},"switchpoint":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.switchpoint.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the switchpoint provider.","uniqueKey":"provider.options.switchpoint","typeLabel":"object"},"targon":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.targon.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the targon provider.","uniqueKey":"provider.options.targon","typeLabel":"object"},"tencent":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.tencent.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the tencent provider.","uniqueKey":"provider.options.tencent","typeLabel":"object"},"tenstorrent":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.tenstorrent.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the tenstorrent provider.","uniqueKey":"provider.options.tenstorrent","typeLabel":"object"},"thinkingmachines":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.thinkingmachines.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the thinkingmachines provider.","uniqueKey":"provider.options.thinkingmachines","typeLabel":"object"},"together":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.together.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the together provider.","uniqueKey":"provider.options.together","typeLabel":"object"},"together-lite":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.together-lite.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the together-lite provider.","uniqueKey":"provider.options.together-lite","typeLabel":"object"},"typesafe":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.typesafe.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the typesafe provider.","uniqueKey":"provider.options.typesafe","typeLabel":"object"},"ubicloud":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.ubicloud.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the ubicloud provider.","uniqueKey":"provider.options.ubicloud","typeLabel":"object"},"unbiased":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.unbiased.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the unbiased provider.","uniqueKey":"provider.options.unbiased","typeLabel":"object"},"upstage":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.upstage.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the upstage provider.","uniqueKey":"provider.options.upstage","typeLabel":"object"},"venice":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.venice.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the venice provider.","uniqueKey":"provider.options.venice","typeLabel":"object"},"voyageai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.voyageai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the voyageai provider.","uniqueKey":"provider.options.voyageai","typeLabel":"object"},"wafer":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.wafer.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the wafer provider.","uniqueKey":"provider.options.wafer","typeLabel":"object"},"wandb":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.wandb.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the wandb provider.","uniqueKey":"provider.options.wandb","typeLabel":"object"},"wandb-legacy":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.wandb-legacy.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the wandb-legacy provider.","uniqueKey":"provider.options.wandb-legacy","typeLabel":"object"},"xai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.xai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the xai provider.","uniqueKey":"provider.options.xai","typeLabel":"object"},"xiaomi":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.xiaomi.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the xiaomi provider.","uniqueKey":"provider.options.xiaomi","typeLabel":"object"},"z-ai":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"provider.options.z-ai.additionalProperties","typeLabel":"any"},"type":"object","description":"Options sent only to the z-ai provider.","uniqueKey":"provider.options.z-ai","typeLabel":"object"}},"uniqueKey":"provider.options","typeLabel":"object"},"order":{"oneOf":[{"description":"An ordered list of provider slugs. The router will attempt to use the first provider in the subset of this list that supports your requested model, and fall back to the next if it is unavailable. If no providers are available, the request will fail with an error message.","example":["openai","anthropic"],"items":{"oneOf":[{"type":"string","description":"The display name of the provider serving the endpoint, such as \"OpenAI\", \"Anthropic\", \"Google Vertex\" or \"Azure\". New providers appear over time, so accept names not listed here.","enum":["Modal","AkashML","AI21","AionLabs","Alibaba","Ambient","Ant Digital","Baidu","Amazon Bedrock","Amazon Nova","Anthropic","Arcee AI","AssemblyAI","AtlasCloud","Avian","Azure","BaseTen","BytePlus","Black Forest Labs","Cerebras","Chutes","Cirrascale","Claude Platform on AWS","Clarifai","Cloudflare","Cohere","CoreWeave","Cosine","Crucible","Crusoe","Darkbloom","Databricks","Decart","Deepgram","DeepInfra","DeepSeek","DekaLLM","DigitalOcean","ElevenLabs","Featherless","Fireworks","Fish Audio","Friendli","GMICloud","Google","Google AI Studio","Groq","HeyGen","Inception","Inceptron","InferenceNet","Ionstream","Infermatic","Io Net","Inferact vLLM","Inflection","KT","Liquid","Makora","Mara","Mancer 2","Meta","Minimax","ModelRun","Mistral","Modular","Moonshot AI","Morph","VoyageAI by MongoDB","TypeSafe","Near AI","Nebius","Nex AGI","NextBit","Novita","Nvidia","Ollama","OpenAI","OpenInference","Parallel","Parasail","ParetoAlpha","Particle AI","Pearl Research","Poolside","PrimaLabs","PrimeIntellect","Perceptron","Perplexity","Phala","Recraft","Recursive","Reka","Relace","Respan","Sail Research","Sakana AI","SambaNova","ScaleDown","Seed","SiliconFlow","Sourceful","StepFun","Stealth","StreamLake","Switchpoint","Tencent","Tenstorrent","Thinking Machines","Together","Unbiased","Upstage","Venice","Wafer","WandB","Quiver","Krea","Runway","Xiaomi","xAI","Z.AI","FakeProvider"],"x-speakeasy-unknown-values":"allow","example":"OpenAI","uniqueKey":"provider.order.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","uniqueKey":"provider.order.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"string"}],"uniqueKey":"provider.order.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring> | string"},"type":"array","uniqueKey":"provider.order.oneOf.0","typeLabel":"(enum\u003cstring> | string)[]"},{"description":"An ordered list of provider slugs. The router will attempt to use the first provider in the subset of this list that supports your requested model, and fall back to the next if it is unavailable. If no providers are available, the request will fail with an error message.","example":["openai","anthropic"],"items":{"oneOf":[{"type":"string","description":"The display name of the provider serving the endpoint, such as \"OpenAI\", \"Anthropic\", \"Google Vertex\" or \"Azure\". New providers appear over time, so accept names not listed here.","enum":["Modal","AkashML","AI21","AionLabs","Alibaba","Ambient","Ant Digital","Baidu","Amazon Bedrock","Amazon Nova","Anthropic","Arcee AI","AssemblyAI","AtlasCloud","Avian","Azure","BaseTen","BytePlus","Black Forest Labs","Cerebras","Chutes","Cirrascale","Claude Platform on AWS","Clarifai","Cloudflare","Cohere","CoreWeave","Cosine","Crucible","Crusoe","Darkbloom","Databricks","Decart","Deepgram","DeepInfra","DeepSeek","DekaLLM","DigitalOcean","ElevenLabs","Featherless","Fireworks","Fish Audio","Friendli","GMICloud","Google","Google AI Studio","Groq","HeyGen","Inception","Inceptron","InferenceNet","Ionstream","Infermatic","Io Net","Inferact vLLM","Inflection","KT","Liquid","Makora","Mara","Mancer 2","Meta","Minimax","ModelRun","Mistral","Modular","Moonshot AI","Morph","VoyageAI by MongoDB","TypeSafe","Near AI","Nebius","Nex AGI","NextBit","Novita","Nvidia","Ollama","OpenAI","OpenInference","Parallel","Parasail","ParetoAlpha","Particle AI","Pearl Research","Poolside","PrimaLabs","PrimeIntellect","Perceptron","Perplexity","Phala","Recraft","Recursive","Reka","Relace","Respan","Sail Research","Sakana AI","SambaNova","ScaleDown","Seed","SiliconFlow","Sourceful","StepFun","Stealth","StreamLake","Switchpoint","Tencent","Tenstorrent","Thinking Machines","Together","Unbiased","Upstage","Venice","Wafer","WandB","Quiver","Krea","Runway","Xiaomi","xAI","Z.AI","FakeProvider"],"x-speakeasy-unknown-values":"allow","example":"OpenAI"},{"type":"string"}]},"type":"null","uniqueKey":"provider.order.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider.order","typeLabel":"(enum\u003cstring> | string)[] | null"},"sort":{"oneOf":[{"type":"string","description":"The sorting strategy to use for this request, if \"order\" is not specified. When set, no load balancing is performed.","enum":["price","throughput","latency","exacto"],"x-speakeasy-unknown-values":"allow","example":"price","uniqueKey":"provider.sort.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","description":"The sorting strategy to use for this request, if \"order\" is not specified. When set, no load balancing is performed.","example":"price","properties":{"by":{"oneOf":[{"description":"The provider sorting strategy (price, throughput, latency)","enum":["price","throughput","latency","exacto",null],"example":"price","type":"string","x-speakeasy-unknown-values":"allow","uniqueKey":"provider.sort.oneOf.1.by.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"The provider sorting strategy (price, throughput, latency)","enum":["price","throughput","latency","exacto",null],"example":"price","type":"null","x-speakeasy-unknown-values":"allow","uniqueKey":"provider.sort.oneOf.1.by.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider.sort.oneOf.1.by","typeLabel":"enum\u003cstring> | null"},"partition":{"oneOf":[{"description":"Partitioning strategy for sorting: \"model\" (default) groups endpoints by model before sorting (fallback models remain fallbacks), \"none\" sorts all endpoints together regardless of model.","enum":["model","none",null],"example":"model","type":"string","x-speakeasy-unknown-values":"allow","uniqueKey":"provider.sort.oneOf.1.partition.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"Partitioning strategy for sorting: \"model\" (default) groups endpoints by model before sorting (fallback models remain fallbacks), \"none\" sorts all endpoints together regardless of model.","enum":["model","none",null],"example":"model","type":"null","x-speakeasy-unknown-values":"allow","uniqueKey":"provider.sort.oneOf.1.partition.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider.sort.oneOf.1.partition","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"provider.sort.oneOf.1","typeLabel":"object"},{"type":"null","description":"The sorting strategy to use for this request, if \"order\" is not specified. When set, no load balancing is performed.","example":"price","uniqueKey":"provider.sort.oneOf.2","typeLabel":"null"}],"uniqueKey":"provider.sort","typeLabel":"enum\u003cstring> | object | null"}},"type":"object","uniqueKey":"provider","typeLabel":"object"},"quality":{"description":"Rendering quality. Providers without a quality knob ignore this.","enum":["auto","low","medium","high","xhigh","max"],"example":"high","type":"string","x-speakeasy-unknown-values":"allow","uniqueKey":"quality","typeLabel":"enum\u003cstring>"},"resolution":{"description":"Normalized resolution tier of the generated image. Concrete pixel dimensions are derived per-provider.","enum":["512","768","1K","1.5K","2K","4K"],"example":"2K","type":"string","x-speakeasy-unknown-values":"allow","uniqueKey":"resolution","typeLabel":"enum\u003cstring>"},"seed":{"description":"If specified, the generation will sample deterministically, such that repeated requests with the same seed and parameters should return the same result. Determinism is not guaranteed for all providers.","type":"integer","uniqueKey":"seed","typeLabel":"integer"},"session_id":{"description":"A unique identifier for grouping related requests (e.g., a conversation or agent workflow). Used for observability grouping in Broadcast and private logging; never sent to the provider. If provided in both the request body and the x-session-id header, the body value takes precedence. Maximum of 256 characters.","example":"session-1234","maxLength":256,"type":"string","uniqueKey":"session_id","typeLabel":"string"},"size":{"description":"Optional. A convenience shorthand for output dimensions — pass a tier (\"2K\", \"4K\") or explicit pixels (\"2048x2048\"). A tier size is equivalent to setting `resolution` and combines with `aspect_ratio`. Explicit pixel sizes are provider-dependent: providers that accept them treat the value as authoritative and reject a mismatched `resolution` or `aspect_ratio` alongside it with a 400. xAI and Sourceful V2/V2.5 reject explicit pixel sizes (use `resolution` and `aspect_ratio` there); Sourceful V2.6 supports them within its dimension limits and does not allow combining them with `resolution` or `aspect_ratio`.","example":"2K","type":"string","uniqueKey":"size","typeLabel":"string"},"stream":{"description":"If true, partial images are streamed as SSE events as they become available. Only supported by providers with native streaming (currently OpenAI). Non-streaming providers ignore this flag and return a buffered response.","type":"boolean","uniqueKey":"stream","typeLabel":"boolean"},"trace":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"trace.additionalProperties","typeLabel":"any"},"description":"Metadata for observability and tracing. Known keys (trace_id, trace_name, span_name, generation_name, parent_span_id) have special handling. Additional keys are passed through as custom metadata to configured broadcast destinations.","example":{"trace_id":"trace-abc123","trace_name":"my-app-trace"},"properties":{"generation_name":{"type":"string","description":"Name of this generation in your traces.","uniqueKey":"trace.generation_name","typeLabel":"string"},"parent_span_id":{"type":"string","description":"Span this generation nests under in your traces.","uniqueKey":"trace.parent_span_id","typeLabel":"string"},"span_name":{"type":"string","description":"Name of this span in your traces.","uniqueKey":"trace.span_name","typeLabel":"string"},"trace_id":{"type":"string","description":"Id of the trace this request belongs to.","uniqueKey":"trace.trace_id","typeLabel":"string"},"trace_name":{"type":"string","description":"Name of the trace in your traces.","uniqueKey":"trace.trace_name","typeLabel":"string"}},"type":"object","uniqueKey":"trace","typeLabel":"object"},"user":{"description":"A stable identifier for your end-users. Used to help detect and prevent abuse. Never sent to providers verbatim: for providers whose data policy requires user IDs, it is folded into a hashed, per-account upstream user identifier.","example":"end-user-abc123","maxLength":256,"type":"string","uniqueKey":"user","typeLabel":"string"}},"required":["model","prompt"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"model":"bytedance-seed/seedream-4.5","prompt":"a red panda astronaut floating in space, studio lighting"}}},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"8862d518-69c3-473a-9365-875b539a4b99":{"content":{"application/json":{"example":{"created":1748372400,"data":[{"b64_json":"\u003cbase64-encoded-image>"}],"usage":{"completion_tokens":4175,"cost":0.04,"prompt_tokens":0,"total_tokens":4175}},"schema":{"description":"Image generation response","example":{"created":1748372400,"data":[{"b64_json":"\u003cbase64-encoded-image>"}],"usage":{"completion_tokens":4175,"cost":0.04,"prompt_tokens":0,"total_tokens":4175}},"properties":{"created":{"description":"Unix timestamp (seconds) when the image was generated","example":1748372400,"type":"integer","isRequired":true,"uniqueKey":"created","typeLabel":"integer"},"data":{"description":"Generated images","items":{"properties":{"b64_json":{"description":"Base64-encoded image bytes","type":"string","isRequired":true,"uniqueKey":"data.items.[INDEX].b64_json","typeLabel":"string"},"media_type":{"description":"Media type (MIME type) of the image, e.g. `image/png`, `image/jpeg`, `image/webp`, `image/svg+xml`. May be omitted if the format could not be determined.","example":"image/png","type":"string","uniqueKey":"data.items.[INDEX].media_type","typeLabel":"string"}},"required":["b64_json"],"type":"object","uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"usage":{"description":"Token and cost usage for the image generation request, when available","example":{"completion_tokens":4175,"cost":0.04,"prompt_tokens":0,"total_tokens":4175},"properties":{"completion_tokens":{"description":"The tokens generated","type":"integer","isRequired":true,"uniqueKey":"usage.completion_tokens","typeLabel":"integer"},"prompt_tokens":{"description":"Including images, input audio, and tools if any","type":"integer","isRequired":true,"uniqueKey":"usage.prompt_tokens","typeLabel":"integer"},"total_tokens":{"description":"Sum of the above two fields","type":"integer","isRequired":true,"uniqueKey":"usage.total_tokens","typeLabel":"integer"},"cache_creation":{"oneOf":[{"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":100},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache.","isRequired":true,"uniqueKey":"usage.cache_creation.oneOf.0.ephemeral_1h_input_tokens","typeLabel":"integer"},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache.","isRequired":true,"uniqueKey":"usage.cache_creation.oneOf.0.ephemeral_5m_input_tokens","typeLabel":"integer"}},"required":["ephemeral_5m_input_tokens","ephemeral_1h_input_tokens"],"type":"object","description":"Input tokens written to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"usage.cache_creation.oneOf.0","typeLabel":"object"},{"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":100},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"required":["ephemeral_5m_input_tokens","ephemeral_1h_input_tokens"],"type":"null","description":"Input tokens written to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"usage.cache_creation.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.cache_creation","typeLabel":"object | null"},"completion_tokens_details":{"oneOf":[{"properties":{"audio_tokens":{"oneOf":[{"description":"Tokens generated by the model for audio output.","type":"integer","uniqueKey":"usage.completion_tokens_details.oneOf.0.audio_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens generated by the model for audio output.","type":"null","uniqueKey":"usage.completion_tokens_details.oneOf.0.audio_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.completion_tokens_details.oneOf.0.audio_tokens","typeLabel":"integer | null"},"image_tokens":{"oneOf":[{"description":"Tokens generated by the model for image output.","type":"integer","uniqueKey":"usage.completion_tokens_details.oneOf.0.image_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens generated by the model for image output.","type":"null","uniqueKey":"usage.completion_tokens_details.oneOf.0.image_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.completion_tokens_details.oneOf.0.image_tokens","typeLabel":"integer | null"},"reasoning_tokens":{"oneOf":[{"description":"Tokens generated by the model for reasoning.","type":"integer","uniqueKey":"usage.completion_tokens_details.oneOf.0.reasoning_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens generated by the model for reasoning.","type":"null","uniqueKey":"usage.completion_tokens_details.oneOf.0.reasoning_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.completion_tokens_details.oneOf.0.reasoning_tokens","typeLabel":"integer | null"}},"type":"object","description":"Output tokens split by kind: image, audio and reasoning.","uniqueKey":"usage.completion_tokens_details.oneOf.0","typeLabel":"object"},{"properties":{"audio_tokens":{"oneOf":[{"description":"Tokens generated by the model for audio output.","type":"integer"},{"description":"Tokens generated by the model for audio output.","type":"null"}]},"image_tokens":{"oneOf":[{"description":"Tokens generated by the model for image output.","type":"integer"},{"description":"Tokens generated by the model for image output.","type":"null"}]},"reasoning_tokens":{"oneOf":[{"description":"Tokens generated by the model for reasoning.","type":"integer"},{"description":"Tokens generated by the model for reasoning.","type":"null"}]}},"type":"null","description":"Output tokens split by kind: image, audio and reasoning.","uniqueKey":"usage.completion_tokens_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.completion_tokens_details","typeLabel":"object | null"},"cost":{"oneOf":[{"description":"Cost of the completion","format":"double","type":"number","uniqueKey":"usage.cost.oneOf.0","typeLabel":"number\u003cdouble>"},{"description":"Cost of the completion","format":"double","type":"null","uniqueKey":"usage.cost.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.cost","typeLabel":"number\u003cdouble> | null"},"cost_details":{"oneOf":[{"description":"Breakdown of upstream inference costs","example":{"upstream_inference_completions_cost":0.0004,"upstream_inference_cost":null,"upstream_inference_prompt_cost":0.0008},"properties":{"upstream_inference_completions_cost":{"format":"double","type":"number","description":"What the provider charged for output, in US dollars.","isRequired":true,"uniqueKey":"usage.cost_details.oneOf.0.upstream_inference_completions_cost","typeLabel":"number\u003cdouble>"},"upstream_inference_prompt_cost":{"format":"double","type":"number","description":"What the provider charged for input, in US dollars.","isRequired":true,"uniqueKey":"usage.cost_details.oneOf.0.upstream_inference_prompt_cost","typeLabel":"number\u003cdouble>"},"server_tool_cost":{"oneOf":[{"description":"Metered server-tool execution cost (for example, shell sandbox time) billed for this request, in USD. Matches the billed checkpoint and settlement amounts exactly. 0 when a metered server tool ran but settled at zero dollars; absent when no metered server tool ran.","format":"double","type":"number","uniqueKey":"usage.cost_details.oneOf.0.server_tool_cost.oneOf.0","typeLabel":"number\u003cdouble>"},{"description":"Metered server-tool execution cost (for example, shell sandbox time) billed for this request, in USD. Matches the billed checkpoint and settlement amounts exactly. 0 when a metered server tool ran but settled at zero dollars; absent when no metered server tool ran.","format":"double","type":"null","uniqueKey":"usage.cost_details.oneOf.0.server_tool_cost.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.cost_details.oneOf.0.server_tool_cost","typeLabel":"number\u003cdouble> | null"},"upstream_inference_cost":{"oneOf":[{"format":"double","type":"number","description":"What the provider charged for the request, in US dollars; null when not known.","uniqueKey":"usage.cost_details.oneOf.0.upstream_inference_cost.oneOf.0","typeLabel":"number\u003cdouble>"},{"format":"double","type":"null","description":"What the provider charged for the request, in US dollars; null when not known.","uniqueKey":"usage.cost_details.oneOf.0.upstream_inference_cost.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.cost_details.oneOf.0.upstream_inference_cost","typeLabel":"number\u003cdouble> | null"}},"required":["upstream_inference_prompt_cost","upstream_inference_completions_cost"],"type":"object","uniqueKey":"usage.cost_details.oneOf.0","typeLabel":"object"},{"description":"Breakdown of upstream inference costs","example":{"upstream_inference_completions_cost":0.0004,"upstream_inference_cost":null,"upstream_inference_prompt_cost":0.0008},"properties":{"server_tool_cost":{"oneOf":[{"description":"Metered server-tool execution cost (for example, shell sandbox time) billed for this request, in USD. Matches the billed checkpoint and settlement amounts exactly. 0 when a metered server tool ran but settled at zero dollars; absent when no metered server tool ran.","format":"double","type":"number"},{"description":"Metered server-tool execution cost (for example, shell sandbox time) billed for this request, in USD. Matches the billed checkpoint and settlement amounts exactly. 0 when a metered server tool ran but settled at zero dollars; absent when no metered server tool ran.","format":"double","type":"null"}]},"upstream_inference_completions_cost":{"format":"double","type":"number","description":"What the provider charged for output, in US dollars."},"upstream_inference_cost":{"oneOf":[{"format":"double","type":"number","description":"What the provider charged for the request, in US dollars; null when not known."},{"format":"double","type":"null","description":"What the provider charged for the request, in US dollars; null when not known."}]},"upstream_inference_prompt_cost":{"format":"double","type":"number","description":"What the provider charged for input, in US dollars."}},"required":["upstream_inference_prompt_cost","upstream_inference_completions_cost"],"type":"null","uniqueKey":"usage.cost_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.cost_details","typeLabel":"object | null"},"is_byok":{"description":"Whether a request was made using a Bring Your Own Key configuration","type":"boolean","uniqueKey":"usage.is_byok","typeLabel":"boolean"},"iterations":{"oneOf":[{"items":{"oneOf":[{"type":"object","required":["type"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"type":"message"},"properties":{"type":{"enum":["compaction"],"type":"string","description":"One of \"compaction\".","isRequired":true,"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_creation.oneOf.0.ephemeral_1h_input_tokens","typeLabel":"integer"},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_creation.oneOf.0.ephemeral_5m_input_tokens","typeLabel":"integer"}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_creation.oneOf.0","typeLabel":"object"},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_creation.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_creation","typeLabel":"object | null"},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_creation_input_tokens","typeLabel":"integer"},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_read_input_tokens","typeLabel":"integer"},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.0.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","description":"Output tokens this model call generated.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.0.output_tokens","typeLabel":"integer"}},"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"type":"message"},"properties":{"type":{"enum":["message"],"type":"string","description":"One of \"message\".","isRequired":true,"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_creation.oneOf.0.ephemeral_1h_input_tokens","typeLabel":"integer"},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_creation.oneOf.0.ephemeral_5m_input_tokens","typeLabel":"integer"}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_creation.oneOf.0","typeLabel":"object"},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_creation.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_creation","typeLabel":"object | null"},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_creation_input_tokens","typeLabel":"integer"},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_read_input_tokens","typeLabel":"integer"},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.1.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","description":"Output tokens this model call generated.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.1.output_tokens","typeLabel":"integer"},"model":{"type":"string","description":"Model that ran this iteration of the message.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.1.model","typeLabel":"string"}},"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","model"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"model":"claude-opus-4-6","type":"message"},"properties":{"model":{"type":"string","description":"Model the advisor used for this iteration.","isRequired":true,"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.2.model","typeLabel":"string"},"type":{"enum":["advisor_message"],"type":"string","description":"One of \"advisor_message\".","isRequired":true,"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_creation.oneOf.0.ephemeral_1h_input_tokens","typeLabel":"integer"},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_creation.oneOf.0.ephemeral_5m_input_tokens","typeLabel":"integer"}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_creation.oneOf.0","typeLabel":"object"},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_creation.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_creation","typeLabel":"object | null"},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_creation_input_tokens","typeLabel":"integer"},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_read_input_tokens","typeLabel":"integer"},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.2.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","description":"Output tokens this model call generated.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.2.output_tokens","typeLabel":"integer"}},"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"type":"message"},"properties":{"type":{"type":"string","description":"Kind of usage iteration, one this spec does not list.","isRequired":true,"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.3.type","typeLabel":"string"},"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_creation.oneOf.0.ephemeral_1h_input_tokens","typeLabel":"integer"},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_creation.oneOf.0.ephemeral_5m_input_tokens","typeLabel":"integer"}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_creation.oneOf.0","typeLabel":"object"},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_creation.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_creation","typeLabel":"object | null"},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_creation_input_tokens","typeLabel":"integer"},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_read_input_tokens","typeLabel":"integer"},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.3.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","description":"Output tokens this model call generated.","uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.3.output_tokens","typeLabel":"integer"}},"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX].oneOf.3","typeLabel":"object"}],"uniqueKey":"usage.iterations.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","description":"Usage of each model call the image generation made, or null.","uniqueKey":"usage.iterations.oneOf.0","typeLabel":"object[]"},{"items":{"oneOf":[{"type":"object","required":["type"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"type":"message"},"properties":{"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."}]},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache."},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache."},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes."},"output_tokens":{"type":"integer","description":"Output tokens this model call generated."},"type":{"enum":["compaction"],"type":"string","description":"One of \"compaction\"."}}},{"type":"object","required":["type"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"type":"message"},"properties":{"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."}]},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache."},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache."},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes."},"output_tokens":{"type":"integer","description":"Output tokens this model call generated."},"model":{"type":"string","description":"Model that ran this iteration of the message."},"type":{"enum":["message"],"type":"string","description":"One of \"message\"."}}},{"type":"object","required":["type","model"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"model":"claude-opus-4-6","type":"message"},"properties":{"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."}]},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache."},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache."},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes."},"output_tokens":{"type":"integer","description":"Output tokens this model call generated."},"model":{"type":"string","description":"Model the advisor used for this iteration."},"type":{"enum":["advisor_message"],"type":"string","description":"One of \"advisor_message\"."}}},{"type":"object","required":["type"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"type":"message"},"properties":{"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."}]},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache."},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache."},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes."},"output_tokens":{"type":"integer","description":"Output tokens this model call generated."},"type":{"type":"string","description":"Kind of usage iteration, one this spec does not list."}}}]},"type":"null","description":"Usage of each model call the image generation made, or null.","uniqueKey":"usage.iterations.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.iterations","typeLabel":"object[] | null"},"prompt_tokens_details":{"oneOf":[{"description":"Breakdown of tokens used in the prompt.","properties":{"audio_tokens":{"oneOf":[{"description":"Tokens used for input audio.","type":"integer","uniqueKey":"usage.prompt_tokens_details.oneOf.0.audio_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens used for input audio.","type":"null","uniqueKey":"usage.prompt_tokens_details.oneOf.0.audio_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.prompt_tokens_details.oneOf.0.audio_tokens","typeLabel":"integer | null"},"cache_write_tokens":{"oneOf":[{"description":"Tokens written to cache. Only returned for models with explicit caching and cache write pricing.","type":"integer","uniqueKey":"usage.prompt_tokens_details.oneOf.0.cache_write_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens written to cache. Only returned for models with explicit caching and cache write pricing.","type":"null","uniqueKey":"usage.prompt_tokens_details.oneOf.0.cache_write_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.prompt_tokens_details.oneOf.0.cache_write_tokens","typeLabel":"integer | null"},"cached_tokens":{"oneOf":[{"description":"Tokens cached by the endpoint.","type":"integer","uniqueKey":"usage.prompt_tokens_details.oneOf.0.cached_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens cached by the endpoint.","type":"null","uniqueKey":"usage.prompt_tokens_details.oneOf.0.cached_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.prompt_tokens_details.oneOf.0.cached_tokens","typeLabel":"integer | null"},"file_tokens":{"oneOf":[{"description":"Tokens used for input files/documents.","type":"integer","uniqueKey":"usage.prompt_tokens_details.oneOf.0.file_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens used for input files/documents.","type":"null","uniqueKey":"usage.prompt_tokens_details.oneOf.0.file_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.prompt_tokens_details.oneOf.0.file_tokens","typeLabel":"integer | null"},"video_tokens":{"oneOf":[{"description":"Tokens used for input video.","type":"integer","uniqueKey":"usage.prompt_tokens_details.oneOf.0.video_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens used for input video.","type":"null","uniqueKey":"usage.prompt_tokens_details.oneOf.0.video_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.prompt_tokens_details.oneOf.0.video_tokens","typeLabel":"integer | null"}},"type":"object","uniqueKey":"usage.prompt_tokens_details.oneOf.0","typeLabel":"object"},{"description":"Breakdown of tokens used in the prompt.","properties":{"audio_tokens":{"oneOf":[{"description":"Tokens used for input audio.","type":"integer"},{"description":"Tokens used for input audio.","type":"null"}]},"cache_write_tokens":{"oneOf":[{"description":"Tokens written to cache. Only returned for models with explicit caching and cache write pricing.","type":"integer"},{"description":"Tokens written to cache. Only returned for models with explicit caching and cache write pricing.","type":"null"}]},"cached_tokens":{"oneOf":[{"description":"Tokens cached by the endpoint.","type":"integer"},{"description":"Tokens cached by the endpoint.","type":"null"}]},"file_tokens":{"oneOf":[{"description":"Tokens used for input files/documents.","type":"integer"},{"description":"Tokens used for input files/documents.","type":"null"}]},"video_tokens":{"oneOf":[{"description":"Tokens used for input video.","type":"integer"},{"description":"Tokens used for input video.","type":"null"}]}},"type":"null","uniqueKey":"usage.prompt_tokens_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.prompt_tokens_details","typeLabel":"object | null"},"server_tool_use":{"oneOf":[{"description":"Usage for server-side tool execution (e.g., web search)","properties":{"tool_calls_executed":{"oneOf":[{"description":"Number of OpenRouter server tool calls that executed and produced a result.","type":"integer","uniqueKey":"usage.server_tool_use.oneOf.0.tool_calls_executed.oneOf.0","typeLabel":"integer"},{"description":"Number of OpenRouter server tool calls that executed and produced a result.","type":"null","uniqueKey":"usage.server_tool_use.oneOf.0.tool_calls_executed.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.server_tool_use.oneOf.0.tool_calls_executed","typeLabel":"integer | null"},"tool_calls_requested":{"oneOf":[{"description":"Total number of OpenRouter server-orchestrated tool calls the model requested, across all tool types. Provider-native tools (e.g. native web search) are not counted here.","type":"integer","uniqueKey":"usage.server_tool_use.oneOf.0.tool_calls_requested.oneOf.0","typeLabel":"integer"},{"description":"Total number of OpenRouter server-orchestrated tool calls the model requested, across all tool types. Provider-native tools (e.g. native web search) are not counted here.","type":"null","uniqueKey":"usage.server_tool_use.oneOf.0.tool_calls_requested.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.server_tool_use.oneOf.0.tool_calls_requested","typeLabel":"integer | null"},"web_search_requests":{"oneOf":[{"description":"Number of web searches performed by server-side tools. For server-orchestrated tool calls a web search is also counted in tool_calls_requested; provider-native web search may report web_search_requests only. Do not sum the two.","type":"integer","uniqueKey":"usage.server_tool_use.oneOf.0.web_search_requests.oneOf.0","typeLabel":"integer"},{"description":"Number of web searches performed by server-side tools. For server-orchestrated tool calls a web search is also counted in tool_calls_requested; provider-native web search may report web_search_requests only. Do not sum the two.","type":"null","uniqueKey":"usage.server_tool_use.oneOf.0.web_search_requests.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.server_tool_use.oneOf.0.web_search_requests","typeLabel":"integer | null"}},"type":"object","uniqueKey":"usage.server_tool_use.oneOf.0","typeLabel":"object"},{"description":"Usage for server-side tool execution (e.g., web search)","properties":{"tool_calls_executed":{"oneOf":[{"description":"Number of OpenRouter server tool calls that executed and produced a result.","type":"integer"},{"description":"Number of OpenRouter server tool calls that executed and produced a result.","type":"null"}]},"tool_calls_requested":{"oneOf":[{"description":"Total number of OpenRouter server-orchestrated tool calls the model requested, across all tool types. Provider-native tools (e.g. native web search) are not counted here.","type":"integer"},{"description":"Total number of OpenRouter server-orchestrated tool calls the model requested, across all tool types. Provider-native tools (e.g. native web search) are not counted here.","type":"null"}]},"web_search_requests":{"oneOf":[{"description":"Number of web searches performed by server-side tools. For server-orchestrated tool calls a web search is also counted in tool_calls_requested; provider-native web search may report web_search_requests only. Do not sum the two.","type":"integer"},{"description":"Number of web searches performed by server-side tools. For server-orchestrated tool calls a web search is also counted in tool_calls_requested; provider-native web search may report web_search_requests only. Do not sum the two.","type":"null"}]}},"type":"null","uniqueKey":"usage.server_tool_use.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.server_tool_use","typeLabel":"object | null"},"service_tier":{"oneOf":[{"description":"The service tier used by the upstream provider for this request","type":"string","uniqueKey":"usage.service_tier.oneOf.0","typeLabel":"string"},{"description":"The service tier used by the upstream provider for this request","type":"null","uniqueKey":"usage.service_tier.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.service_tier","typeLabel":"string | null"},"speed":{"oneOf":[{"enum":["fast","standard",null],"example":"standard","type":"string","x-speakeasy-unknown-values":"allow","description":"The output speed mode that served the request: \"fast\" (higher-speed inference, priced higher) or \"standard\"; null when not reported.","uniqueKey":"usage.speed.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["fast","standard",null],"example":"standard","type":"null","x-speakeasy-unknown-values":"allow","description":"The output speed mode that served the request: \"fast\" (higher-speed inference, priced higher) or \"standard\"; null when not reported.","uniqueKey":"usage.speed.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.speed","typeLabel":"enum\u003cstring> | null"}},"required":["prompt_tokens","completion_tokens","total_tokens"],"type":"object","uniqueKey":"usage","typeLabel":"object"}},"required":["created","data"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"created":1748372400,"data":[{"b64_json":"\u003cbase64-encoded-image>"}],"usage":{"completion_tokens":4175,"cost":0.04,"prompt_tokens":0,"total_tokens":4175}}}},"exampleType":"examples"},"text/event-stream":{"example":{"data":{"b64_json":"\u003cbase64-encoded-partial-image>","partial_image_index":0,"type":"image_generation.partial_image"}},"schema":{"example":{"data":{"b64_json":"\u003cbase64-encoded-partial-image>","partial_image_index":0,"type":"image_generation.partial_image"}},"properties":{"data":{"oneOf":[{"type":"object","description":"One streamed image event: a partial image, a text chunk, the completed image, or an error.","required":["type","partial_image_index","b64_json"],"example":{"b64_json":"\u003cbase64-encoded-partial-image>","partial_image_index":0,"type":"image_generation.partial_image"},"properties":{"b64_json":{"description":"Base64-encoded partial image data","type":"string","isRequired":true,"uniqueKey":"data.oneOf.0.b64_json","typeLabel":"string"},"partial_image_index":{"description":"0-based index indicating which partial image this is in the sequence","type":"integer","isRequired":true,"uniqueKey":"data.oneOf.0.partial_image_index","typeLabel":"integer"},"type":{"description":"The event type","enum":["image_generation.partial_image"],"type":"string","isRequired":true,"uniqueKey":"data.oneOf.0.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"object","description":"One streamed image event: a partial image, a text chunk, the completed image, or an error.","required":["type","text","phase"],"example":{"phase":"content","text":"\u003csvg xmlns=\"http://www.w3.org/2000/svg\">","type":"image_generation.text_chunk"},"properties":{"phase":{"description":"The generation phase this chunk belongs to. `content` is the renderable output; `reasoning` and `draft` are intermediate provider phases.","enum":["content","reasoning","draft"],"type":"string","x-speakeasy-unknown-values":"allow","isRequired":true,"uniqueKey":"data.oneOf.1.phase","typeLabel":"enum\u003cstring>"},"text":{"description":"A text fragment of the image being generated (e.g. partial SVG markup)","type":"string","isRequired":true,"uniqueKey":"data.oneOf.1.text","typeLabel":"string"},"type":{"description":"The event type","enum":["image_generation.text_chunk"],"type":"string","isRequired":true,"uniqueKey":"data.oneOf.1.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"object"},{"type":"object","description":"One streamed image event: a partial image, a text chunk, the completed image, or an error.","required":["type","b64_json","created"],"example":{"b64_json":"\u003cbase64-encoded-final-image>","created":1748372400,"type":"image_generation.completed","usage":{"completion_tokens":4175,"cost":0.04,"prompt_tokens":0,"total_tokens":4175}},"properties":{"b64_json":{"description":"Base64-encoded final image data","type":"string","isRequired":true,"uniqueKey":"data.oneOf.2.b64_json","typeLabel":"string"},"created":{"description":"Unix timestamp (seconds) when the image was generated","type":"integer","isRequired":true,"uniqueKey":"data.oneOf.2.created","typeLabel":"integer"},"type":{"description":"The event type","enum":["image_generation.completed"],"type":"string","isRequired":true,"uniqueKey":"data.oneOf.2.type","typeLabel":"enum\u003cstring>"},"media_type":{"description":"Media type (MIME type) of the image, e.g. `image/png`, `image/jpeg`, `image/webp`, `image/svg+xml`. May be omitted if the format could not be determined.","example":"image/png","type":"string","uniqueKey":"data.oneOf.2.media_type","typeLabel":"string"},"usage":{"description":"Token and cost usage for the image generation request, when available","example":{"completion_tokens":4175,"cost":0.04,"prompt_tokens":0,"total_tokens":4175},"properties":{"completion_tokens":{"description":"The tokens generated","type":"integer","isRequired":true,"uniqueKey":"data.oneOf.2.usage.completion_tokens","typeLabel":"integer"},"prompt_tokens":{"description":"Including images, input audio, and tools if any","type":"integer","isRequired":true,"uniqueKey":"data.oneOf.2.usage.prompt_tokens","typeLabel":"integer"},"total_tokens":{"description":"Sum of the above two fields","type":"integer","isRequired":true,"uniqueKey":"data.oneOf.2.usage.total_tokens","typeLabel":"integer"},"cache_creation":{"oneOf":[{"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":100},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache.","isRequired":true,"uniqueKey":"data.oneOf.2.usage.cache_creation.oneOf.0.ephemeral_1h_input_tokens","typeLabel":"integer"},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache.","isRequired":true,"uniqueKey":"data.oneOf.2.usage.cache_creation.oneOf.0.ephemeral_5m_input_tokens","typeLabel":"integer"}},"required":["ephemeral_5m_input_tokens","ephemeral_1h_input_tokens"],"type":"object","description":"Input tokens written to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"data.oneOf.2.usage.cache_creation.oneOf.0","typeLabel":"object"},{"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":100},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"required":["ephemeral_5m_input_tokens","ephemeral_1h_input_tokens"],"type":"null","description":"Input tokens written to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"data.oneOf.2.usage.cache_creation.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.cache_creation","typeLabel":"object | null"},"completion_tokens_details":{"oneOf":[{"properties":{"audio_tokens":{"oneOf":[{"description":"Tokens generated by the model for audio output.","type":"integer","uniqueKey":"data.oneOf.2.usage.completion_tokens_details.oneOf.0.audio_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens generated by the model for audio output.","type":"null","uniqueKey":"data.oneOf.2.usage.completion_tokens_details.oneOf.0.audio_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.completion_tokens_details.oneOf.0.audio_tokens","typeLabel":"integer | null"},"image_tokens":{"oneOf":[{"description":"Tokens generated by the model for image output.","type":"integer","uniqueKey":"data.oneOf.2.usage.completion_tokens_details.oneOf.0.image_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens generated by the model for image output.","type":"null","uniqueKey":"data.oneOf.2.usage.completion_tokens_details.oneOf.0.image_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.completion_tokens_details.oneOf.0.image_tokens","typeLabel":"integer | null"},"reasoning_tokens":{"oneOf":[{"description":"Tokens generated by the model for reasoning.","type":"integer","uniqueKey":"data.oneOf.2.usage.completion_tokens_details.oneOf.0.reasoning_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens generated by the model for reasoning.","type":"null","uniqueKey":"data.oneOf.2.usage.completion_tokens_details.oneOf.0.reasoning_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.completion_tokens_details.oneOf.0.reasoning_tokens","typeLabel":"integer | null"}},"type":"object","description":"Output tokens split by kind: image, audio and reasoning.","uniqueKey":"data.oneOf.2.usage.completion_tokens_details.oneOf.0","typeLabel":"object"},{"properties":{"audio_tokens":{"oneOf":[{"description":"Tokens generated by the model for audio output.","type":"integer"},{"description":"Tokens generated by the model for audio output.","type":"null"}]},"image_tokens":{"oneOf":[{"description":"Tokens generated by the model for image output.","type":"integer"},{"description":"Tokens generated by the model for image output.","type":"null"}]},"reasoning_tokens":{"oneOf":[{"description":"Tokens generated by the model for reasoning.","type":"integer"},{"description":"Tokens generated by the model for reasoning.","type":"null"}]}},"type":"null","description":"Output tokens split by kind: image, audio and reasoning.","uniqueKey":"data.oneOf.2.usage.completion_tokens_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.completion_tokens_details","typeLabel":"object | null"},"cost":{"oneOf":[{"description":"Cost of the completion","format":"double","type":"number","uniqueKey":"data.oneOf.2.usage.cost.oneOf.0","typeLabel":"number\u003cdouble>"},{"description":"Cost of the completion","format":"double","type":"null","uniqueKey":"data.oneOf.2.usage.cost.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.cost","typeLabel":"number\u003cdouble> | null"},"cost_details":{"oneOf":[{"description":"Breakdown of upstream inference costs","example":{"upstream_inference_completions_cost":0.0004,"upstream_inference_cost":null,"upstream_inference_prompt_cost":0.0008},"properties":{"upstream_inference_completions_cost":{"format":"double","type":"number","description":"What the provider charged for output, in US dollars.","isRequired":true,"uniqueKey":"data.oneOf.2.usage.cost_details.oneOf.0.upstream_inference_completions_cost","typeLabel":"number\u003cdouble>"},"upstream_inference_prompt_cost":{"format":"double","type":"number","description":"What the provider charged for input, in US dollars.","isRequired":true,"uniqueKey":"data.oneOf.2.usage.cost_details.oneOf.0.upstream_inference_prompt_cost","typeLabel":"number\u003cdouble>"},"server_tool_cost":{"oneOf":[{"description":"Metered server-tool execution cost (for example, shell sandbox time) billed for this request, in USD. Matches the billed checkpoint and settlement amounts exactly. 0 when a metered server tool ran but settled at zero dollars; absent when no metered server tool ran.","format":"double","type":"number","uniqueKey":"data.oneOf.2.usage.cost_details.oneOf.0.server_tool_cost.oneOf.0","typeLabel":"number\u003cdouble>"},{"description":"Metered server-tool execution cost (for example, shell sandbox time) billed for this request, in USD. Matches the billed checkpoint and settlement amounts exactly. 0 when a metered server tool ran but settled at zero dollars; absent when no metered server tool ran.","format":"double","type":"null","uniqueKey":"data.oneOf.2.usage.cost_details.oneOf.0.server_tool_cost.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.cost_details.oneOf.0.server_tool_cost","typeLabel":"number\u003cdouble> | null"},"upstream_inference_cost":{"oneOf":[{"format":"double","type":"number","description":"What the provider charged for the request, in US dollars; null when not known.","uniqueKey":"data.oneOf.2.usage.cost_details.oneOf.0.upstream_inference_cost.oneOf.0","typeLabel":"number\u003cdouble>"},{"format":"double","type":"null","description":"What the provider charged for the request, in US dollars; null when not known.","uniqueKey":"data.oneOf.2.usage.cost_details.oneOf.0.upstream_inference_cost.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.cost_details.oneOf.0.upstream_inference_cost","typeLabel":"number\u003cdouble> | null"}},"required":["upstream_inference_prompt_cost","upstream_inference_completions_cost"],"type":"object","uniqueKey":"data.oneOf.2.usage.cost_details.oneOf.0","typeLabel":"object"},{"description":"Breakdown of upstream inference costs","example":{"upstream_inference_completions_cost":0.0004,"upstream_inference_cost":null,"upstream_inference_prompt_cost":0.0008},"properties":{"server_tool_cost":{"oneOf":[{"description":"Metered server-tool execution cost (for example, shell sandbox time) billed for this request, in USD. Matches the billed checkpoint and settlement amounts exactly. 0 when a metered server tool ran but settled at zero dollars; absent when no metered server tool ran.","format":"double","type":"number"},{"description":"Metered server-tool execution cost (for example, shell sandbox time) billed for this request, in USD. Matches the billed checkpoint and settlement amounts exactly. 0 when a metered server tool ran but settled at zero dollars; absent when no metered server tool ran.","format":"double","type":"null"}]},"upstream_inference_completions_cost":{"format":"double","type":"number","description":"What the provider charged for output, in US dollars."},"upstream_inference_cost":{"oneOf":[{"format":"double","type":"number","description":"What the provider charged for the request, in US dollars; null when not known."},{"format":"double","type":"null","description":"What the provider charged for the request, in US dollars; null when not known."}]},"upstream_inference_prompt_cost":{"format":"double","type":"number","description":"What the provider charged for input, in US dollars."}},"required":["upstream_inference_prompt_cost","upstream_inference_completions_cost"],"type":"null","uniqueKey":"data.oneOf.2.usage.cost_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.cost_details","typeLabel":"object | null"},"is_byok":{"description":"Whether a request was made using a Bring Your Own Key configuration","type":"boolean","uniqueKey":"data.oneOf.2.usage.is_byok","typeLabel":"boolean"},"iterations":{"oneOf":[{"items":{"oneOf":[{"type":"object","required":["type"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"type":"message"},"properties":{"type":{"enum":["compaction"],"type":"string","description":"One of \"compaction\".","isRequired":true,"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_creation.oneOf.0.ephemeral_1h_input_tokens","typeLabel":"integer"},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_creation.oneOf.0.ephemeral_5m_input_tokens","typeLabel":"integer"}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_creation.oneOf.0","typeLabel":"object"},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_creation.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_creation","typeLabel":"object | null"},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_creation_input_tokens","typeLabel":"integer"},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.0.cache_read_input_tokens","typeLabel":"integer"},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.0.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","description":"Output tokens this model call generated.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.0.output_tokens","typeLabel":"integer"}},"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"type":"message"},"properties":{"type":{"enum":["message"],"type":"string","description":"One of \"message\".","isRequired":true,"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_creation.oneOf.0.ephemeral_1h_input_tokens","typeLabel":"integer"},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_creation.oneOf.0.ephemeral_5m_input_tokens","typeLabel":"integer"}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_creation.oneOf.0","typeLabel":"object"},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_creation.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_creation","typeLabel":"object | null"},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_creation_input_tokens","typeLabel":"integer"},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.1.cache_read_input_tokens","typeLabel":"integer"},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.1.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","description":"Output tokens this model call generated.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.1.output_tokens","typeLabel":"integer"},"model":{"type":"string","description":"Model that ran this iteration of the message.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.1.model","typeLabel":"string"}},"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","model"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"model":"claude-opus-4-6","type":"message"},"properties":{"model":{"type":"string","description":"Model the advisor used for this iteration.","isRequired":true,"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.2.model","typeLabel":"string"},"type":{"enum":["advisor_message"],"type":"string","description":"One of \"advisor_message\".","isRequired":true,"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_creation.oneOf.0.ephemeral_1h_input_tokens","typeLabel":"integer"},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_creation.oneOf.0.ephemeral_5m_input_tokens","typeLabel":"integer"}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_creation.oneOf.0","typeLabel":"object"},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_creation.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_creation","typeLabel":"object | null"},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_creation_input_tokens","typeLabel":"integer"},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.2.cache_read_input_tokens","typeLabel":"integer"},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.2.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","description":"Output tokens this model call generated.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.2.output_tokens","typeLabel":"integer"}},"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"type":"message"},"properties":{"type":{"type":"string","description":"Kind of usage iteration, one this spec does not list.","isRequired":true,"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.3.type","typeLabel":"string"},"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_creation.oneOf.0.ephemeral_1h_input_tokens","typeLabel":"integer"},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_creation.oneOf.0.ephemeral_5m_input_tokens","typeLabel":"integer"}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_creation.oneOf.0","typeLabel":"object"},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour).","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_creation.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_creation","typeLabel":"object | null"},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_creation_input_tokens","typeLabel":"integer"},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.3.cache_read_input_tokens","typeLabel":"integer"},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.3.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","description":"Output tokens this model call generated.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.3.output_tokens","typeLabel":"integer"}},"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX].oneOf.3","typeLabel":"object"}],"uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","description":"Usage of each model call the image generation made, or null.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.0","typeLabel":"object[]"},{"items":{"oneOf":[{"type":"object","required":["type"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"type":"message"},"properties":{"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."}]},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache."},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache."},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes."},"output_tokens":{"type":"integer","description":"Output tokens this model call generated."},"type":{"enum":["compaction"],"type":"string","description":"One of \"compaction\"."}}},{"type":"object","required":["type"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"type":"message"},"properties":{"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."}]},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache."},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache."},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes."},"output_tokens":{"type":"integer","description":"Output tokens this model call generated."},"model":{"type":"string","description":"Model that ran this iteration of the message."},"type":{"enum":["message"],"type":"string","description":"One of \"message\"."}}},{"type":"object","required":["type","model"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"model":"claude-opus-4-6","type":"message"},"properties":{"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."}]},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache."},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache."},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes."},"output_tokens":{"type":"integer","description":"Output tokens this model call generated."},"model":{"type":"string","description":"Model the advisor used for this iteration."},"type":{"enum":["advisor_message"],"type":"string","description":"One of \"advisor_message\"."}}},{"type":"object","required":["type"],"example":{"cache_creation":null,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"input_tokens":100,"output_tokens":50,"type":"message"},"properties":{"cache_creation":{"oneOf":[{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"object","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."},{"default":null,"example":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"properties":{"ephemeral_1h_input_tokens":{"type":"integer","description":"Input tokens written to the 1-hour prompt cache."},"ephemeral_5m_input_tokens":{"type":"integer","description":"Input tokens written to the 5-minute prompt cache."}},"type":"null","description":"Input tokens this iteration wrote to the prompt cache, split by cache lifetime (5-minute and 1-hour)."}]},"cache_creation_input_tokens":{"type":"integer","description":"Input tokens written to the prompt cache."},"cache_read_input_tokens":{"type":"integer","description":"Input tokens read from the prompt cache."},"input_tokens":{"type":"integer","description":"Input tokens this model call used, not counting cache reads or writes."},"output_tokens":{"type":"integer","description":"Output tokens this model call generated."},"type":{"type":"string","description":"Kind of usage iteration, one this spec does not list."}}}]},"type":"null","description":"Usage of each model call the image generation made, or null.","uniqueKey":"data.oneOf.2.usage.iterations.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.iterations","typeLabel":"object[] | null"},"prompt_tokens_details":{"oneOf":[{"description":"Breakdown of tokens used in the prompt.","properties":{"audio_tokens":{"oneOf":[{"description":"Tokens used for input audio.","type":"integer","uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.audio_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens used for input audio.","type":"null","uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.audio_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.audio_tokens","typeLabel":"integer | null"},"cache_write_tokens":{"oneOf":[{"description":"Tokens written to cache. Only returned for models with explicit caching and cache write pricing.","type":"integer","uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.cache_write_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens written to cache. Only returned for models with explicit caching and cache write pricing.","type":"null","uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.cache_write_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.cache_write_tokens","typeLabel":"integer | null"},"cached_tokens":{"oneOf":[{"description":"Tokens cached by the endpoint.","type":"integer","uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.cached_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens cached by the endpoint.","type":"null","uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.cached_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.cached_tokens","typeLabel":"integer | null"},"file_tokens":{"oneOf":[{"description":"Tokens used for input files/documents.","type":"integer","uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.file_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens used for input files/documents.","type":"null","uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.file_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.file_tokens","typeLabel":"integer | null"},"video_tokens":{"oneOf":[{"description":"Tokens used for input video.","type":"integer","uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.video_tokens.oneOf.0","typeLabel":"integer"},{"description":"Tokens used for input video.","type":"null","uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.video_tokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0.video_tokens","typeLabel":"integer | null"}},"type":"object","uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.0","typeLabel":"object"},{"description":"Breakdown of tokens used in the prompt.","properties":{"audio_tokens":{"oneOf":[{"description":"Tokens used for input audio.","type":"integer"},{"description":"Tokens used for input audio.","type":"null"}]},"cache_write_tokens":{"oneOf":[{"description":"Tokens written to cache. Only returned for models with explicit caching and cache write pricing.","type":"integer"},{"description":"Tokens written to cache. Only returned for models with explicit caching and cache write pricing.","type":"null"}]},"cached_tokens":{"oneOf":[{"description":"Tokens cached by the endpoint.","type":"integer"},{"description":"Tokens cached by the endpoint.","type":"null"}]},"file_tokens":{"oneOf":[{"description":"Tokens used for input files/documents.","type":"integer"},{"description":"Tokens used for input files/documents.","type":"null"}]},"video_tokens":{"oneOf":[{"description":"Tokens used for input video.","type":"integer"},{"description":"Tokens used for input video.","type":"null"}]}},"type":"null","uniqueKey":"data.oneOf.2.usage.prompt_tokens_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.prompt_tokens_details","typeLabel":"object | null"},"server_tool_use":{"oneOf":[{"description":"Usage for server-side tool execution (e.g., web search)","properties":{"tool_calls_executed":{"oneOf":[{"description":"Number of OpenRouter server tool calls that executed and produced a result.","type":"integer","uniqueKey":"data.oneOf.2.usage.server_tool_use.oneOf.0.tool_calls_executed.oneOf.0","typeLabel":"integer"},{"description":"Number of OpenRouter server tool calls that executed and produced a result.","type":"null","uniqueKey":"data.oneOf.2.usage.server_tool_use.oneOf.0.tool_calls_executed.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.server_tool_use.oneOf.0.tool_calls_executed","typeLabel":"integer | null"},"tool_calls_requested":{"oneOf":[{"description":"Total number of OpenRouter server-orchestrated tool calls the model requested, across all tool types. Provider-native tools (e.g. native web search) are not counted here.","type":"integer","uniqueKey":"data.oneOf.2.usage.server_tool_use.oneOf.0.tool_calls_requested.oneOf.0","typeLabel":"integer"},{"description":"Total number of OpenRouter server-orchestrated tool calls the model requested, across all tool types. Provider-native tools (e.g. native web search) are not counted here.","type":"null","uniqueKey":"data.oneOf.2.usage.server_tool_use.oneOf.0.tool_calls_requested.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.server_tool_use.oneOf.0.tool_calls_requested","typeLabel":"integer | null"},"web_search_requests":{"oneOf":[{"description":"Number of web searches performed by server-side tools. For server-orchestrated tool calls a web search is also counted in tool_calls_requested; provider-native web search may report web_search_requests only. Do not sum the two.","type":"integer","uniqueKey":"data.oneOf.2.usage.server_tool_use.oneOf.0.web_search_requests.oneOf.0","typeLabel":"integer"},{"description":"Number of web searches performed by server-side tools. For server-orchestrated tool calls a web search is also counted in tool_calls_requested; provider-native web search may report web_search_requests only. Do not sum the two.","type":"null","uniqueKey":"data.oneOf.2.usage.server_tool_use.oneOf.0.web_search_requests.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.server_tool_use.oneOf.0.web_search_requests","typeLabel":"integer | null"}},"type":"object","uniqueKey":"data.oneOf.2.usage.server_tool_use.oneOf.0","typeLabel":"object"},{"description":"Usage for server-side tool execution (e.g., web search)","properties":{"tool_calls_executed":{"oneOf":[{"description":"Number of OpenRouter server tool calls that executed and produced a result.","type":"integer"},{"description":"Number of OpenRouter server tool calls that executed and produced a result.","type":"null"}]},"tool_calls_requested":{"oneOf":[{"description":"Total number of OpenRouter server-orchestrated tool calls the model requested, across all tool types. Provider-native tools (e.g. native web search) are not counted here.","type":"integer"},{"description":"Total number of OpenRouter server-orchestrated tool calls the model requested, across all tool types. Provider-native tools (e.g. native web search) are not counted here.","type":"null"}]},"web_search_requests":{"oneOf":[{"description":"Number of web searches performed by server-side tools. For server-orchestrated tool calls a web search is also counted in tool_calls_requested; provider-native web search may report web_search_requests only. Do not sum the two.","type":"integer"},{"description":"Number of web searches performed by server-side tools. For server-orchestrated tool calls a web search is also counted in tool_calls_requested; provider-native web search may report web_search_requests only. Do not sum the two.","type":"null"}]}},"type":"null","uniqueKey":"data.oneOf.2.usage.server_tool_use.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.server_tool_use","typeLabel":"object | null"},"service_tier":{"oneOf":[{"description":"The service tier used by the upstream provider for this request","type":"string","uniqueKey":"data.oneOf.2.usage.service_tier.oneOf.0","typeLabel":"string"},{"description":"The service tier used by the upstream provider for this request","type":"null","uniqueKey":"data.oneOf.2.usage.service_tier.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.service_tier","typeLabel":"string | null"},"speed":{"oneOf":[{"enum":["fast","standard",null],"example":"standard","type":"string","x-speakeasy-unknown-values":"allow","description":"The output speed mode that served the request: \"fast\" (higher-speed inference, priced higher) or \"standard\"; null when not reported.","uniqueKey":"data.oneOf.2.usage.speed.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["fast","standard",null],"example":"standard","type":"null","x-speakeasy-unknown-values":"allow","description":"The output speed mode that served the request: \"fast\" (higher-speed inference, priced higher) or \"standard\"; null when not reported.","uniqueKey":"data.oneOf.2.usage.speed.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.2.usage.speed","typeLabel":"enum\u003cstring> | null"}},"required":["prompt_tokens","completion_tokens","total_tokens"],"type":"object","uniqueKey":"data.oneOf.2.usage","typeLabel":"object"}},"isRequired":true,"uniqueKey":"data.oneOf.2","typeLabel":"object"},{"type":"object","description":"One streamed image event: a partial image, a text chunk, the completed image, or an error.","required":["type","error"],"example":{"error":{"code":"upstream_error","message":"The upstream provider returned an error","param":null,"type":"provider_error"},"type":"error"},"properties":{"error":{"description":"Provider error details","properties":{"message":{"description":"Provider error message","type":"string","isRequired":true,"uniqueKey":"data.oneOf.3.error.message","typeLabel":"string"},"code":{"oneOf":[{"description":"Provider error code, when supplied","type":"string","uniqueKey":"data.oneOf.3.error.code.oneOf.0","typeLabel":"string"},{"description":"Provider error code, when supplied","type":"null","uniqueKey":"data.oneOf.3.error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.3.error.code","typeLabel":"string | null"},"param":{"oneOf":[{"description":"Request parameter associated with the error, when supplied","type":"string","uniqueKey":"data.oneOf.3.error.param.oneOf.0","typeLabel":"string"},{"description":"Request parameter associated with the error, when supplied","type":"null","uniqueKey":"data.oneOf.3.error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.3.error.param","typeLabel":"string | null"},"type":{"oneOf":[{"description":"Provider error type, when supplied","type":"string","uniqueKey":"data.oneOf.3.error.type.oneOf.0","typeLabel":"string"},{"description":"Provider error type, when supplied","type":"null","uniqueKey":"data.oneOf.3.error.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.3.error.type","typeLabel":"string | null"}},"required":["message"],"type":"object","isRequired":true,"uniqueKey":"data.oneOf.3.error","typeLabel":"object"},"type":{"description":"The event type","enum":["error"],"type":"string","isRequired":true,"uniqueKey":"data.oneOf.3.type","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"data.oneOf.3","typeLabel":"object"}],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"type":"object","uniqueKey":"","typeLabel":"object"},"x-speakeasy-sse-sentinel":"[DONE]","examples":{"Example":{"title":"Example","value":{"data":{"b64_json":"\u003cbase64-encoded-partial-image>","partial_image_index":0,"type":"image_generation.partial_image"}}}},"exampleType":"examples"}},"description":"Image generation response","exampleType":"examples"},"3a206650-5d89-4bc2-aa0f-a74e7aeff3d4":{"content":{"application/json":{"example":{"error":{"code":400,"message":"Invalid request parameters"}},"schema":{"description":"Bad Request - Invalid request parameters or malformed input","example":{"error":{"code":400,"message":"Invalid request parameters"}},"properties":{"error":{"description":"Error data for BadRequestResponse","example":{"code":400,"message":"Invalid request parameters"},"properties":{"code":{"type":"integer","description":"HTTP status of the error, the same as the response's: 400.","isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong, in words for a person; do not parse it, branch on code instead.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.metadata","typeLabel":"object | null"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"openrouter_metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"openrouter_metadata","typeLabel":"object | null"},"user_id":{"oneOf":[{"type":"string","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_id","typeLabel":"string | null"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":400,"message":"Invalid request parameters"}}}},"exampleType":"examples"}},"description":"Bad Request - Invalid request parameters or malformed input","exampleType":"examples"},"d4ba549c-b2e0-40e5-a431-05698cfda61a":{"content":{"application/json":{"example":{"error":{"code":401,"message":"Missing Authentication header"}},"schema":{"description":"Unauthorized - Authentication required or invalid credentials","example":{"error":{"code":401,"message":"Missing Authentication header"}},"properties":{"error":{"description":"Error data for UnauthorizedResponse","example":{"code":401,"message":"Missing Authentication header"},"properties":{"code":{"type":"integer","description":"HTTP status of the error, the same as the response's: 401.","isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong, in words for a person; do not parse it, branch on code instead.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.metadata","typeLabel":"object | null"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"openrouter_metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"openrouter_metadata","typeLabel":"object | null"},"user_id":{"oneOf":[{"type":"string","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_id","typeLabel":"string | null"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":401,"message":"Missing Authentication header"}}}},"exampleType":"examples"}},"description":"Unauthorized - Authentication required or invalid credentials","exampleType":"examples"},"c2801951-9100-4d0b-ad5e-b634455a76e7":{"content":{"application/json":{"example":{"error":{"code":402,"message":"Insufficient credits. Add more using https://openrouter.ai/credits"}},"schema":{"description":"Payment Required - Insufficient credits or quota to complete request","example":{"error":{"code":402,"message":"Insufficient credits. Add more using https://openrouter.ai/credits"}},"properties":{"error":{"description":"Error data for PaymentRequiredResponse","example":{"code":402,"message":"Insufficient credits. Add more using https://openrouter.ai/credits"},"properties":{"code":{"type":"integer","description":"HTTP status of the error, the same as the response's: 402.","isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong, in words for a person; do not parse it, branch on code instead.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.metadata","typeLabel":"object | null"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"openrouter_metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"openrouter_metadata","typeLabel":"object | null"},"user_id":{"oneOf":[{"type":"string","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_id","typeLabel":"string | null"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":402,"message":"Insufficient credits. Add more using https://openrouter.ai/credits"}}}},"exampleType":"examples"}},"description":"Payment Required - Insufficient credits or quota to complete request. Nemonist: over a spending cap, or out of credits.","exampleType":"examples"},"0731c625-e1a7-47b9-ba65-7ea4c42ab5ae":{"content":{"application/json":{"example":{"error":{"code":403,"message":"Only management keys can perform this operation"}},"schema":{"description":"Forbidden - Authentication successful but insufficient permissions","example":{"error":{"code":403,"message":"Only management keys can perform this operation"}},"properties":{"error":{"description":"Error data for ForbiddenResponse","example":{"code":403,"message":"Only management keys can perform this operation"},"properties":{"code":{"type":"integer","description":"HTTP status of the error, the same as the response's: 403.","isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong, in words for a person; do not parse it, branch on code instead.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.metadata","typeLabel":"object | null"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"openrouter_metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"openrouter_metadata","typeLabel":"object | null"},"user_id":{"oneOf":[{"type":"string","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_id","typeLabel":"string | null"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":403,"message":"Only management keys can perform this operation"}}}},"exampleType":"examples"}},"description":"Forbidden - Authentication successful but insufficient permissions","exampleType":"examples"},"e5339725-67e9-433e-9ddd-c703ec7f5a9c":{"content":{"application/json":{"example":{"error":{"code":404,"message":"Resource not found"}},"schema":{"description":"Not Found - Resource does not exist","example":{"error":{"code":404,"message":"Resource not found"}},"properties":{"error":{"description":"Error data for NotFoundResponse","example":{"code":404,"message":"Resource not found"},"properties":{"code":{"type":"integer","description":"HTTP status of the error, the same as the response's: 404.","isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong, in words for a person; do not parse it, branch on code instead.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.metadata","typeLabel":"object | null"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"openrouter_metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"openrouter_metadata","typeLabel":"object | null"},"user_id":{"oneOf":[{"type":"string","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_id","typeLabel":"string | null"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":404,"message":"Resource not found"}}}},"exampleType":"examples"}},"description":"Not Found - Resource does not exist","exampleType":"examples"},"f5ad2503-a888-44e5-b611-6118702d9567":{"content":{"application/json":{"example":{"error":{"code":413,"message":"Request payload too large"}},"schema":{"description":"Payload Too Large - Request payload exceeds size limits","example":{"error":{"code":413,"message":"Request payload too large"}},"properties":{"error":{"description":"Error data for PayloadTooLargeResponse","example":{"code":413,"message":"Request payload too large"},"properties":{"code":{"type":"integer","description":"HTTP status of the error, the same as the response's: 413.","isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong, in words for a person; do not parse it, branch on code instead.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.metadata","typeLabel":"object | null"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"openrouter_metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"openrouter_metadata","typeLabel":"object | null"},"user_id":{"oneOf":[{"type":"string","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_id","typeLabel":"string | null"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":413,"message":"Request payload too large"}}}},"exampleType":"examples"}},"description":"Payload Too Large - Request payload exceeds size limits","exampleType":"examples"},"c6726412-0bc5-4e3a-918f-f6644a572297":{"content":{"application/json":{"example":{"error":{"code":429,"message":"Rate limit exceeded"}},"schema":{"description":"Too Many Requests - Rate limit exceeded","example":{"error":{"code":429,"message":"Rate limit exceeded"}},"properties":{"error":{"description":"Error data for TooManyRequestsResponse","example":{"code":429,"message":"Rate limit exceeded"},"properties":{"code":{"type":"integer","description":"HTTP status of the error, the same as the response's: 429.","isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong, in words for a person; do not parse it, branch on code instead.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.metadata","typeLabel":"object | null"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"openrouter_metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"openrouter_metadata","typeLabel":"object | null"},"user_id":{"oneOf":[{"type":"string","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_id","typeLabel":"string | null"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":429,"message":"Rate limit exceeded"}}}},"exampleType":"examples"}},"description":"Too Many Requests - Rate limit exceeded. Nemonist: admission limit reached; retry after the Retry-After header's seconds.","exampleType":"examples"},"a4f6b1f5-3659-45b5-87b1-e682460c3ee0":{"content":{"application/json":{"example":{"error":{"code":500,"message":"Internal Server Error"}},"schema":{"description":"Internal Server Error - Unexpected server error","example":{"error":{"code":500,"message":"Internal Server Error"}},"properties":{"error":{"description":"Error data for InternalServerResponse","example":{"code":500,"message":"Internal Server Error"},"properties":{"code":{"type":"integer","description":"HTTP status of the error, the same as the response's: 500.","isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong, in words for a person; do not parse it, branch on code instead.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.metadata","typeLabel":"object | null"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"openrouter_metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"openrouter_metadata","typeLabel":"object | null"},"user_id":{"oneOf":[{"type":"string","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_id","typeLabel":"string | null"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":500,"message":"Internal Server Error"}}}},"exampleType":"examples"}},"description":"Internal Server Error - Unexpected server error","exampleType":"examples"},"f4ffae2c-ad72-4739-be21-381ed27751d0":{"content":{"application/json":{"example":{"error":{"code":502,"message":"Provider returned error"}},"schema":{"description":"Bad Gateway - Provider/upstream API failure","example":{"error":{"code":502,"message":"Provider returned error"}},"properties":{"error":{"description":"Error data for BadGatewayResponse","example":{"code":502,"message":"Provider returned error"},"properties":{"code":{"type":"integer","description":"HTTP status of the error, the same as the response's: 502.","isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong, in words for a person; do not parse it, branch on code instead.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.metadata","typeLabel":"object | null"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"openrouter_metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"openrouter_metadata","typeLabel":"object | null"},"user_id":{"oneOf":[{"type":"string","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_id","typeLabel":"string | null"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":502,"message":"Provider returned error"}}}},"exampleType":"examples"}},"description":"Bad Gateway - Provider/upstream API failure","exampleType":"examples"},"63600094-4276-4046-99e7-0d84a8b0d704":{"description":"Nemonist: the account service is temporarily unavailable; retry.","content":{"application/json":{"example":{"error":{"code":500,"message":"Internal Server Error"}},"schema":{"description":"Internal Server Error - Unexpected server error","example":{"error":{"code":500,"message":"Internal Server Error"}},"properties":{"error":{"description":"Error data for InternalServerResponse","example":{"code":500,"message":"Internal Server Error"},"properties":{"code":{"type":"integer","description":"HTTP status of the error, the same as the response's: 500.","isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong, in words for a person; do not parse it, branch on code instead.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.metadata","typeLabel":"object | null"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"openrouter_metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"openrouter_metadata","typeLabel":"object | null"},"user_id":{"oneOf":[{"type":"string","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_id","typeLabel":"string | null"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":500,"message":"Internal Server Error"}}}},"exampleType":"examples"}},"exampleType":"examples"},"dc7c7df2-8835-4f13-b4cf-0ebf13a057a0":{"content":{"application/json":{"example":{"error":{"code":524,"message":"Request timed out. Please try again later."}},"schema":{"description":"Infrastructure Timeout - Provider request timed out at edge network","example":{"error":{"code":524,"message":"Request timed out. Please try again later."}},"properties":{"error":{"description":"Error data for EdgeNetworkTimeoutResponse","example":{"code":524,"message":"Request timed out. Please try again later."},"properties":{"code":{"type":"integer","description":"HTTP status of the error, the same as the response's: 524.","isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong, in words for a person; do not parse it, branch on code instead.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.metadata","typeLabel":"object | null"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"openrouter_metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"openrouter_metadata","typeLabel":"object | null"},"user_id":{"oneOf":[{"type":"string","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_id","typeLabel":"string | null"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":524,"message":"Request timed out. Please try again later."}}}},"exampleType":"examples"}},"description":"Infrastructure Timeout - Provider request timed out at edge network","exampleType":"examples"},"c6cb4e6b-071b-4fb7-9df0-c16970791289":{"content":{"application/json":{"example":{"error":{"code":529,"message":"Provider returned error"}},"schema":{"description":"Provider Overloaded - Provider is temporarily overloaded","example":{"error":{"code":529,"message":"Provider returned error"}},"properties":{"error":{"description":"Error data for ProviderOverloadedResponse","example":{"code":529,"message":"Provider returned error"},"properties":{"code":{"type":"integer","description":"HTTP status of the error, the same as the response's: 529.","isRequired":true,"uniqueKey":"error.code","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong, in words for a person; do not parse it, branch on code instead.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"Extra detail about the error.","uniqueKey":"error.metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.metadata","typeLabel":"object | null"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"},"openrouter_metadata":{"oneOf":[{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.0.additionalProperties","typeLabel":"any"},"type":"object","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.0","typeLabel":"object"},{"additionalProperties":{"oneOf":[{}],"uniqueKey":"openrouter_metadata.oneOf.1.additionalProperties","typeLabel":"any"},"type":"null","description":"OpenRouter's routing detail for the failed request.","uniqueKey":"openrouter_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"openrouter_metadata","typeLabel":"object | null"},"user_id":{"oneOf":[{"type":"string","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the user who made the request.","uniqueKey":"user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_id","typeLabel":"string | null"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":529,"message":"Provider returned error"}}}},"exampleType":"examples"}},"description":"Provider Overloaded - Provider is temporarily overloaded","exampleType":"examples"}},"security":{"5c64c600-8820-448c-b999-87c9f6ba628f":{"apiKey":{"type":"http","scheme":"bearer","description":"A Nemonist key (sk-nm-...) as a bearer token in the Authorization header.","scopes":[],"schemeName":"apiKey"}}},"servers":{"f904a986-b1a7-4390-beb0-f994b9f6d9ad":{"url":"https://nemonist.com/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"A Nemonist key (sk-nm-...) as a bearer token in the Authorization header.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A Nemonist key (sk-nm-...) as a bearer token in the Authorization header.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"nemonist","siteName":"nemonist","title":"Generate an image - nemonist","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T19:22:50.961Z","originalFileLocation":"api-reference/images/generate-an-image.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=\"Generates an image from a text prompt via the image generation router\">\u003cmeta data-mint-head name=\"application-name\" content=\"nemonist\">\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/nemonist/pJflnD9tD_j2EbQM/_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/nemonist/pJflnD9tD_j2EbQM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/nemonist/pJflnD9tD_j2EbQM/_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/nemonist/pJflnD9tD_j2EbQM/_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/nemonist/pJflnD9tD_j2EbQM/_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/nemonist/pJflnD9tD_j2EbQM/_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/nemonist/pJflnD9tD_j2EbQM/_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/nemonist/pJflnD9tD_j2EbQM/_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/nemonist/pJflnD9tD_j2EbQM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Generate an image - nemonist\">\u003cmeta data-mint-head property=\"og:description\" content=\"Generates an image from a text prompt via the image generation router\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"nemonist\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://nemonist.com/docs/api-reference/images/generate-an-image\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nemonist.mintlify.site/docs/_mintlify/api/og/v2?division=Images\u0026amp;title=Generate+an+image\u0026amp;description=Generates+an+image+from+a+text+prompt+via+the+image+generation+router\u0026amp;theme=40d9cda61a40fab1943dcc72\u0026amp;signature=64a1044762b306d0a91e7526c8ba044cad1ea842b2d31bda08f0c6fe2348f278\">\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=\"Generate an image - nemonist\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Generates an image from a text prompt via the image generation router\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nemonist.mintlify.site/docs/_mintlify/api/og/v2?division=Images\u0026amp;title=Generate+an+image\u0026amp;description=Generates+an+image+from+a+text+prompt+via+the+image+generation+router\u0026amp;theme=40d9cda61a40fab1943dcc72\u0026amp;signature=64a1044762b306d0a91e7526c8ba044cad1ea842b2d31bda08f0c6fe2348f278\">\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/nemonist/pJflnD9tD_j2EbQM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"nemonist\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366f1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://nemonist.com/docs/api-reference/images/generate-an-image\">\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/images/generate-an-image.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://nemonist.com/#organization\",\"name\":\"nemonist\",\"url\":\"https://nemonist.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nemonist/O63iSHDIbHFIFLsR/logo/light.svg?fit=max\u0026auto=format\u0026n=O63iSHDIbHFIFLsR\u0026q=85\u0026s=78e0f2fecc2ad48dcf82fc4287a5dc8d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://nemonist.com/docs#website\",\"name\":\"nemonist\",\"url\":\"https://nemonist.com/docs\",\"publisher\":{\"@id\":\"https://nemonist.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://nemonist.com/docs/api-reference/images/generate-an-image#webpage\",\"url\":\"https://nemonist.com/docs/api-reference/images/generate-an-image\",\"name\":\"Generate an image\",\"description\":\"Generates an image from a text prompt via the image generation router\",\"dateModified\":\"2026-11-18T19:22:50.961Z\",\"isPartOf\":{\"@id\":\"https://nemonist.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://nemonist.com/docs/api-reference/images/generate-an-image#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://nemonist.com/docs/api-reference/images/generate-an-image#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"nemonist\",\"item\":\"https://nemonist.com/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Generate an image\",\"item\":\"https://nemonist.com/docs/api-reference/images/generate-an-image\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://nemonist.com/docs/api-reference/images/generate-an-image#apireference\",\"headline\":\"Generate an image\",\"name\":\"Generate an image\",\"description\":\"Generates an image from a text prompt via the image generation router\",\"url\":\"https://nemonist.com/docs/api-reference/images/generate-an-image\",\"mainEntityOfPage\":{\"@id\":\"https://nemonist.com/docs/api-reference/images/generate-an-image#webpage\"},\"dateModified\":\"2026-11-18T19:22:50.961Z\",\"publisher\":{\"@id\":\"https://nemonist.com/#organization\"},\"isPartOf\":{\"@id\":\"https://nemonist.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"nemonist\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"nemonist\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/images/generate-an-image.md","siteName":"nemonist","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":""}]},{"tab":"Clients","pages":[{"title":"Clients","href":"/clients/cursor"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Overview","href":"/api-reference/overview"},{"title":"Output items","href":"/api-reference/output-items"}]},{"group":"Analytics","pages":[{"title":"Get user activity grouped by endpoint","deprecated":null,"version":null,"openapi":"/openapi.json get /activity","href":"/api-reference/analytics/get-user-activity-grouped-by-endpoint"}]},{"group":"Speech","pages":[{"title":"Create speech","deprecated":null,"version":null,"openapi":"/openapi.json post /audio/speech","href":"/api-reference/tts/create-speech"}]},{"group":"Transcriptions","pages":[{"title":"Create transcription","deprecated":null,"version":null,"openapi":"/openapi.json post /audio/transcriptions","href":"/api-reference/stt/create-transcription"}]},{"group":"OAuth","pages":[{"title":"Exchange authorization code for API key","deprecated":null,"version":null,"openapi":"/openapi.json post /auth/keys","href":"/api-reference/oauth/exchange-authorization-code-for-api-key"}]},{"group":"Benchmarks","pages":[{"title":"List Benchmarks","deprecated":null,"version":null,"openapi":"/openapi.json get /benchmarks","href":"/api-reference/benchmarks/list-benchmarks"}]},{"group":"BYOK","pages":[{"title":"List BYOK provider credentials","deprecated":null,"version":null,"openapi":"/openapi.json get /byok","href":"/api-reference/byok/list-byok-provider-credentials"},{"title":"Create a BYOK provider credential","deprecated":null,"version":null,"openapi":"/openapi.json post /byok","href":"/api-reference/byok/create-a-byok-provider-credential"},{"title":"Get a BYOK provider credential","deprecated":null,"version":null,"openapi":"/openapi.json get /byok/{id}","href":"/api-reference/byok/get-a-byok-provider-credential"},{"title":"Delete a BYOK provider credential","deprecated":null,"version":null,"openapi":"/openapi.json delete /byok/{id}","href":"/api-reference/byok/delete-a-byok-provider-credential"},{"title":"Update a BYOK provider credential","deprecated":null,"version":null,"openapi":"/openapi.json patch /byok/{id}","href":"/api-reference/byok/update-a-byok-provider-credential"}]},{"group":"Chat","pages":[{"title":"Create a chat completion","deprecated":null,"version":null,"openapi":"/openapi.json post /chat/completions","href":"/api-reference/chat/create-a-chat-completion"}]},{"group":"Credits","pages":[{"title":"Get remaining credits","deprecated":null,"version":null,"openapi":"/openapi.json get /credits","href":"/api-reference/credits/get-remaining-credits"}]},{"group":"Datasets","pages":[{"title":"Top apps by token usage","deprecated":null,"version":null,"openapi":"/openapi.json get /datasets/app-rankings","href":"/api-reference/datasets/top-apps-by-token-usage"},{"title":"Daily token totals for top 50 models","deprecated":null,"version":null,"openapi":"/openapi.json get /datasets/rankings-daily","href":"/api-reference/datasets/daily-token-totals-for-top-50-models"}]},{"group":"Embeddings","pages":[{"title":"Submit an embedding request","deprecated":null,"version":null,"openapi":"/openapi.json post /embeddings","href":"/api-reference/embeddings/submit-an-embedding-request"},{"title":"List all embeddings models","deprecated":null,"version":null,"openapi":"/openapi.json get /embeddings/models","href":"/api-reference/embeddings/list-all-embeddings-models"}]},{"group":"Endpoints","pages":[{"title":"Preview the impact of ZDR on the available endpoints","deprecated":null,"version":null,"openapi":"/openapi.json get /endpoints/zdr","href":"/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints"},{"title":"List all endpoints for a model","deprecated":null,"version":null,"openapi":"/openapi.json get /models/{author}/{slug}/endpoints","href":"/api-reference/endpoints/list-all-endpoints-for-a-model"}]},{"group":"Generations","pages":[{"title":"Get request \u0026 usage metadata for a generation","deprecated":null,"version":null,"openapi":"/openapi.json get /generation","href":"/api-reference/generations/get-request-\u0026-usage-metadata-for-a-generation"}]},{"group":"Guardrails","pages":[{"title":"List guardrails","deprecated":null,"version":null,"openapi":"/openapi.json get /guardrails","href":"/api-reference/guardrails/list-guardrails"},{"title":"Create a guardrail","deprecated":null,"version":null,"openapi":"/openapi.json post /guardrails","href":"/api-reference/guardrails/create-a-guardrail"},{"title":"Get a guardrail","deprecated":null,"version":null,"openapi":"/openapi.json get /guardrails/{id}","href":"/api-reference/guardrails/get-a-guardrail"},{"title":"Delete a guardrail","deprecated":null,"version":null,"openapi":"/openapi.json delete /guardrails/{id}","href":"/api-reference/guardrails/delete-a-guardrail"},{"title":"Update a guardrail","deprecated":null,"version":null,"openapi":"/openapi.json patch /guardrails/{id}","href":"/api-reference/guardrails/update-a-guardrail"},{"title":"List key assignments for a guardrail","deprecated":null,"version":null,"openapi":"/openapi.json get /guardrails/{id}/assignments/keys","href":"/api-reference/guardrails/list-key-assignments-for-a-guardrail"},{"title":"Bulk assign keys to a guardrail","deprecated":null,"version":null,"openapi":"/openapi.json post /guardrails/{id}/assignments/keys","href":"/api-reference/guardrails/bulk-assign-keys-to-a-guardrail"},{"title":"Bulk unassign keys from a guardrail","deprecated":null,"version":null,"openapi":"/openapi.json post /guardrails/{id}/assignments/keys/remove","href":"/api-reference/guardrails/bulk-unassign-keys-from-a-guardrail"},{"title":"List all key assignments","description":"List all API key guardrail assignments for the authenticated user. [Management key](/docs/guides/overview/auth/management-api-keys) required.","deprecated":null,"version":null,"openapi":"/openapi.json get /guardrails/assignments/keys","href":"/api-reference/guardrails/list-all-key-assignments"}]},{"group":"Images","pages":[{"title":"Generate an image","deprecated":null,"version":null,"openapi":"/openapi.json post /images","href":"/api-reference/images/generate-an-image"},{"title":"List image generation models","description":"Lists every image generation model with its top-level supported-parameter superset and a URL to its full per-endpoint records.","deprecated":null,"version":null,"openapi":"/openapi.json get /images/models","href":"/api-reference/images/list-image-generation-models"},{"title":"List endpoints for an image model","deprecated":null,"version":null,"openapi":"/openapi.json get /images/models/{author}/{slug}/endpoints","href":"/api-reference/images/list-endpoints-for-an-image-model"}]},{"group":"API Keys","pages":[{"title":"Get current API key","deprecated":null,"version":null,"openapi":"/openapi.json get /key","href":"/api-reference/api-keys/get-current-api-key"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"/openapi.json get /keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create a new API key","deprecated":null,"version":null,"openapi":"/openapi.json post /keys","href":"/api-reference/api-keys/create-a-new-api-key"},{"title":"Get a single API key","deprecated":null,"version":null,"openapi":"/openapi.json get /keys/{hash}","href":"/api-reference/api-keys/get-a-single-api-key"},{"title":"Delete an API key","deprecated":null,"version":null,"openapi":"/openapi.json delete /keys/{hash}","href":"/api-reference/api-keys/delete-an-api-key"},{"title":"Update an API key","deprecated":null,"version":null,"openapi":"/openapi.json patch /keys/{hash}","href":"/api-reference/api-keys/update-an-api-key"}]},{"group":"Anthropic Messages","pages":[{"title":"Create a message","deprecated":null,"version":null,"openapi":"/openapi.json post /messages","href":"/api-reference/anthropic-messages/create-a-message"}]},{"group":"Models","pages":[{"title":"Get a model by its slug","deprecated":null,"version":null,"openapi":"/openapi.json get /model/{author}/{slug}","href":"/api-reference/models/get-a-model-by-its-slug"},{"title":"List all models and their properties","deprecated":null,"version":null,"openapi":"/openapi.json get /models","href":"/api-reference/models/list-all-models-and-their-properties"},{"title":"Get total count of available models","deprecated":null,"version":null,"openapi":"/openapi.json get /models/count","href":"/api-reference/models/get-total-count-of-available-models"},{"title":"List models filtered by user provider preferences, privacy settings, and guardrails","deprecated":null,"version":null,"openapi":"/openapi.json get /models/user","href":"/api-reference/models/list-models-filtered-by-user-provider-preferences-privacy-settings-and-guardrails"}]},{"group":"Organization","pages":[{"title":"List organization members","deprecated":null,"version":null,"openapi":"/openapi.json get /organization/members","href":"/api-reference/organization/list-organization-members"}]},{"group":"Private Endpoints","pages":[{"title":"List private endpoints","deprecated":null,"version":null,"openapi":"/openapi.json get /private-endpoints","href":"/api-reference/private-endpoints/list-private-endpoints"},{"title":"Create a private endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /private-endpoints","href":"/api-reference/private-endpoints/create-a-private-endpoint"},{"title":"Get a private endpoint","deprecated":null,"version":null,"openapi":"/openapi.json get /private-endpoints/{id}","href":"/api-reference/private-endpoints/get-a-private-endpoint"},{"title":"Delete a private endpoint","deprecated":null,"version":null,"openapi":"/openapi.json delete /private-endpoints/{id}","href":"/api-reference/private-endpoints/delete-a-private-endpoint"},{"title":"Update a private endpoint","deprecated":null,"version":null,"openapi":"/openapi.json patch /private-endpoints/{id}","href":"/api-reference/private-endpoints/update-a-private-endpoint"},{"title":"Activate a validated private endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /private-endpoints/{id}/activate","href":"/api-reference/private-endpoints/activate-a-validated-private-endpoint"},{"title":"Disable a private endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /private-endpoints/{id}/disable","href":"/api-reference/private-endpoints/disable-a-private-endpoint"},{"title":"Enable a private endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /private-endpoints/{id}/enable","href":"/api-reference/private-endpoints/enable-a-private-endpoint"},{"title":"Validate a draft private endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /private-endpoints/{id}/validate","href":"/api-reference/private-endpoints/validate-a-draft-private-endpoint"}]},{"group":"Providers","pages":[{"title":"List all providers","deprecated":null,"version":null,"openapi":"/openapi.json get /providers","href":"/api-reference/providers/list-all-providers"}]},{"group":"Rerank","pages":[{"title":"Submit a rerank request","deprecated":null,"version":null,"openapi":"/openapi.json post /rerank","href":"/api-reference/rerank/submit-a-rerank-request"}]},{"group":"Responses","pages":[{"title":"Create a response","deprecated":null,"version":null,"openapi":"/openapi.json post /responses","href":"/api-reference/responses/create-a-response"}]},{"group":"System One","pages":[{"title":"Submit a System One request","deprecated":null,"version":null,"openapi":"/openapi.json post /systemone","href":"/api-reference/systemone/submit-a-system-one-request"}]},{"group":"Video Generation","pages":[{"title":"List all video generation models","deprecated":null,"version":null,"openapi":"/openapi.json get /videos/models","href":"/api-reference/video-generation/list-all-video-generation-models"}]},{"group":"Workspaces","pages":[{"title":"List workspaces","deprecated":null,"version":null,"openapi":"/openapi.json get /workspaces","href":"/api-reference/workspaces/list-workspaces"},{"title":"Create a workspace","deprecated":null,"version":null,"openapi":"/openapi.json post /workspaces","href":"/api-reference/workspaces/create-a-workspace"},{"title":"Get a workspace","deprecated":null,"version":null,"openapi":"/openapi.json get /workspaces/{id}","href":"/api-reference/workspaces/get-a-workspace"},{"title":"Delete a workspace","deprecated":null,"version":null,"openapi":"/openapi.json delete /workspaces/{id}","href":"/api-reference/workspaces/delete-a-workspace"},{"title":"Update a workspace","deprecated":null,"version":null,"openapi":"/openapi.json patch /workspaces/{id}","href":"/api-reference/workspaces/update-a-workspace"},{"title":"List workspace members","deprecated":null,"version":null,"openapi":"/openapi.json get /workspaces/{id}/members","href":"/api-reference/workspaces/list-workspace-members"},{"title":"Bulk add members to a workspace","deprecated":null,"version":null,"openapi":"/openapi.json post /workspaces/{id}/members/add","href":"/api-reference/workspaces/bulk-add-members-to-a-workspace"},{"title":"Bulk remove members from a workspace","deprecated":null,"version":null,"openapi":"/openapi.json post /workspaces/{id}/members/remove","href":"/api-reference/workspaces/bulk-remove-members-from-a-workspace"},{"title":"List workspace budgets","deprecated":null,"version":null,"openapi":"/openapi.json get /workspaces/{workspace_ref}/budgets","href":"/api-reference/workspaces/list-workspace-budgets"},{"title":"Get a workspace budget","deprecated":null,"version":null,"openapi":"/openapi.json get /workspaces/{workspace_ref}/budgets/{interval}","href":"/api-reference/workspaces/get-a-workspace-budget"},{"title":"Create or update a workspace budget","deprecated":null,"version":null,"openapi":"/openapi.json put /workspaces/{workspace_ref}/budgets/{interval}","href":"/api-reference/workspaces/create-or-update-a-workspace-budget"},{"title":"Delete a workspace budget","deprecated":null,"version":null,"openapi":"/openapi.json delete /workspaces/{workspace_ref}/budgets/{interval}","href":"/api-reference/workspaces/delete-a-workspace-budget"}]},{"group":"Memory","pages":[{"title":"Erase all memory","deprecated":null,"version":null,"openapi":"/openapi.json delete /memory","href":"/api-reference/memory/erase-all-memory"},{"title":"Read a workspace's memory","deprecated":null,"version":null,"openapi":"/openapi.json get /memory-file","href":"/api-reference/memory/read-a-workspaces-memory"},{"title":"List a folder's inbox by its key","deprecated":null,"version":null,"openapi":"/openapi.json get /inbox","href":"/api-reference/memory/list-a-folders-inbox-by-its-key"},{"title":"Send a message to a folder","deprecated":null,"version":null,"openapi":"/openapi.json post /inbox","href":"/api-reference/memory/send-a-message-to-a-folder"},{"title":"Get a workspace's memory graph","deprecated":null,"version":null,"openapi":"/openapi.json get /memory-graph","href":"/api-reference/memory/get-a-workspaces-memory-graph"}]},{"group":"Folders","pages":[{"title":"List your folders","deprecated":null,"version":null,"openapi":"/openapi.json get /folders","href":"/api-reference/folders/list-your-folders"},{"title":"Get a folder","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}","href":"/api-reference/folders/get-a-folder"},{"title":"Erase a folder","deprecated":null,"version":null,"openapi":"/openapi.json delete /folders/{id}","href":"/api-reference/folders/erase-a-folder"},{"title":"Rename a folder","deprecated":null,"version":null,"openapi":"/openapi.json patch /folders/{id}","href":"/api-reference/folders/rename-a-folder"},{"title":"Read a note","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/memory/{path}","href":"/api-reference/folders/read-a-note"},{"title":"List recorded requests","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/history","href":"/api-reference/folders/list-recorded-requests"},{"title":"Read a recorded request","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/history/{commit}","href":"/api-reference/folders/read-a-recorded-request"},{"title":"Export a folder","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/export","href":"/api-reference/folders/export-a-folder"},{"title":"Get a folder's memory graph","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/graph","href":"/api-reference/folders/get-a-folders-memory-graph"},{"title":"Turn nightly sleep on or off","deprecated":null,"version":null,"openapi":"/openapi.json put /folders/{id}/sleep","href":"/api-reference/folders/turn-nightly-sleep-on-or-off"},{"title":"Issue a key","deprecated":null,"version":null,"openapi":"/openapi.json post /folders/{id}/keys","href":"/api-reference/folders/issue-a-key"},{"title":"Revoke a key","deprecated":null,"version":null,"openapi":"/openapi.json delete /folders/{id}/keys/{kid}","href":"/api-reference/folders/revoke-a-key"},{"title":"Merge into another folder","deprecated":null,"version":null,"openapi":"/openapi.json post /folders/{id}/merge","href":"/api-reference/folders/merge-into-another-folder"},{"title":"List uploaded files","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/files","href":"/api-reference/folders/list-uploaded-files"},{"title":"Download an uploaded file","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/files/{path}","href":"/api-reference/folders/download-an-uploaded-file"},{"title":"Delete an uploaded file","deprecated":null,"version":null,"openapi":"/openapi.json delete /folders/{id}/files/{path}","href":"/api-reference/folders/delete-an-uploaded-file"},{"title":"Get an upload URL","deprecated":null,"version":null,"openapi":"/openapi.json post /folders/{id}/upload-url","href":"/api-reference/folders/get-an-upload-url"},{"title":"Start or continue a multipart upload","deprecated":null,"version":null,"openapi":"/openapi.json post /folders/{id}/multipart","href":"/api-reference/folders/start-or-continue-a-multipart-upload"},{"title":"Complete a multipart upload","deprecated":null,"version":null,"openapi":"/openapi.json post /folders/{id}/multipart/complete","href":"/api-reference/folders/complete-a-multipart-upload"},{"title":"List a folder's jobs","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/jobs","href":"/api-reference/folders/list-a-folders-jobs"},{"title":"Download a job output","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/jobs/{job}/{name}","href":"/api-reference/folders/download-a-job-output"},{"title":"List a folder's inbox","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/inbox","href":"/api-reference/folders/list-a-folders-inbox"},{"title":"Get a folder's tool use","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/tools","href":"/api-reference/folders/get-a-folders-tool-use"},{"title":"List commits","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/commits","href":"/api-reference/folders/list-commits"},{"title":"Get a commit","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/commits/{commit}","href":"/api-reference/folders/get-a-commit"},{"title":"List notes at a commit","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/tree","href":"/api-reference/folders/list-notes-at-a-commit"},{"title":"Download notes as a zip","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/zipball","href":"/api-reference/folders/download-notes-as-a-zip"},{"title":"Download notes at a commit as a zip","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/zipball/{commit}","href":"/api-reference/folders/download-notes-at-a-commit-as-a-zip"},{"title":"List tags","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/tags","href":"/api-reference/folders/list-tags"},{"title":"Create a tag","deprecated":null,"version":null,"openapi":"/openapi.json post /folders/{id}/tags","href":"/api-reference/folders/create-a-tag"},{"title":"Delete a tag","deprecated":null,"version":null,"openapi":"/openapi.json delete /folders/{id}/tags/{name}","href":"/api-reference/folders/delete-a-tag"},{"title":"Get contributors","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/stats/contributors","href":"/api-reference/folders/get-contributors"},{"title":"Get commit activity","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/stats/commit_activity","href":"/api-reference/folders/get-commit-activity"},{"title":"Blame a note","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/blame/{path}","href":"/api-reference/folders/blame-a-note"},{"title":"List work items","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/issues","href":"/api-reference/folders/list-work-items"},{"title":"Read a work item","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/issues/{item}","href":"/api-reference/folders/read-a-work-item"},{"title":"Edit a work item by name","deprecated":null,"version":null,"openapi":"/openapi.json patch /folders/{id}/issues/{item}","href":"/api-reference/folders/edit-a-work-item-by-name"},{"title":"Compare two commits","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/compare/{basehead}","href":"/api-reference/folders/compare-two-commits"},{"title":"Read a work item's timeline","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/issues/{item}/timeline","href":"/api-reference/folders/read-a-work-items-timeline"},{"title":"List activity","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/activity","href":"/api-reference/folders/list-activity"},{"title":"Revert a commit","deprecated":null,"version":null,"openapi":"/openapi.json post /folders/{id}/commits/{commit}/revert","href":"/api-reference/folders/revert-a-commit"},{"title":"Get goal insights","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/stats/issues","href":"/api-reference/folders/get-goal-insights"},{"title":"List saved goal views","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/views","href":"/api-reference/folders/list-saved-goal-views"},{"title":"Save a goal view","deprecated":null,"version":null,"openapi":"/openapi.json post /folders/{id}/views","href":"/api-reference/folders/save-a-goal-view"},{"title":"Get a goal view","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/views/{number}","href":"/api-reference/folders/get-a-goal-view"},{"title":"Delete a goal view","deprecated":null,"version":null,"openapi":"/openapi.json delete /folders/{id}/views/{number}","href":"/api-reference/folders/delete-a-goal-view"},{"title":"Edit a goal view","deprecated":null,"version":null,"openapi":"/openapi.json patch /folders/{id}/views/{number}","href":"/api-reference/folders/edit-a-goal-view"},{"title":"List a view's goals","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/{id}/views/{number}/issues","href":"/api-reference/folders/list-a-views-goals"}]},{"group":"Model runs","pages":[{"title":"List uploaded files","deprecated":null,"version":null,"openapi":"/openapi.json get /files","href":"/api-reference/model-runs/list-uploaded-files"},{"title":"Start a file upload","deprecated":null,"version":null,"openapi":"/openapi.json post /files","href":"/api-reference/model-runs/start-a-file-upload"},{"title":"List models","deprecated":null,"version":null,"openapi":"/openapi.json get /runs/models","href":"/api-reference/model-runs/list-models"},{"title":"List runs","deprecated":null,"version":null,"openapi":"/openapi.json get /runs","href":"/api-reference/model-runs/list-runs"},{"title":"Start a run","deprecated":null,"version":null,"openapi":"/openapi.json post /runs","href":"/api-reference/model-runs/start-a-run"},{"title":"Poll a run","deprecated":null,"version":null,"openapi":"/openapi.json get /runs/{id}","href":"/api-reference/model-runs/poll-a-run"},{"title":"Cancel a run","deprecated":null,"version":null,"openapi":"/openapi.json delete /runs/{id}","href":"/api-reference/model-runs/cancel-a-run"},{"title":"Download a run output","deprecated":null,"version":null,"openapi":"/openapi.json get /runs/{id}/content","href":"/api-reference/model-runs/download-a-run-output"}]}]}]},"basePath":"","title":"Generate an image - nemonist","deploymentId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","buildId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"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","ApiExamples-CQdVXSju.js","isEqual-ft5OxoSH.js","usePlaygroundInputsStore-BILH4rrw.js","shallow-DterCiSU.js","getApiPlaygroundDisplay-uFtORr6j.js","CodeSnippet-BeuhEvUS.js","CodeSnippets-laCoJsvn.js","Page-CTsmHnLF.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"]}