Authentication: This endpoint accepts either a Bearer API key or a SIGN-IN-WITH-X header for x402 wallet-based authentication. The legacy X-Sign-In-With-X header is also accepted during migration. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.
{
"error": "This API key is restricted to configured IP addresses, and this request's source IP is not allowed"
}
{
"error": "<string>"
}
{
"error": "<string>",
"suggested_prompt": "A watercolor painting of a lighthouse on a rocky coast at sunset.",
"recommended_model": "chroma",
"retryable": true
}
I modelli di immagine usano parametri di dimensionamento specifici per modello:
I modelli basati su pixel accettano width e height, ad esempio venice-sd35.
I modelli basati su aspect ratio accettano aspect_ratio, ad esempio qwen-image-2. La famiglia Qwen Image — qwen-image, qwen-image-3, qwen-image-3-pro, qwen-image-2-1-turbo e qwen-image-2-1-pro — rifiutawidth e height con un 400; per questi modelli usa aspect_ratio.
I modelli a livelli di risoluzione accettano sia aspect_ratio sia resolution.
Ad esempio, gpt-image-2, nano-banana-2 e nano-banana-pro supportano i valori di resolution1K, 2K e 4K:
{ "model": "gpt-image-2", "prompt": "a cinematic wide shot of Venice at sunset", "aspect_ratio": "16:9", "resolution": "4K", "format": "png"}
Lo stesso pattern di dimensionamento a livelli di risoluzione si applica anche ai modelli Nano Banana:
{ "model": "nano-banana-pro", "prompt": "a serene canal in venice at sunset", "aspect_ratio": "16:9", "resolution": "2K"}
Per i modelli che accettano aspect ratio ma non espongono livelli di risoluzione, invia aspect_ratio senza resolution:
{ "model": "qwen-image-2", "prompt": "a serene canal in venice at sunset", "aspect_ratio": "16:9"}
Per i modelli che usano dimensioni in pixel dirette, invia invece width e height:
{ "model": "venice-sd35", "prompt": "a serene canal in venice at sunset", "width": 1024, "height": 1024}
Controlla Modelli immagine o l’endpoint Models per le opzioni di dimensionamento supportate da ciascun modello prima di mischiare campi di dimensionamento tra modelli diversi.
Alcuni modelli accettano un parametro opzionale quality (low, medium, high) che bilancia fedeltà visiva e costo. I modelli che elencano qualities in model_spec.constraints da GET /models?type=image accettano solo quei valori, e alcuni supportano solo un sottoinsieme come low e medium. Gli altri modelli ignorano il parametro.
{ "model": "gpt-image-2", "prompt": "a cinematic wide shot of Venice at sunset", "aspect_ratio": "16:9", "resolution": "2K", "quality": "medium"}
Quando ometti quality, il modello usa il proprio livello predefinito (high per gpt-image-2). Il prezzo dipende dalla combinazione di resolution e quality — i prezzi per livello per gpt-image-2 (1K/2K/4K × low/medium/high) sono esposti sotto model_spec.pricing.quality nell’endpoint Models ed elencati nella panoramica dei prezzi.
I prezzi basati sulla qualità sono l’impostazione predefinita per tutti i chiamanti API e SDK — non è richiesto alcun header di opt-in. Le richieste che omettono quality vengono fatturate al livello predefinito del modello (high per gpt-image-2).
Optional identifier for the API customer's end user. Combined with the Venice user id when attributing the request to upstream providers. Distinct from the discarded OpenAI user field. Must be printable ASCII and must not contain ||.
A description of what should not be in the image. Character limit is model specific and is listed in the promptCharacterLimit constraint in the model list endpoint.
Number of images to generate (1–4). Only supported when return_binary is false. Variants the model provider explicitly rejects under its content policy are omitted from a successful partial response. Other moderation outcomes can still return blacked-out images; check x-venice-is-content-violation.
Whether to blur images classified as adult content. Defaults to true. Set to false to receive unblurred output. No Pro subscription is required, and the mature filter setting in the Venice app does not affect this. The x-venice-is-blurred response header reports whether the returned image was blurred.
Output quality for supported models (e.g. GPT Image 2 / GPT Image 2 Edit). Higher values can increase the final request charge. See the model list for supported options.
Return the image with a transparent background (alpha channel). Only supported by models with supportsTransparentBackground: true in their constraints (see GET /api/v1/models), and requires format png or webp; otherwise the request is rejected. Omit or set to false to keep the model default background.
Enable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image. Only supported by certain models. If web search is used, additional credits are getting charged.
Skip the model's prompt-optimization thinking step for faster generation. Only supported by models with supportsOptimizePromptThinking; ignored by others. Omit to use the model default.
Rewrite the prompt before generation to add clarifying visual detail. Additional credits are charged when a rewrite is generated. Adds up to ~30 seconds before generation starts. When enhancement is applied, the final prompt is returned URL-encoded in the x-venice-enhanced-prompt response header. Defaults to false.
Style reference images that guide the aesthetic of the generated image. Only supported by models with supportsStyleReferences: true (see GET /api/v1/models for the per-model maxStyleReferences limit).
Number of requested variants omitted because the model provider explicitly rejected them under its content policy. Other moderation outcomes can still return blacked-out images flagged by x-venice-is-content-violation.
{
"error": "This API key is restricted to configured IP addresses, and this request's source IP is not allowed"
}
{
"error": "<string>"
}
{
"error": "<string>",
"suggested_prompt": "A watercolor painting of a lighthouse on a rocky coast at sunset.",
"recommended_model": "chroma",
"retryable": true
}
{
"error": "<string>"
}
{
"error": "<string>"
}
{
"error": "<string>"
}
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Venice API Docs","colors":{"primary":"#125DA3","light":"#4898E6","dark":"#125DA3"},"logo":{"light":"https://mintcdn.com/veniceai/gFXvp87w4B810n0Y/logo/light.svg?fit=max\u0026auto=format\u0026n=gFXvp87w4B810n0Y\u0026q=85\u0026s=121558c3bff1e4e012fcd34bdc50555c","dark":"https://mintcdn.com/veniceai/0vNwudF9KfvWPUSs/logo/dark.svg?fit=max\u0026auto=format\u0026n=0vNwudF9KfvWPUSs\u0026q=85\u0026s=79383337fb486ba06afb95cb7d0b4bf7","href":"https://venice.ai/?utm_source=venice-api-documentation"},"favicon":"https://mintcdn.com/veniceai/wJjdz14nrhedln0s/favicon.png?fit=max\u0026auto=format\u0026n=wJjdz14nrhedln0s\u0026q=85\u0026s=171a8dd0d43182f3b386c25e13152d92","api":{"openapi":"swagger.yaml","playground":{"proxy":false},"mdx":{"auth":{"method":"bearer"},"server":"https://api.venice.ai/api/v1"}},"appearance":{"default":"dark"},"background":{"color":{"light":"#FFFFFF","dark":"#0E1217"}},"navbar":{"links":[],"primary":{"type":"button","label":"Try Venice","href":"https://venice.ai/chat?utm_source=venice-api-documentation"}},"footer":{"socials":{"x":"https://x.com/AskVenice","discord":"https://discord.gg/askvenice","github":"https://github.com/veniceai","linkedin":"https://www.linkedin.com/company/venice-ai"}},"seo":{"metatags":{"og:site_name":"Venice API Docs","og:locale":"en_US","og:logo":"/logo/light.svg","article:publisher":"Venice AI","twitter:site":"@AskVenice"},"indexing":"navigable"},"icons":{"library":"tabler"},"styling":{"codeblocks":"system","latex":true},"integrations":{"gtm":{"tagId":"GTM-KFP6HX49"},"plausible":{"domain":"docs.venice.ai"}},"navigation":{"languages":[{"language":"en","default":true,"href":"overview/about-venice"},{"language":"pt-BR","href":"pt-BR/overview/about-venice"},{"language":"ar","href":"ar/overview/about-venice"},{"language":"it","href":"it/overview/about-venice"},{"language":"de","href":"de/overview/about-venice"},{"language":"es","href":"es/overview/about-venice"},{"language":"fr","href":"fr/overview/about-venice"},{"language":"zh","href":"zh/overview/about-venice"},{"language":"ko","href":"ko/overview/about-venice"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"veniceai","hasAudioNarration":false,"actualSubdomain":"veniceai","customDomains":["docs.venice.ai"],"gitSource":{"type":"github","owner":"veniceai","repo":"api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aec9ec6dd9d9f5b04d8420d","collectionId":"48e07bb3-8c91-4215-a1af-927ace23b5de","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aec9ec6dd9d9f5b04d8420d"},"feedback":{"edits":true,"issues":true,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aec9ec6dd9d9f5b04d8420d","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"en","tag":"Models","count":560},{"language":"ar","tag":"النماذج","count":560},{"language":"de","tag":"Modelle","count":560},{"language":"es","tag":"Modelos","count":560},{"language":"fr","tag":"Modèles","count":560},{"language":"it","tag":"Modelli","count":560},{"language":"ko","tag":"모델","count":560},{"language":"pt-BR","tag":"Modelos","count":560},{"language":"zh","tag":"模型","count":560},{"language":"en","tag":"Docs","count":80},{"language":"ar","tag":"التوثيق","count":80},{"language":"de","tag":"Dokumentation","count":80},{"language":"es","tag":"Documentación","count":80},{"language":"fr","tag":"Documentation","count":80},{"language":"it","tag":"Documentazione","count":80},{"language":"ko","tag":"문서","count":80},{"language":"pt-BR","tag":"Documentação","count":80},{"language":"zh","tag":"文档","count":80},{"language":"en","tag":"API Reference","count":58},{"language":"en","tag":"Venice APIs","count":58},{"language":"ar","tag":"مرجع الـ API","count":58},{"language":"ar","tag":"Venice APIs","count":58},{"language":"de","tag":"API-Referenz","count":58},{"language":"de","tag":"Venice APIs","count":58},{"language":"es","tag":"Referencia de la API","count":58},{"language":"es","tag":"Venice APIs","count":58},{"language":"fr","tag":"Référence de l'API","count":58},{"language":"fr","tag":"Venice APIs","count":58},{"language":"it","tag":"Riferimento API","count":58},{"language":"it","tag":"Venice APIs","count":58},{"language":"ko","tag":"API 레퍼런스","count":58},{"language":"ko","tag":"Venice APIs","count":58},{"language":"pt-BR","tag":"Referência da API","count":58},{"language":"pt-BR","tag":"Venice APIs","count":58},{"language":"zh","tag":"API 参考","count":58},{"language":"zh","tag":"Venice APIs","count":58},{"language":"en","tag":"Audio","count":18},{"language":"en","tag":"Learn","count":18},{"language":"ar","tag":"الصوت","count":18},{"language":"ar","tag":"تعلّم","count":18},{"language":"de","tag":"Audio","count":18},{"language":"de","tag":"Lernen","count":18},{"language":"es","tag":"Audio","count":18},{"language":"es","tag":"Aprender","count":18},{"language":"fr","tag":"Audio","count":18},{"language":"fr","tag":"Apprendre","count":18},{"language":"it","tag":"Audio","count":18},{"language":"it","tag":"Impara","count":18},{"language":"ko","tag":"오디오","count":18},{"language":"ko","tag":"학습","count":18},{"language":"pt-BR","tag":"Áudio","count":18},{"language":"pt-BR","tag":"Aprender","count":18},{"language":"zh","tag":"音频","count":18},{"language":"zh","tag":"学习","count":18},{"language":"it","tag":"Immagini","count":12},{"language":"ko","tag":"이미지","count":12},{"language":"zh","tag":"图像","count":12},{"language":"en","tag":"Text \u0026 Chat","count":11},{"language":"ar","tag":"النص والدردشة","count":11},{"language":"de","tag":"Text \u0026 Chat","count":11},{"language":"es","tag":"Texto y chat","count":11},{"language":"fr","tag":"Texte et chat","count":11},{"language":"it","tag":"Testo e chat","count":11},{"language":"ko","tag":"텍스트 및 채팅","count":11},{"language":"pt-BR","tag":"Texto e chat","count":11},{"language":"zh","tag":"文本与聊天","count":11},{"language":"en","tag":"Agents \u0026 Integrations","count":10},{"language":"ar","tag":"الوكلاء والتكاملات","count":10},{"language":"de","tag":"Agenten \u0026 Integrationen","count":10},{"language":"es","tag":"Agentes e integraciones","count":10},{"language":"fr","tag":"Agents et intégrations","count":10},{"language":"it","tag":"Agenti e integrazioni","count":10},{"language":"ko","tag":"에이전트 및 통합","count":10},{"language":"pt-BR","tag":"Agentes e integrações","count":10},{"language":"zh","tag":"智能体与集成","count":10},{"language":"en","tag":"Video","count":9},{"language":"ar","tag":"الفيديو","count":9},{"language":"de","tag":"Video","count":9},{"language":"es","tag":"Vídeo","count":9},{"language":"fr","tag":"Vidéo","count":9},{"language":"it","tag":"Video","count":9},{"language":"ko","tag":"비디오","count":9},{"language":"pt-BR","tag":"Vídeo","count":9},{"language":"zh","tag":"视频","count":9},{"language":"en","tag":"Coding Tools","count":8},{"language":"ar","tag":"أدوات البرمجة","count":8},{"language":"de","tag":"Coding-Tools","count":8},{"language":"es","tag":"Herramientas de código","count":8},{"language":"fr","tag":"Outils de code","count":8},{"language":"pt-BR","tag":"Ferramentas de código","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"llms-txt-v2","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":"vite-origin","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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/veniceai/c65ef92b6a27d6fc/style.css"},{"filePath":"model-hub.css","href":"/_mintlify/custom/veniceai/ac07755c20ed1196/model-hub.css"}],"page":{"pagePath":"it/api-reference/endpoint/image/generate","slug":"/it/api-reference/endpoint/image/generate","pageMetadata":{"title":"Genera immagini","openapi":"POST /image/generate","og:title":"Image Generate | Venice API Docs","og:description":"Documentazione dell'API di generazione immagini di Venice.","description":"Generate an image based on input parameters\n\n**Authentication:** This endpoint accepts either a Bearer API key or a `SIGN-IN-WITH-X` header for x402 wallet-based authentication. The legacy `X-Sign-In-With-X` header is also accepted during migration. When using x402, a `402 Payment Required` response indicates insufficient balance and includes top-up instructions.","href":"/it/api-reference/endpoint/image/generate"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Generate an image based on input parameters\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Authentication:\"\n }), \" This endpoint accepts either a Bearer API key or a \", _jsx(_components.code, {\n children: \"SIGN-IN-WITH-X\"\n }), \" header for x402 wallet-based authentication. The legacy \", _jsx(_components.code, {\n children: \"X-Sign-In-With-X\"\n }), \" header is also accepted during migration. When using x402, a \", _jsx(_components.code, {\n children: \"402 Payment Required\"\n }), \" response indicates insufficient balance and includes top-up instructions.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`opzioni-di-dimensionamento`,children:`Opzioni di dimensionamento`}),`\n`,_jsx(_components.p,{children:`I modelli di immagine usano parametri di dimensionamento specifici per modello:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`I modelli basati su pixel accettano `,_jsx(_components.code,{children:`width`}),` e `,_jsx(_components.code,{children:`height`}),`, ad esempio `,_jsx(_components.code,{children:`venice-sd35`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`I modelli basati su aspect ratio accettano `,_jsx(_components.code,{children:`aspect_ratio`}),`, ad esempio `,_jsx(_components.code,{children:`qwen-image-2`}),`. La famiglia Qwen Image — `,_jsx(_components.code,{children:`qwen-image`}),`, `,_jsx(_components.code,{children:`qwen-image-3`}),`, `,_jsx(_components.code,{children:`qwen-image-3-pro`}),`, `,_jsx(_components.code,{children:`qwen-image-2-1-turbo`}),` e `,_jsx(_components.code,{children:`qwen-image-2-1-pro`}),` — `,_jsx(_components.strong,{children:`rifiuta`}),` `,_jsx(_components.code,{children:`width`}),` e `,_jsx(_components.code,{children:`height`}),` con un `,_jsx(_components.code,{children:`400`}),`; per questi modelli usa `,_jsx(_components.code,{children:`aspect_ratio`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`I modelli a livelli di risoluzione accettano sia `,_jsx(_components.code,{children:`aspect_ratio`}),` sia `,_jsx(_components.code,{children:`resolution`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Ad esempio, `,_jsx(_components.code,{children:`gpt-image-2`}),`, `,_jsx(_components.code,{children:`nano-banana-2`}),` e `,_jsx(_components.code,{children:`nano-banana-pro`}),` supportano i valori di `,_jsx(_components.code,{children:`resolution`}),` `,_jsx(_components.code,{children:`1K`}),`, `,_jsx(_components.code,{children:`2K`}),` e `,_jsx(_components.code,{children:`4K`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"gpt-image-2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a cinematic wide shot of Venice at sunset\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"aspect_ratio\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"16:9\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"4K\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"format\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"png\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Lo stesso pattern di dimensionamento a livelli di risoluzione si applica anche ai modelli Nano Banana:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"nano-banana-pro\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a serene canal in venice at sunset\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"aspect_ratio\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"16:9\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2K\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Per i modelli che accettano aspect ratio ma non espongono livelli di risoluzione, invia `,_jsx(_components.code,{children:`aspect_ratio`}),` senza `,_jsx(_components.code,{children:`resolution`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"qwen-image-2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a serene canal in venice at sunset\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"aspect_ratio\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"16:9\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Per i modelli che usano dimensioni in pixel dirette, invia invece `,_jsx(_components.code,{children:`width`}),` e `,_jsx(_components.code,{children:`height`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"venice-sd35\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a serene canal in venice at sunset\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"width\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1024`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"height\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1024`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Controlla `,_jsx(_components.a,{href:`/it/models/image`,children:`Modelli immagine`}),` o l’`,_jsx(_components.a,{href:`/it/api-reference/endpoint/models/list`,children:`endpoint Models`}),` per le opzioni di dimensionamento supportate da ciascun modello prima di mischiare campi di dimensionamento tra modelli diversi.`]}),`\n`,_jsx(Heading,{level:`2`,id:`livelli-di-qualità`,children:`Livelli di qualità`}),`\n`,_jsxs(_components.p,{children:[`Alcuni modelli accettano un parametro opzionale `,_jsx(_components.code,{children:`quality`}),` (`,_jsx(_components.code,{children:`low`}),`, `,_jsx(_components.code,{children:`medium`}),`, `,_jsx(_components.code,{children:`high`}),`) che bilancia fedeltà visiva e costo. I modelli che elencano `,_jsx(_components.code,{children:`qualities`}),` in `,_jsx(_components.code,{children:`model_spec.constraints`}),` da `,_jsx(_components.a,{href:`/it/api-reference/endpoint/models/list`,children:_jsx(_components.code,{children:`GET /models?type=image`})}),` accettano solo quei valori, e alcuni supportano solo un sottoinsieme come `,_jsx(_components.code,{children:`low`}),` e `,_jsx(_components.code,{children:`medium`}),`. Gli altri modelli ignorano il parametro.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"gpt-image-2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a cinematic wide shot of Venice at sunset\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"aspect_ratio\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"16:9\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"resolution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2K\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"quality\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"medium\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Quando ometti `,_jsx(_components.code,{children:`quality`}),`, il modello usa il proprio livello predefinito (`,_jsx(_components.code,{children:`high`}),` per `,_jsx(_components.code,{children:`gpt-image-2`}),`). Il prezzo dipende dalla combinazione di `,_jsx(_components.code,{children:`resolution`}),` e `,_jsx(_components.code,{children:`quality`}),` — i prezzi per livello per `,_jsx(_components.code,{children:`gpt-image-2`}),` (1K/2K/4K × low/medium/high) sono esposti sotto `,_jsx(_components.code,{children:`model_spec.pricing.quality`}),` nell’`,_jsx(_components.a,{href:`/it/api-reference/endpoint/models/list`,children:`endpoint Models`}),` ed elencati nella `,_jsx(_components.a,{href:`/it/overview/pricing`,children:`panoramica dei prezzi`}),`.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`I prezzi basati sulla qualità sono l’impostazione predefinita per tutti i chiamanti API e SDK — non è richiesto alcun header di opt-in. Le richieste che omettono `,_jsx(_components.code,{children:`quality`}),` vengono fatturate al livello predefinito del modello (`,_jsx(_components.code,{children:`high`}),` per `,_jsx(_components.code,{children:`gpt-image-2`}),`).`]})}),`\n`,_jsx(Heading,{level:`2`,id:`postman-collection`,children:`Postman Collection`}),`\n`,_jsxs(_components.p,{children:[`Per ulteriori esempi, consulta questa `,_jsx(_components.a,{href:`https://www.postman.com/veniceai/workspace/venice-ai-workspace/folder/38652128-0adc004d-2edf-4b88-a3bb-0f868c791c9c?action=share\u0026source=copy-link\u0026creator=38652128\u0026ctx=documentation`,children:`Postman Collection`}),`.`]}),`\n`,_jsx(_components.hr,{})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Genera immagini","openapi":"POST /image/generate","og:title":"Image Generate | Venice API Docs","og:description":"Documentazione dell'API di generazione immagini di Venice.","description":"Generate an image based on input parameters\n\n**Authentication:** This endpoint accepts either a Bearer API key or a `SIGN-IN-WITH-X` header for x402 wallet-based authentication. The legacy `X-Sign-In-With-X` header is also accepted during migration. When using x402, a `402 Payment Required` response indicates insufficient balance and includes top-up instructions.","href":"/it/api-reference/endpoint/image/generate"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Opzioni di dimensionamento","slug":"opzioni-di-dimensionamento","depth":2,"children":[]},{"title":"Livelli di qualità","slug":"livelli-di-qualità","depth":2,"children":[]},{"title":"Postman Collection","slug":"postman-collection","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/veniceai/e2ef95b7f404dd19/model-search.js"],"openApiReferenceData":{"operation":{"description":"Generate an image based on input parameters\n\n**Authentication:** This endpoint accepts either a Bearer API key or a `SIGN-IN-WITH-X` header for x402 wallet-based authentication. The legacy `X-Sign-In-With-X` header is also accepted during migration. When using x402, a `402 Payment Required` response indicates insufficient balance and includes top-up instructions.","operationId":"generateImage","parameters":["02031988-9ffc-4a86-8b21-3ac0019ffa31"],"security":["b3d82b45-0ce1-4c76-b078-0fefbe483bc0","78959a10-6579-47fc-b546-5efbe0f49ad6"],"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"0.001","max":"10.00"},"protocols":[{"x402":{}}]},"summary":"/api/v1/image/generate","tags":["Image"],"requestBody":"0edeed44-c798-4630-a62a-ecb513acdd5f","responses":{"200":"00198033-b1d6-430f-b6d4-3482cefa0149","400":"61a7995b-9878-4fef-9918-8d8938bb2456","401":"c0baa529-ee0c-40fe-ab1b-189d727ecc93","402":"334f87b9-4df6-4e8d-8bbc-379fe551ddfd","403":"a1e124be-fdfe-48dc-a3e6-c1f06a4fc8c4","415":"328057b6-dd3b-44e3-b8aa-62b2a9e73955","422":"747c3996-921c-4bf7-b9ae-949d0815a45c","429":"b306f1f4-9603-410e-82ae-3f5b98faae23","500":"d769fedd-e070-4aa6-9e84-97bfd5c33a98","503":"4c9cad49-a927-4b96-b301-a87555a5ec12"},"method":"post","type":"path","servers":["96b8ffc4-1f58-4ed1-b77c-eaed66e7de5d"],"path":"/image/generate","baseUrlOptions":["https://api.venice.ai/api/v1"],"title":"/api/v1/image/generate","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"02031988-9ffc-4a86-8b21-3ac0019ffa31":{"description":"Supported compression encodings (gzip, br). Only applied when return_binary is false.","in":"header","name":"Accept-Encoding","required":false,"schema":{"example":"gzip, br","type":"string","isRequired":false,"description":"Supported compression encodings (gzip, br). Only applied when return_binary is false.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","description":"The model to use for image generation.","example":"grok-imagine-image","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"prompt":{"type":"string","minLength":1,"maxLength":7500,"description":"The description for the image. Character limit is model specific and is listed in the promptCharacterLimit setting in the model list endpoint.","example":"A beautiful sunset over a mountain range","isRequired":true,"uniqueKey":"prompt","typeLabel":"string"},"anon_user_id":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[\\x20-\\x7E]+$","description":"Optional identifier for the API customer's end user. Combined with the Venice user id when attributing the request to upstream providers. Distinct from the discarded OpenAI `user` field. Must be printable ASCII and must not contain `||`.","example":"end-user-123","uniqueKey":"anon_user_id","typeLabel":"string"},"cfg_scale":{"type":"number","minimum":0,"exclusiveMinimum":true,"maximum":20,"description":"CFG scale parameter. Higher values lead to more adherence to the prompt.","example":7.5,"uniqueKey":"cfg_scale","typeLabel":"number"},"embed_exif_metadata":{"type":"boolean","default":false,"description":"Embed prompt generation information into the image's EXIF metadata.","example":false,"uniqueKey":"embed_exif_metadata","typeLabel":"boolean"},"format":{"type":"string","enum":["jpeg","png","webp"],"default":"webp","description":"The image format to return. WebP are smaller and optimized for web use. PNG are higher quality but larger in file size. ","example":"webp","uniqueKey":"format","typeLabel":"enum\u003cstring>"},"height":{"type":"integer","minimum":0,"exclusiveMinimum":true,"maximum":1280,"default":1024,"description":"Height of the generated image.","example":1024,"uniqueKey":"height","typeLabel":"integer"},"hide_watermark":{"type":"boolean","default":false,"description":"Whether to hide the Venice watermark. Venice may ignore this parameter for certain generated content.","example":false,"uniqueKey":"hide_watermark","typeLabel":"boolean"},"inpaint":{"oneOf":[{"description":"This feature is deprecated and was disabled on May 19th, 2025. A revised in-painting API will be launched in the near future.","deprecated":true,"uniqueKey":"inpaint.oneOf.0","typeLabel":"any"},{"description":"This feature is deprecated and was disabled on May 19th, 2025. A revised in-painting API will be launched in the near future.","deprecated":true,"type":"null","uniqueKey":"inpaint.oneOf.1","typeLabel":"null"}],"uniqueKey":"inpaint","typeLabel":"any | null"},"lora_strength":{"type":"integer","minimum":0,"maximum":100,"description":"Lora strength for the model. Only applies if the model uses additional Loras.","example":50,"uniqueKey":"lora_strength","typeLabel":"integer"},"negative_prompt":{"type":"string","maxLength":7500,"description":"A description of what should not be in the image. Character limit is model specific and is listed in the promptCharacterLimit constraint in the model list endpoint.","example":"Clouds, Rain, Snow","uniqueKey":"negative_prompt","typeLabel":"string"},"return_binary":{"type":"boolean","default":false,"description":"Whether to return binary image data instead of base64.","example":false,"uniqueKey":"return_binary","typeLabel":"boolean"},"variants":{"type":"integer","minimum":1,"maximum":4,"description":"Number of images to generate (1–4). Only supported when return_binary is false. Variants the model provider explicitly rejects under its content policy are omitted from a successful partial response. Other moderation outcomes can still return blacked-out images; check `x-venice-is-content-violation`.","example":3,"uniqueKey":"variants","typeLabel":"integer"},"safe_mode":{"type":"boolean","default":true,"description":"Whether to blur images classified as adult content. Defaults to true. Set to false to receive unblurred output. No Pro subscription is required, and the mature filter setting in the Venice app does not affect this. The x-venice-is-blurred response header reports whether the returned image was blurred.","example":false,"uniqueKey":"safe_mode","typeLabel":"boolean"},"seed":{"type":"integer","minimum":-999999999,"maximum":999999999,"default":0,"description":"Random seed for generation. If not provided, a random seed will be used.","example":123456789,"uniqueKey":"seed","typeLabel":"integer"},"steps":{"type":"integer","default":8,"description":"Number of inference steps. This model does not support steps - this field is ignored.","example":8,"uniqueKey":"steps","typeLabel":"integer"},"style_preset":{"type":"string","description":"An image style to apply to the image. Visit https://docs.venice.ai/api-reference/endpoint/image/styles for more details.","example":"3D Model","uniqueKey":"style_preset","typeLabel":"string"},"aspect_ratio":{"type":"string","description":"Aspect ratio (utilized by certain image models including Nano Banana). Examples: \"1:1\", \"16:9\".","example":"1:1","uniqueKey":"aspect_ratio","typeLabel":"string"},"resolution":{"type":"string","description":"Resolution (utilized by certain image models including Nano Banana). Examples: \"1K\", \"2K\", \"4K\".","example":"1K","uniqueKey":"resolution","typeLabel":"string"},"quality":{"type":"string","enum":["low","medium","high"],"description":"Output quality for supported models (e.g. GPT Image 2 / GPT Image 2 Edit). Higher values can increase the final request charge. See the model list for supported options.","example":"high","uniqueKey":"quality","typeLabel":"enum\u003cstring>"},"transparent_background":{"type":"boolean","description":"Return the image with a transparent background (alpha channel). Only supported by models with `supportsTransparentBackground: true` in their constraints (see GET /api/v1/models), and requires `format` png or webp; otherwise the request is rejected. Omit or set to false to keep the model default background.","example":false,"uniqueKey":"transparent_background","typeLabel":"boolean"},"enable_web_search":{"type":"boolean","description":"Enable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image. Only supported by certain models. If web search is used, additional credits are getting charged.","example":false,"uniqueKey":"enable_web_search","typeLabel":"boolean"},"disable_prompt_optimization_thinking":{"type":"boolean","description":"Skip the model's prompt-optimization thinking step for faster generation. Only supported by models with `supportsOptimizePromptThinking`; ignored by others. Omit to use the model default.","example":false,"uniqueKey":"disable_prompt_optimization_thinking","typeLabel":"boolean"},"enhance_prompt":{"type":"boolean","description":"Rewrite the prompt before generation to add clarifying visual detail. Additional credits are charged when a rewrite is generated. Adds up to ~30 seconds before generation starts. When enhancement is applied, the final prompt is returned URL-encoded in the `x-venice-enhanced-prompt` response header. Defaults to false.","example":false,"uniqueKey":"enhance_prompt","typeLabel":"boolean"},"width":{"type":"integer","minimum":0,"exclusiveMinimum":true,"maximum":1280,"default":1024,"description":"Width of the generated image.","example":1024,"uniqueKey":"width","typeLabel":"integer"},"style_references":{"type":"array","items":{"type":"object","properties":{"image":{"oneOf":[{"type":"string","description":"A style reference image as a base64-encoded string (raw or data URI) or a URL starting with http:// or https://. Must be less than 8MB.","example":"https://example.com/style-reference.png","isRequired":true,"uniqueKey":"style_references.items.[INDEX].image.oneOf.0","typeLabel":"string"},{"type":"string","description":"A style reference image as a base64-encoded string (raw or data URI) or a URL starting with http:// or https://. Must be less than 8MB.","format":"uri","example":"https://example.com/style-reference.png","isRequired":true,"uniqueKey":"style_references.items.[INDEX].image.oneOf.1","typeLabel":"string\u003curi>"}],"isRequired":true,"uniqueKey":"style_references.items.[INDEX].image","typeLabel":"string | string\u003curi>"},"strength":{"type":"number","minimum":0.1,"maximum":1,"description":"How strongly the reference guides the output (0.1–1). Defaults to 0.5. Ignored by models where supportsStyleReferenceStrength is false.","example":0.5,"uniqueKey":"style_references.items.[INDEX].strength","typeLabel":"number"}},"required":["image"],"additionalProperties":false,"uniqueKey":"style_references.items.[INDEX]","typeLabel":"object"},"description":"Style reference images that guide the aesthetic of the generated image. Only supported by models with `supportsStyleReferences: true` (see GET /api/v1/models for the per-model `maxStyleReferences` limit).","example":[{"image":"https://example.com/style-reference.png","strength":0.5}],"uniqueKey":"style_references","typeLabel":"object[]"}},"required":["model","prompt"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"model":"grok-imagine-image","prompt":"A beautiful sunset over a mountain range","anon_user_id":"end-user-123","cfg_scale":7.5,"embed_exif_metadata":false,"format":"webp","height":1024,"hide_watermark":false,"inpaint":"\u003cunknown>","lora_strength":50,"negative_prompt":"Clouds, Rain, Snow","return_binary":false,"variants":3,"safe_mode":false,"seed":123456789,"steps":8,"style_preset":"3D Model","aspect_ratio":"1:1","resolution":"1K","quality":"high","transparent_background":false,"enable_web_search":false,"disable_prompt_optimization_thinking":false,"enhance_prompt":false,"width":1024,"style_references":[{"image":"https://example.com/style-reference.png","strength":0.5}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"00198033-b1d6-430f-b6d4-3482cefa0149":{"description":"Successfully generated image","headers":{"X-Balance-Remaining":{"description":"Remaining x402 credit balance in USD after this request (only present for x402 auth).","required":false,"schema":{"type":"string","example":"4.230000"}},"Content-Encoding":{"description":"The encoding used to compress the response","schema":{"enum":["gzip","br"],"type":"string"}},"x-venice-is-blurred":{"description":"Indicates if the generated image is blurred. When Safe Venice is enabled, adult material will be returned blurred.","required":false,"schema":{"type":"boolean"}},"x-venice-is-content-violation":{"description":"Indicates if the generated image does not meet Venice terms of service.","required":false,"schema":{"type":"boolean"}},"x-venice-content-violation-count":{"description":"Number of requested variants omitted because the model provider explicitly rejected them under its content policy. Other moderation outcomes can still return blacked-out images flagged by `x-venice-is-content-violation`.","required":false,"schema":{"minimum":1,"type":"integer"}},"x-venice-model-deprecation-warning":{"description":"A warning that the model is scheduled for deprecation","required":false,"schema":{"type":"string"}},"x-venice-model-deprecation-date":{"description":"The date the model is scheduled for deprecation","required":false,"schema":{"type":"string","format":"date-time"}},"x-venice-deprecated":{"description":"Present and set to \"true\" when the model is deprecated. Absent otherwise.","required":false,"schema":{"type":"string","enum":["true"]}},"x-venice-deprecated-replacement":{"description":"Public API model ID clients should migrate to. Only present when a replacement is published.","required":false,"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the request.","example":"generate-image-1234567890","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"images":{"type":"array","items":{"type":"string","uniqueKey":"images.items.[INDEX]","typeLabel":"string"},"description":"Base64 encoded image data. A partial response can contain fewer entries than requested.","isRequired":true,"uniqueKey":"images","typeLabel":"string[]"},"timing":{"type":"object","properties":{"inferenceDuration":{"type":"number","description":"Duration of inference in milliseconds","isRequired":true,"uniqueKey":"timing.inferenceDuration","typeLabel":"number"},"inferencePreprocessingTime":{"type":"number","description":"Duration of preprocessing in milliseconds","isRequired":true,"uniqueKey":"timing.inferencePreprocessingTime","typeLabel":"number"},"inferenceQueueTime":{"type":"number","description":"Duration of queueing in milliseconds","isRequired":true,"uniqueKey":"timing.inferenceQueueTime","typeLabel":"number"},"total":{"type":"number","description":"Total duration of the request in milliseconds","isRequired":true,"uniqueKey":"timing.total","typeLabel":"number"}},"required":["inferenceDuration","inferencePreprocessingTime","inferenceQueueTime","total"],"isRequired":true,"uniqueKey":"timing","typeLabel":"object"},"content_policy_violation_count":{"type":"integer","minimum":1,"description":"Number of requested variants omitted because the model provider explicitly rejected them under its content policy. Other moderation outcomes can still return blacked-out images flagged by `x-venice-is-content-violation`.","example":1,"uniqueKey":"content_policy_violation_count","typeLabel":"integer"},"request":{"oneOf":[{"description":"The original request data sent to the API.","uniqueKey":"request.oneOf.0","typeLabel":"any"},{"description":"The original request data sent to the API.","type":"null","uniqueKey":"request.oneOf.1","typeLabel":"null"}],"uniqueKey":"request","typeLabel":"any | null"}},"required":["id","images","timing"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"generate-image-1234567890","images":["\u003cstring>"],"timing":{"inferenceDuration":123,"inferencePreprocessingTime":123,"inferenceQueueTime":123,"total":123},"content_policy_violation_count":1,"request":"\u003cunknown>"}}},"exampleType":"generated"},"image/jpeg":{"schema":{"description":"Raw image data when return_binary is true and format is jpeg","format":"binary","type":"string","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"},"image/png":{"schema":{"description":"Raw image data when return_binary is true and format is png","format":"binary","type":"string","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"},"image/webp":{"schema":{"description":"Raw image data when return_binary is true and format is webp","format":"binary","type":"string","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"exampleType":"generated"},"61a7995b-9878-4fef-9918-8d8938bb2456":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","properties":{},"description":"Details about the incorrect input","example":{"_errors":[],"field":{"_errors":["Field is required"]}},"uniqueKey":"details","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","details":{"_errors":[],"field":{"_errors":["Field is required"]}}}}},"exampleType":"generated"}},"exampleType":"generated"},"c0baa529-ee0c-40fe-ab1b-189d727ecc93":{"description":"- Authentication failed\n- This model is only available to Pro users","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"334f87b9-4df6-4e8d-8bbc-379fe551ddfd":{"description":"Payment or balance required. Response varies by authentication state:\n\n**API Key users:** Standard error response with `INSUFFICIENT_BALANCE` code. Top up your Venice balance at venice.ai.\n\n**Unauthenticated x402 discovery:** Structured x402 response with `x402Version`, `resource`, `accepts`, and `extensions[\"sign-in-with-x\"]`. The `accepts` array advertises Base and Solana payment requirements.\n\n**Authenticated x402 wallet users with insufficient credit:** Structured response with `PAYMENT_REQUIRED` code containing:\n- `topUpInstructions`: Step-by-step guide to top up via x402 protocol\n- `supportedTokens` / `supportedChains`: Accepted payment methods\n- `siwxChallenge`: Fresh Sign-In-With-X challenge metadata\n\nThe `PAYMENT-REQUIRED` header also contains a base64-encoded x402 protocol object with the payment requirements for programmatic discovery.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded JSON with x402 payment requirements. Present on x402 middleware 402 responses. Decode to choose and sign one accepted payment requirement programmatically.","required":false,"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"string"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Returned when an inference request has no API key or wallet authentication. The JSON body includes x402 discovery requirements and authentication options.","required":["x402Version","resource","accepts","authOptions"],"properties":{"x402Version":{"type":"number","description":"x402 protocol version.","example":2,"isRequired":true,"uniqueKey":"oneOf.1.x402Version","typeLabel":"number"},"resource":{"type":"object","properties":{"url":{"type":"string","description":"Protected resource URL.","example":"https://api.venice.ai/api/v1/chat/completions","isRequired":true,"uniqueKey":"oneOf.1.resource.url","typeLabel":"string"},"description":{"type":"string","description":"Human-readable resource description.","example":"Venice API","isRequired":true,"uniqueKey":"oneOf.1.resource.description","typeLabel":"string"},"mimeType":{"type":"string","description":"Resource MIME type.","example":"application/json","isRequired":true,"uniqueKey":"oneOf.1.resource.mimeType","typeLabel":"string"}},"required":["url","description","mimeType"],"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.resource","typeLabel":"object"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","enum":["exact"],"description":"x402 payment scheme.","example":"exact","isRequired":true,"uniqueKey":"oneOf.1.accepts.items.[INDEX].scheme","typeLabel":"enum\u003cstring>"},"network":{"type":"string","description":"Payment network for this requirement.","example":"solana","isRequired":true,"uniqueKey":"oneOf.1.accepts.items.[INDEX].network","typeLabel":"string"},"asset":{"type":"string","description":"USDC token address or mint for the selected network.","example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","isRequired":true,"uniqueKey":"oneOf.1.accepts.items.[INDEX].asset","typeLabel":"string"},"amount":{"type":"string","description":"Required payment amount in base units (USDC has 6 decimals).","example":"10000000","isRequired":true,"uniqueKey":"oneOf.1.accepts.items.[INDEX].amount","typeLabel":"string"},"payTo":{"type":"string","description":"Receiver wallet address for the selected network.","example":"8qUL23aSj7mDWdoLMXGHFvnVCT9wd7jXcysiekroADEL","isRequired":true,"uniqueKey":"oneOf.1.accepts.items.[INDEX].payTo","typeLabel":"string"},"maxTimeoutSeconds":{"type":"number","description":"Maximum time allowed for payment settlement.","example":300,"isRequired":true,"uniqueKey":"oneOf.1.accepts.items.[INDEX].maxTimeoutSeconds","typeLabel":"number"},"extra":{"type":"object","properties":{},"description":"Network-specific x402 metadata. Solana requirements include a feePayer.","example":{"name":"USD Coin","version":"2","feePayer":"BFK9TLC3edb13K6v4YyH3DwPb5DSUpkWvb7XnqCL9b4F"},"isRequired":true,"uniqueKey":"oneOf.1.accepts.items.[INDEX].extra","typeLabel":"object"}},"required":["scheme","network","asset","amount","payTo","maxTimeoutSeconds","extra"],"additionalProperties":false,"uniqueKey":"oneOf.1.accepts.items.[INDEX]","typeLabel":"object"},"description":"Protocol payment requirements. Clients should choose one entry, such as Base or Solana, and sign exactly that requirement.","isRequired":true,"uniqueKey":"oneOf.1.accepts","typeLabel":"object[]"},"authOptions":{"type":"object","properties":{"apiKey":{"type":"object","properties":{"header":{"type":"string","description":"API key authentication header format.","example":"Authorization: Bearer YOUR_API_KEY","isRequired":true,"uniqueKey":"oneOf.1.authOptions.apiKey.header","typeLabel":"string"},"getKey":{"type":"string","description":"Where to create or manage API keys.","example":"https://venice.ai/settings/api","isRequired":true,"uniqueKey":"oneOf.1.authOptions.apiKey.getKey","typeLabel":"string"},"docs":{"type":"string","description":"API key documentation URL.","example":"https://docs.venice.ai/api-reference","isRequired":true,"uniqueKey":"oneOf.1.authOptions.apiKey.docs","typeLabel":"string"}},"required":["header","getKey","docs"],"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.authOptions.apiKey","typeLabel":"object"},"x402Wallet":{"type":"object","properties":{"header":{"type":"string","description":"Header used for Sign-In-With-X wallet authentication.","example":"SIGN-IN-WITH-X","isRequired":true,"uniqueKey":"oneOf.1.authOptions.x402Wallet.header","typeLabel":"string"},"legacyHeader":{"type":"string","description":"Legacy Sign-In-With-X header accepted during migration.","example":"X-Sign-In-With-X","isRequired":true,"uniqueKey":"oneOf.1.authOptions.x402Wallet.legacyHeader","typeLabel":"string"},"topUp":{"type":"string","description":"Endpoint used to discover and submit x402 top-up payments.","example":"POST /api/v1/x402/top-up","isRequired":true,"uniqueKey":"oneOf.1.authOptions.x402Wallet.topUp","typeLabel":"string"},"docs":{"type":"string","description":"x402 top-up API documentation URL.","example":"https://docs.venice.ai/api-reference/endpoint/x402/top-up","isRequired":true,"uniqueKey":"oneOf.1.authOptions.x402Wallet.docs","typeLabel":"string"}},"required":["header","legacyHeader","topUp","docs"],"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.authOptions.x402Wallet","typeLabel":"object"}},"required":["apiKey","x402Wallet"],"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.1.authOptions","typeLabel":"object"},"error":{"type":"string","description":"Human-readable payment requirement message.","example":"Payment required","uniqueKey":"oneOf.1.error","typeLabel":"string"},"extensions":{"type":"object","properties":{},"description":"Protocol extensions. Inference 402 responses include `sign-in-with-x` with a SIWX challenge for wallet-credit authentication.","uniqueKey":"oneOf.1.extensions","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"},{"type":"object","required":["error","code","reason","suggestedTopUpUsd","minimumTopUpUsd","supportedTokens","supportedChains","topUpInstructions","siwxChallenge"],"properties":{"error":{"type":"string","enum":["Payment required"],"description":"Error message indicating payment is required.","isRequired":true,"uniqueKey":"oneOf.2.error","typeLabel":"enum\u003cstring>"},"code":{"type":"string","enum":["PAYMENT_REQUIRED"],"description":"Machine-readable error code.","isRequired":true,"uniqueKey":"oneOf.2.code","typeLabel":"enum\u003cstring>"},"reason":{"type":"string","enum":["insufficient_balance"],"description":"Reason the x402-authenticated request could not proceed.","isRequired":true,"uniqueKey":"oneOf.2.reason","typeLabel":"enum\u003cstring>"},"suggestedTopUpUsd":{"type":"number","description":"Suggested amount to top up in USD.","example":10,"isRequired":true,"uniqueKey":"oneOf.2.suggestedTopUpUsd","typeLabel":"number"},"minimumTopUpUsd":{"type":"number","description":"Minimum allowed top-up amount in USD.","example":5,"isRequired":true,"uniqueKey":"oneOf.2.minimumTopUpUsd","typeLabel":"number"},"supportedTokens":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.2.supportedTokens.items.[INDEX]","typeLabel":"string"},"description":"List of supported token symbols for payment.","example":["USDC"],"isRequired":true,"uniqueKey":"oneOf.2.supportedTokens","typeLabel":"string[]"},"supportedChains":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.2.supportedChains.items.[INDEX]","typeLabel":"string"},"description":"List of supported top-up rails.","example":["base","solana"],"isRequired":true,"uniqueKey":"oneOf.2.supportedChains","typeLabel":"string[]"},"topUpInstructions":{"type":"object","properties":{"step1":{"type":"string","description":"First step: get payment requirements.","example":"POST /api/v1/x402/top-up with no payment header to get payment requirements","isRequired":true,"uniqueKey":"oneOf.2.topUpInstructions.step1","typeLabel":"string"},"step2":{"type":"string","description":"Second step: sign the payment.","example":"Choose a payment option from accepts and sign a USDC transfer authorization using the x402 SDK (createPaymentHeader)","isRequired":true,"uniqueKey":"oneOf.2.topUpInstructions.step2","typeLabel":"string"},"step3":{"type":"string","description":"Third step: submit the payment.","example":"POST /api/v1/x402/top-up with the signed PAYMENT-SIGNATURE header","isRequired":true,"uniqueKey":"oneOf.2.topUpInstructions.step3","typeLabel":"string"},"receiverWallet":{"type":"string","description":"Legacy Base receiver wallet address. Prefer the selected accepts entry from /x402/top-up for network-specific payTo values.","example":"\u003cRECEIVER_WALLET_ADDRESS>","isRequired":true,"uniqueKey":"oneOf.2.topUpInstructions.receiverWallet","typeLabel":"string"},"tokenAddress":{"type":"string","description":"Legacy Base USDC token address. Prefer the selected accepts entry from /x402/top-up for network-specific assets.","example":"\u003cUSDC_TOKEN_ADDRESS>","isRequired":true,"uniqueKey":"oneOf.2.topUpInstructions.tokenAddress","typeLabel":"string"},"tokenDecimals":{"type":"number","description":"Token decimal places.","example":6,"isRequired":true,"uniqueKey":"oneOf.2.topUpInstructions.tokenDecimals","typeLabel":"number"},"network":{"type":"string","description":"Legacy Base target network. Prefer the selected accepts entry from /x402/top-up for network-specific values.","example":"eip155:8453","isRequired":true,"uniqueKey":"oneOf.2.topUpInstructions.network","typeLabel":"string"},"minimumAmountUsd":{"type":"number","description":"Minimum top-up amount in USD.","example":5,"isRequired":true,"uniqueKey":"oneOf.2.topUpInstructions.minimumAmountUsd","typeLabel":"number"}},"required":["step1","step2","step3","receiverWallet","tokenAddress","tokenDecimals","network","minimumAmountUsd"],"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.2.topUpInstructions","typeLabel":"object"},"siwxChallenge":{"type":"object","properties":{"info":{"type":"object","properties":{"domain":{"type":"string","description":"Domain for the SIWX challenge.","example":"api.venice.ai","isRequired":true,"uniqueKey":"oneOf.2.siwxChallenge.info.domain","typeLabel":"string"},"uri":{"type":"string","description":"Resource URI for the challenge.","example":"https://api.venice.ai/api/v1/chat/completions","isRequired":true,"uniqueKey":"oneOf.2.siwxChallenge.info.uri","typeLabel":"string"},"version":{"type":"string","description":"SIWX version.","example":"1","isRequired":true,"uniqueKey":"oneOf.2.siwxChallenge.info.version","typeLabel":"string"},"nonce":{"type":"string","description":"Unique nonce for replay protection.","example":"{{nonce}}","isRequired":true,"uniqueKey":"oneOf.2.siwxChallenge.info.nonce","typeLabel":"string"},"issuedAt":{"type":"string","description":"ISO timestamp when the challenge was issued.","example":"2026-04-09T12:00:00.000Z","isRequired":true,"uniqueKey":"oneOf.2.siwxChallenge.info.issuedAt","typeLabel":"string"},"expirationTime":{"type":"string","description":"ISO timestamp when the challenge expires.","example":"2026-04-09T12:05:00.000Z","isRequired":true,"uniqueKey":"oneOf.2.siwxChallenge.info.expirationTime","typeLabel":"string"},"statement":{"type":"string","description":"Human-readable statement for the signature.","example":"Sign in to Venice AI","isRequired":true,"uniqueKey":"oneOf.2.siwxChallenge.info.statement","typeLabel":"string"}},"required":["domain","uri","version","nonce","issuedAt","expirationTime","statement"],"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.2.siwxChallenge.info","typeLabel":"object"},"supportedChains":{"type":"array","items":{"type":"object","properties":{"chainId":{"type":"string","description":"Supported chain identity.","example":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","isRequired":true,"uniqueKey":"oneOf.2.siwxChallenge.supportedChains.items.[INDEX].chainId","typeLabel":"string"},"type":{"type":"string","enum":["eip191","eip1271","ed25519"],"description":"Signature type accepted for this chain.","example":"ed25519","isRequired":true,"uniqueKey":"oneOf.2.siwxChallenge.supportedChains.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"required":["chainId","type"],"additionalProperties":false,"uniqueKey":"oneOf.2.siwxChallenge.supportedChains.items.[INDEX]","typeLabel":"object"},"description":"Supported SIWX chains and signature types.","isRequired":true,"uniqueKey":"oneOf.2.siwxChallenge.supportedChains","typeLabel":"object[]"}},"required":["info","supportedChains"],"additionalProperties":false,"isRequired":true,"uniqueKey":"oneOf.2.siwxChallenge","typeLabel":"object"},"message":{"type":"string","description":"Human-readable context about the payment requirement.","example":"Insufficient x402 balance","uniqueKey":"oneOf.2.message","typeLabel":"string"},"currentBalanceUsd":{"type":"number","description":"Current x402 credit balance for the wallet.","example":0.01,"uniqueKey":"oneOf.2.currentBalanceUsd","typeLabel":"number"},"minimumBalanceUsd":{"type":"number","description":"Minimum x402 credit balance required before the request can run.","example":0.1,"uniqueKey":"oneOf.2.minimumBalanceUsd","typeLabel":"number"},"description":{"type":"string","description":"Protected resource description.","example":"Venice API","uniqueKey":"oneOf.2.description","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"oneOf.2","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"a1e124be-fdfe-48dc-a3e6-c1f06a4fc8c4":{"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["This API key is restricted to configured IP addresses, and this request's source IP is not allowed"],"description":"A description of the error","example":"This API key is restricted to configured IP addresses, and this request's source IP is not allowed","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"This API key is restricted to configured IP addresses, and this request's source IP is not allowed"}}},"exampleType":"generated"}},"description":"This API key is restricted to configured IP addresses, and this request's source IP is not allowed","exampleType":"generated"},"328057b6-dd3b-44e3-b8aa-62b2a9e73955":{"description":"Invalid request content-type","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"747c3996-921c-4bf7-b9ae-949d0815a45c":{"description":"The prompt violates the content policy of Venice.ai or the model provider, or a style reference image exceeds the pixel limit.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"suggested_prompt":{"type":"string","description":"An optional provider-suggested replacement prompt that complies with content policy.","example":"A watercolor painting of a lighthouse on a rocky coast at sunset.","uniqueKey":"suggested_prompt","typeLabel":"string"},"recommended_model":{"type":"string","description":"A model ID that can be used as an alternative when a recommendation is available.","example":"chroma","uniqueKey":"recommended_model","typeLabel":"string"},"retryable":{"type":"boolean","description":"Present on every content-policy rejection: whether retrying the same request may succeed. True when the selected model's provider moderation is nondeterministic; false when the same request would be rejected again. Absent on other 422 errors, such as an input image that exceeds the pixel limit.","example":true,"uniqueKey":"retryable","typeLabel":"boolean"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","suggested_prompt":"A watercolor painting of a lighthouse on a rocky coast at sunset.","recommended_model":"chroma","retryable":true}}},"exampleType":"generated"}},"exampleType":"generated"},"b306f1f4-9603-410e-82ae-3f5b98faae23":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"d769fedd-e070-4aa6-9e84-97bfd5c33a98":{"description":"Inference processing failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"4c9cad49-a927-4b96-b301-a87555a5ec12":{"description":"The model is at capacity. Please try again later.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"A description of the error","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"b3d82b45-0ce1-4c76-b078-0fefbe483bc0":{"BearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}},"78959a10-6579-47fc-b546-5efbe0f49ad6":{"siwx":{"description":"Wallet-based authentication using the x402 protocol (Sign-In-With-X). Supports EVM SIWE signatures on Base and Ed25519 signatures on Solana mainnet.\n\n**Header format:** Base64-encoded JSON object with the following fields:\n- `address` — EVM or Solana wallet address\n- `message` — Signed SIWX message. EVM wallets use EIP-4361 SIWE; Solana wallets use the Solana SIWX message format.\n- `signature` — Signature of the message, signed by the wallet's private key. EVM signatures are hex; Solana signatures may be base58 or base64.\n- `timestamp` — Unix timestamp in milliseconds\n- `chainId` — Chain identity. Use `8453`, `\"8453\"`, or `\"eip155:8453\"` for Base; use `\"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\"` for Solana.\n- `type` — Optional signature type. Use `\"ed25519\"` for Solana. Omitted means EVM/EIP-191 for backward compatibility.\n\n**EVM SIWE message fields:**\n- `domain`: `api.venice.ai`\n- `uri`: `https://api.venice.ai`\n- `version`: `\"1\"`\n- `chainId`: `8453`\n- `nonce`: Random 16-character hex string\n- `issuedAt` / `expirationTime`: ISO timestamps (recommended TTL: 10 minutes)\n- `statement`: `\"Sign in to Venice API\"`\n\n**Example (TypeScript):**\n```\nimport { Wallet } from 'ethers'\nimport { SiweMessage } from 'siwe'\n\nconst wallet = new Wallet(PRIVATE_KEY)\nconst msg = new SiweMessage({ domain: 'api.venice.ai', address: wallet.address, statement: 'Sign in to Venice API', uri: 'https://api.venice.ai', version: '1', chainId: 8453, nonce: crypto.randomUUID().replace(/-/g, '').slice(0, 16), issuedAt: new Date().toISOString(), expirationTime: new Date(Date.now() + 600000).toISOString() })\nconst signature = await wallet.signMessage(msg.prepareMessage())\nconst header = btoa(JSON.stringify({ address: wallet.address, message: msg.prepareMessage(), signature, timestamp: Date.now(), chainId: 8453 }))\n// Set header: SIGN-IN-WITH-X: \u003cheader>\n```\n\n**Solana message fields:** The signed message starts with `\u003cdomain> wants you to sign in with your Solana account:`, followed by the wallet address and the standard `URI`, `Version`, `Chain ID`, `Nonce`, `Issued At`, and optional `Expiration Time` fields. Use `type: \"ed25519\"` and `chainId: \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\"` in the encoded JSON payload.\n\n**SDK:** `npm install venice-x402-client` provides `VeniceClient` and `createAuthFetch` which handle this automatically.\n\n**Billing:** x402 users pay from a prepaid USDC credit balance. Top up via `POST /x402/top-up`. When balance is insufficient, endpoints return `402` with structured top-up instructions.","in":"header","name":"SIGN-IN-WITH-X","type":"apiKey","scopes":[],"schemeName":"siwx"}}},"servers":{"96b8ffc4-1f58-4ed1-b77c-eaed66e7de5d":{"url":"https://api.venice.ai/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"},{"schemes":[{"scheme":{"description":"Wallet-based authentication using the x402 protocol (Sign-In-With-X). Supports EVM SIWE signatures on Base and Ed25519 signatures on Solana mainnet.\n\n**Header format:** Base64-encoded JSON object with the following fields:\n- `address` — EVM or Solana wallet address\n- `message` — Signed SIWX message. EVM wallets use EIP-4361 SIWE; Solana wallets use the Solana SIWX message format.\n- `signature` — Signature of the message, signed by the wallet's private key. EVM signatures are hex; Solana signatures may be base58 or base64.\n- `timestamp` — Unix timestamp in milliseconds\n- `chainId` — Chain identity. Use `8453`, `\"8453\"`, or `\"eip155:8453\"` for Base; use `\"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\"` for Solana.\n- `type` — Optional signature type. Use `\"ed25519\"` for Solana. Omitted means EVM/EIP-191 for backward compatibility.\n\n**EVM SIWE message fields:**\n- `domain`: `api.venice.ai`\n- `uri`: `https://api.venice.ai`\n- `version`: `\"1\"`\n- `chainId`: `8453`\n- `nonce`: Random 16-character hex string\n- `issuedAt` / `expirationTime`: ISO timestamps (recommended TTL: 10 minutes)\n- `statement`: `\"Sign in to Venice API\"`\n\n**Example (TypeScript):**\n```\nimport { Wallet } from 'ethers'\nimport { SiweMessage } from 'siwe'\n\nconst wallet = new Wallet(PRIVATE_KEY)\nconst msg = new SiweMessage({ domain: 'api.venice.ai', address: wallet.address, statement: 'Sign in to Venice API', uri: 'https://api.venice.ai', version: '1', chainId: 8453, nonce: crypto.randomUUID().replace(/-/g, '').slice(0, 16), issuedAt: new Date().toISOString(), expirationTime: new Date(Date.now() + 600000).toISOString() })\nconst signature = await wallet.signMessage(msg.prepareMessage())\nconst header = btoa(JSON.stringify({ address: wallet.address, message: msg.prepareMessage(), signature, timestamp: Date.now(), chainId: 8453 }))\n// Set header: SIGN-IN-WITH-X: \u003cheader>\n```\n\n**Solana message fields:** The signed message starts with `\u003cdomain> wants you to sign in with your Solana account:`, followed by the wallet address and the standard `URI`, `Version`, `Chain ID`, `Nonce`, `Issued At`, and optional `Expiration Time` fields. Use `type: \"ed25519\"` and `chainId: \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\"` in the encoded JSON payload.\n\n**SDK:** `npm install venice-x402-client` provides `VeniceClient` and `createAuthFetch` which handle this automatically.\n\n**Billing:** x402 users pay from a prepaid USDC credit balance. Top up via `POST /x402/top-up`. When balance is insufficient, endpoints return `402` with structured top-up instructions.","in":"header","name":"SIGN-IN-WITH-X","type":"apiKey","scopes":[],"schemeName":"siwx"},"schema":{"title":"SIGN-IN-WITH-X","type":"string","description":"Wallet-based authentication using the x402 protocol (Sign-In-With-X). Supports EVM SIWE signatures on Base and Ed25519 signatures on Solana mainnet.\n\n**Header format:** Base64-encoded JSON object with the following fields:\n- `address` — EVM or Solana wallet address\n- `message` — Signed SIWX message. EVM wallets use EIP-4361 SIWE; Solana wallets use the Solana SIWX message format.\n- `signature` — Signature of the message, signed by the wallet's private key. EVM signatures are hex; Solana signatures may be base58 or base64.\n- `timestamp` — Unix timestamp in milliseconds\n- `chainId` — Chain identity. Use `8453`, `\"8453\"`, or `\"eip155:8453\"` for Base; use `\"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\"` for Solana.\n- `type` — Optional signature type. Use `\"ed25519\"` for Solana. Omitted means EVM/EIP-191 for backward compatibility.\n\n**EVM SIWE message fields:**\n- `domain`: `api.venice.ai`\n- `uri`: `https://api.venice.ai`\n- `version`: `\"1\"`\n- `chainId`: `8453`\n- `nonce`: Random 16-character hex string\n- `issuedAt` / `expirationTime`: ISO timestamps (recommended TTL: 10 minutes)\n- `statement`: `\"Sign in to Venice API\"`\n\n**Example (TypeScript):**\n```\nimport { Wallet } from 'ethers'\nimport { SiweMessage } from 'siwe'\n\nconst wallet = new Wallet(PRIVATE_KEY)\nconst msg = new SiweMessage({ domain: 'api.venice.ai', address: wallet.address, statement: 'Sign in to Venice API', uri: 'https://api.venice.ai', version: '1', chainId: 8453, nonce: crypto.randomUUID().replace(/-/g, '').slice(0, 16), issuedAt: new Date().toISOString(), expirationTime: new Date(Date.now() + 600000).toISOString() })\nconst signature = await wallet.signMessage(msg.prepareMessage())\nconst header = btoa(JSON.stringify({ address: wallet.address, message: msg.prepareMessage(), signature, timestamp: Date.now(), chainId: 8453 }))\n// Set header: SIGN-IN-WITH-X: \u003cheader>\n```\n\n**Solana message fields:** The signed message starts with `\u003cdomain> wants you to sign in with your Solana account:`, followed by the wallet address and the standard `URI`, `Version`, `Chain ID`, `Nonce`, `Issued At`, and optional `Expiration Time` fields. Use `type: \"ed25519\"` and `chainId: \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\"` in the encoded JSON payload.\n\n**SDK:** `npm install venice-x402-client` provides `VeniceClient` and `createAuthFetch` which handle this automatically.\n\n**Billing:** x402 users pay from a prepaid USDC credit balance. Top up via `POST /x402/top-up`. When balance is insufficient, endpoints return `402` with structured top-up instructions.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"siwx","name":"SIGN-IN-WITH-X"}],"title":"siwx"}]},"originalFileLocation":"swagger.yaml"},"subdomain":"veniceai","siteName":"Venice API Docs","title":"Image Generate | Venice API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/endpoint/image/generate","matchLevel":1},"pt-BR":{"href":"/pt-BR/api-reference/endpoint/image/generate","matchLevel":1},"ar":{"href":"/ar/api-reference/endpoint/image/generate","matchLevel":1},"it":{"href":"/it/api-reference/endpoint/image/generate","matchLevel":0},"de":{"href":"/de/api-reference/endpoint/image/generate","matchLevel":1},"es":{"href":"/es/api-reference/endpoint/image/generate","matchLevel":1},"fr":{"href":"/fr/api-reference/endpoint/image/generate","matchLevel":1},"zh":{"href":"/zh/api-reference/endpoint/image/generate","matchLevel":1},"ko":{"href":"/ko/api-reference/endpoint/image/generate","matchLevel":1}}},"lastModified":"2026-10-20T10:23:08.836Z","originalFileLocation":"it/api-reference/endpoint/image/generate.mdx","locale":"it"},"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=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Generate an image based on input parameters Authentication: This endpoint accepts either a Bearer API key or a SIGN-IN-WITH-X header for x402 wallet-based authentication. The legacy X-Sign-In-With-X header is also accepted during migration. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Venice API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Image Generate | Venice API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Documentazione dell\u0026#x27;API di generazione immagini di Venice.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Venice API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.venice.ai/it/api-reference/endpoint/image/generate\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://veniceai.mintlify.app/_mintlify/api/og/v2?division=Immagini\u0026amp;title=Genera+immagini\u0026amp;description=Generate+an+image+based+on+input+parameters%0A%0A**Authentication%3A**+This+endpoint+accepts+either+a+Bearer+API+key+or+a+%60SIGN-IN-WITH-X%60+header+for+x402+wallet-base\u0026amp;theme=c703b2b369bc0a924505c3f9\u0026amp;signature=340e1cb11ad77986bd50d6e5e6d8e5831d8d52c9a3641fbc0f5c3ace5adee1dd\">\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=\"Image Generate | Venice API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Documentazione dell\u0026#x27;API di generazione immagini di Venice.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://veniceai.mintlify.app/_mintlify/api/og/v2?division=Immagini\u0026amp;title=Genera+immagini\u0026amp;description=Generate+an+image+based+on+input+parameters%0A%0A**Authentication%3A**+This+endpoint+accepts+either+a+Bearer+API+key+or+a+%60SIGN-IN-WITH-X%60+header+for+x402+wallet-base\u0026amp;theme=c703b2b369bc0a924505c3f9\u0026amp;signature=340e1cb11ad77986bd50d6e5e6d8e5831d8d52c9a3641fbc0f5c3ace5adee1dd\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/veniceai/bx2bxRtmLEf0wvnq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Venice API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#125DA3\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"og:logo\" content=\"/logo/light.svg\">\u003cmeta data-mint-head name=\"article:publisher\" content=\"Venice AI\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.venice.ai/it/api-reference/endpoint/image/generate\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/it/api-reference/endpoint/image/generate.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.venice.ai/it/api-reference/endpoint/image/generate\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.venice.ai/api-reference/endpoint/image/generate\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.venice.ai/pt-BR/api-reference/endpoint/image/generate\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.venice.ai/ar/api-reference/endpoint/image/generate\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.venice.ai/de/api-reference/endpoint/image/generate\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.venice.ai/es/api-reference/endpoint/image/generate\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.venice.ai/fr/api-reference/endpoint/image/generate\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.venice.ai/zh/api-reference/endpoint/image/generate\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.venice.ai/ko/api-reference/endpoint/image/generate\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.venice.ai/api-reference/endpoint/image/generate\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.venice.ai/#organization\",\"name\":\"Venice API Docs\",\"url\":\"https://docs.venice.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/veniceai/gFXvp87w4B810n0Y/logo/light.svg?fit=max\u0026auto=format\u0026n=gFXvp87w4B810n0Y\u0026q=85\u0026s=121558c3bff1e4e012fcd34bdc50555c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.venice.ai#website\",\"name\":\"Venice API Docs\",\"url\":\"https://docs.venice.ai\",\"publisher\":{\"@id\":\"https://docs.venice.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.venice.ai/it/api-reference/endpoint/image/generate#webpage\",\"url\":\"https://docs.venice.ai/it/api-reference/endpoint/image/generate\",\"name\":\"Genera immagini\",\"description\":\"Generate an image based on input parameters Authentication: This endpoint accepts either a Bearer API key or a SIGN-IN-WITH-X header for x402 wallet-based authentication. The legacy X-Sign-In-With-X header is also accepted during migration. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.\",\"dateModified\":\"2026-10-20T10:23:08.836Z\",\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.venice.ai/it/api-reference/endpoint/image/generate#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.venice.ai/it/api-reference/endpoint/image/generate#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Venice APIs\",\"item\":\"https://docs.venice.ai/it/api-reference/api-spec\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Genera immagini\",\"item\":\"https://docs.venice.ai/it/api-reference/endpoint/image/generate\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.venice.ai/it/api-reference/endpoint/image/generate#apireference\",\"headline\":\"Genera immagini\",\"name\":\"Genera immagini\",\"description\":\"Generate an image based on input parameters Authentication: This endpoint accepts either a Bearer API key or a SIGN-IN-WITH-X header for x402 wallet-based authentication. The legacy X-Sign-In-With-X header is also accepted during migration. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.\",\"url\":\"https://docs.venice.ai/it/api-reference/endpoint/image/generate\",\"mainEntityOfPage\":{\"@id\":\"https://docs.venice.ai/it/api-reference/endpoint/image/generate#webpage\"},\"dateModified\":\"2026-10-20T10:23:08.836Z\",\"publisher\":{\"@id\":\"https://docs.venice.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Venice API Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Venice API Docs","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/api-reference/endpoint/image/generate"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/api-reference/endpoint/image/generate"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/api-reference/endpoint/image/generate"}]},{"language":"it","tabs":[{"tab":"Documentazione","icon":"book","pages":[{"title":"Documentazione","href":"/it/overview/about-venice"}]},{"tab":"Modelli","icon":"box","pages":[{"title":"Modelli","href":"/it/models/overview"}]},{"tab":"Impara","icon":"layout-grid","pages":[{"title":"Impara","href":"/it/learn"}]},{"tab":"Riferimento API","icon":"code","groups":[{"group":"Venice APIs","pages":[{"title":"Introduzione","href":"/it/api-reference/api-spec"},{"title":"Rate limit","href":"/it/api-reference/rate-limiting"},{"title":"Codici di errore","href":"/it/api-reference/error-codes"},{"group":"Chat","expanded":false,"pages":[{"title":"Chat Completions","openapi":"POST /chat/completions","href":"/it/api-reference/endpoint/chat/completions"},{"title":"Responses","openapi":"POST /responses","href":"/it/api-reference/endpoint/responses/create"},{"title":"Model Feature Suffix","href":"/it/api-reference/endpoint/chat/model_feature_suffix"},{"title":"Crea decisioni","openapi":"POST /decisions","href":"/it/api-reference/endpoint/decisions/create"},{"title":"Compatibilità con System One","openapi":"POST /systemone","description":"**Beta**: Alias of `POST /decisions` mirroring the upstream TypeSafe path, so TypeSafe SDKs work with a base URL swap (`TYPESAFE_BASE_URL=https://api.venice.ai/api`).","href":"/it/api-reference/endpoint/decisions/systemone"}]},{"group":"Immagini","expanded":false,"pages":[{"title":"Genera immagini","openapi":"POST /image/generate","href":"/it/api-reference/endpoint/image/generate"},{"title":"Upscale e miglioramento","openapi":"POST /image/upscale","description":"Upscale an image to a higher resolution. The image can be provided either as a multipart form-data file upload or as a base64-encoded string in a JSON request.\n\n**Authentication:** This endpoint accepts either a Bearer API key or a `SIGN-IN-WITH-X` header for x402 wallet-based authentication. The legacy `X-Sign-In-With-X` header is also accepted during migration. When using x402, a `402 Payment Required` response indicates insufficient balance and includes top-up instructions.","href":"/it/api-reference/endpoint/image/upscale"},{"title":"Edit (alias Inpaint)","openapi":"POST /image/edit","href":"/it/api-reference/endpoint/image/edit"},{"title":"Multi-Edit immagine","openapi":"POST /image/multi-edit","href":"/it/api-reference/endpoint/image/multi-edit"},{"title":"Rimozione sfondo","openapi":"POST /image/background-remove","href":"/it/api-reference/endpoint/image/background-remove"},{"title":"Stili immagine","openapi":"GET /image/styles","href":"/it/api-reference/endpoint/image/styles"},{"title":"Genera immagini (API OpenAI Compatible)","openapi":"POST /images/generations","href":"/it/api-reference/endpoint/image/generations"}]},{"group":"Audio","expanded":false,"pages":[{"title":"Speech API (Beta)","openapi":"POST /audio/speech","href":"/it/api-reference/endpoint/audio/speech"},{"title":"Clona voce","openapi":"POST /audio/voices","href":"/it/api-reference/endpoint/audio/voices"},{"title":"Transcriptions API (Beta)","openapi":"POST /audio/transcriptions","href":"/it/api-reference/endpoint/audio/transcriptions"},{"title":"Metti in coda generazione audio","openapi":"POST /audio/queue","href":"/it/api-reference/endpoint/audio/queue"},{"title":"Recupera audio","openapi":"POST /audio/retrieve","href":"/it/api-reference/endpoint/audio/retrieve"},{"title":"Preventivo generazione audio","openapi":"POST /audio/quote","href":"/it/api-reference/endpoint/audio/quote"},{"title":"Completa audio","openapi":"POST /audio/complete","href":"/it/api-reference/endpoint/audio/complete"},{"title":"Metti in coda Voice Changer","openapi":"POST /audio/voice-changer/queue","href":"/it/api-reference/endpoint/audio/voice-changer/queue"},{"title":"Recupera Voice Changer","openapi":"POST /audio/voice-changer/retrieve","href":"/it/api-reference/endpoint/audio/voice-changer/retrieve"},{"title":"Preventivo Voice Changer","openapi":"POST /audio/voice-changer/quote","href":"/it/api-reference/endpoint/audio/voice-changer/quote"},{"title":"Completa Voice Changer","openapi":"POST /audio/voice-changer/complete","href":"/it/api-reference/endpoint/audio/voice-changer/complete"}]},{"group":"Video","expanded":false,"pages":[{"title":"Metti in coda generazione video","openapi":"POST /video/queue","href":"/it/api-reference/endpoint/video/queue"},{"title":"Recupera video","openapi":"POST /video/retrieve","href":"/it/api-reference/endpoint/video/retrieve"},{"title":"Preventivo generazione video","openapi":"POST /video/quote","href":"/it/api-reference/endpoint/video/quote"},{"title":"Completa video","openapi":"POST /video/complete","href":"/it/api-reference/endpoint/video/complete"}]},{"group":"Strumenti","expanded":false,"pages":[{"title":"Text Parser","openapi":"POST /augment/text-parser","href":"/it/api-reference/endpoint/augment/text-parser"},{"title":"Web Scrape","openapi":"POST /augment/scrape","href":"/it/api-reference/endpoint/augment/scrape"},{"title":"Web Search","openapi":"POST /augment/search","href":"/it/api-reference/endpoint/augment/search"},{"title":"Reti crypto","openapi":"GET /crypto/rpc/networks","href":"/it/api-reference/endpoint/crypto/networks"},{"title":"Crypto RPC","openapi":"POST /crypto/rpc/{network}","href":"/it/api-reference/endpoint/crypto/rpc"}]},{"group":"Embedding","expanded":false,"pages":[{"title":"Genera embeddings","openapi":"POST /embeddings","href":"/it/api-reference/endpoint/embeddings/generate"}]},{"group":"Modelli","expanded":false,"pages":[{"title":"Elenca modelli","openapi":"GET /models","href":"/it/api-reference/endpoint/models/list"},{"title":"Mappatura di compatibilità","openapi":"GET /models/compatibility_mapping","href":"/it/api-reference/endpoint/models/compatibility_mapping"},{"title":"Caratteristiche","openapi":"GET /models/traits","href":"/it/api-reference/endpoint/models/traits"}]},{"group":"Chiavi API","expanded":false,"pages":[{"title":"Elenca API key","openapi":"GET /api_keys","href":"/it/api-reference/endpoint/api_keys/list"},{"title":"Ottieni dettagli API key","openapi":"GET /api_keys/{id}","href":"/it/api-reference/endpoint/api_keys/get"},{"title":"Crea API key","openapi":"POST /api_keys","href":"/it/api-reference/endpoint/api_keys/create"},{"title":"Aggiorna API key","openapi":"PATCH /api_keys","href":"/it/api-reference/endpoint/api_keys/update"},{"title":"Elimina API key","openapi":"DELETE /api_keys","href":"/it/api-reference/endpoint/api_keys/delete"},{"title":"Genera API key con wallet Web3","openapi":"GET /api_keys/generate_web3_key","href":"/it/api-reference/endpoint/api_keys/generate_web3_key/get"},{"title":"Genera API key con wallet Web3","openapi":"POST /api_keys/generate_web3_key","href":"/it/api-reference/endpoint/api_keys/generate_web3_key/post"}]},{"group":"Limiti delle chiavi API","expanded":false,"pages":[{"title":"Rate limit e saldi","openapi":"GET /api_keys/rate_limits","href":"/it/api-reference/endpoint/api_keys/rate_limits"},{"title":"Log dei rate limit","openapi":"GET /api_keys/rate_limits/log","href":"/it/api-reference/endpoint/api_keys/rate_limit_logs"}]},{"group":"Personaggi","expanded":false,"pages":[{"title":"Ottieni personaggio","openapi":"GET /characters/{slug}","href":"/it/api-reference/endpoint/characters/get"},{"title":"Elenca personaggi","openapi":"GET /characters","href":"/it/api-reference/endpoint/characters/list"},{"title":"Elenca recensioni personaggio","openapi":"GET /characters/{slug}/reviews","href":"/it/api-reference/endpoint/characters/reviews"}]},{"group":"Fatturazione","expanded":false,"pages":[{"title":"Saldo di fatturazione","openapi":"GET /billing/balance","href":"/it/api-reference/endpoint/billing/balance"},{"title":"Utilizzo fatturazione (rimosso)","openapi":"GET /billing/usage","href":"/it/api-reference/endpoint/billing/usage"},{"title":"Billing Usage Analytics (Beta)","openapi":"GET /billing/usage-analytics","href":"/it/api-reference/endpoint/billing/usage-analytics"},{"title":"Cronologia utilizzo fatturazione","openapi":"GET /billing/usage-history","href":"/it/api-reference/endpoint/billing/usage-history"}]},{"group":"X402","expanded":true,"pages":[{"title":"Saldo X402","openapi":"GET /x402/balance/{walletAddress}","href":"/it/api-reference/endpoint/x402/balance"},{"title":"Ricarica X402","openapi":"POST /x402/top-up","href":"/it/api-reference/endpoint/x402/top-up"},{"title":"Transazioni X402","openapi":"GET /x402/transactions/{walletAddress}","href":"/it/api-reference/endpoint/x402/transactions"}]}]}]},{"tab":"Modifiche","icon":"history","href":"https://venice.ai/changelog"},{"tab":"Stato","icon":"activity","href":"https://veniceai-status.com"}]},{"language":"de","pages":[{"title":"de","href":"/de/api-reference/endpoint/image/generate"}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/endpoint/image/generate"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/api-reference/endpoint/image/generate"}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/api-reference/endpoint/image/generate"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/api-reference/endpoint/image/generate"}]}]},"basePath":"","title":"Image Generate | Venice API Docs","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-BAvA99GL.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}