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
}
Los modelos de imagen utilizan parámetros de tamaño específicos del modelo:
Los modelos basados en píxeles aceptan width y height, por ejemplo venice-sd35.
Los modelos basados en relación de aspecto aceptan aspect_ratio, por ejemplo qwen-image-2. La familia Qwen Image — qwen-image, qwen-image-3, qwen-image-3-pro, qwen-image-2-1-turbo y qwen-image-2-1-pro — rechazawidth y height con un 400; usa aspect_ratio con esos modelos.
Los modelos con niveles de resolución aceptan tanto aspect_ratio como resolution.
Por ejemplo, gpt-image-2, nano-banana-2 y nano-banana-pro admiten valores de resolution de 1K, 2K y 4K:
{ "model": "gpt-image-2", "prompt": "a cinematic wide shot of Venice at sunset", "aspect_ratio": "16:9", "resolution": "4K", "format": "png"}
El mismo patrón de tamaño por nivel de resolución también se aplica a los modelos Nano Banana:
{ "model": "nano-banana-pro", "prompt": "a serene canal in venice at sunset", "aspect_ratio": "16:9", "resolution": "2K"}
Para los modelos que aceptan relación de aspecto pero no exponen niveles de resolución, envía aspect_ratio sin resolution:
{ "model": "qwen-image-2", "prompt": "a serene canal in venice at sunset", "aspect_ratio": "16:9"}
Para los modelos que usan dimensiones directas en píxeles, envía width y height en su lugar:
{ "model": "venice-sd35", "prompt": "a serene canal in venice at sunset", "width": 1024, "height": 1024}
Consulta Modelos de imagen o el endpoint de Models para conocer las opciones de tamaño admitidas por cada modelo antes de mezclar campos de tamaño entre modelos.
Algunos modelos aceptan un parámetro opcional quality (low, medium, high) que intercambia fidelidad visual por coste. Los modelos que incluyen qualities en model_spec.constraints de GET /models?type=image solo aceptan esos valores, y algunos solo admiten un subconjunto, como low y medium. Otros modelos ignoran el parámetro.
{ "model": "gpt-image-2", "prompt": "a cinematic wide shot of Venice at sunset", "aspect_ratio": "16:9", "resolution": "2K", "quality": "medium"}
Cuando omites quality, el modelo utiliza su nivel predeterminado (high para gpt-image-2). El precio depende de la combinación de resolution y quality: los precios por nivel para gpt-image-2 (1K/2K/4K × low/medium/high) se exponen en model_spec.pricing.quality en el endpoint de Models y se listan en la vista general de precios.
La facturación según la calidad es la predeterminada para todos los llamadores de la API y del SDK: no se requiere ninguna cabecera de activación. Las solicitudes que omiten quality se facturan al nivel predeterminado del modelo (high para 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":"#125DA3","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"}},"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":"6aeba83883de95559c37383e","collectionId":"ba70b5b5-5a7f-43a9-aa61-8b1e89b3fc36","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeba83883de95559c37383e"},"feedback":{"edits":true,"issues":true,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeba83883de95559c37383e","clientVersion":"0.0.4067","searchFilterCounts":[{"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":"Models","count":11},{"language":"en","tag":"Text \u0026 Chat","count":11},{"language":"ar","tag":"النماذج","count":11},{"language":"ar","tag":"النص والدردشة","count":11},{"language":"de","tag":"Modelle","count":11},{"language":"de","tag":"Text \u0026 Chat","count":11},{"language":"es","tag":"Modelos","count":11},{"language":"es","tag":"Texto y chat","count":11},{"language":"fr","tag":"Modèles","count":11},{"language":"fr","tag":"Texte et chat","count":11},{"language":"it","tag":"Modelli","count":11},{"language":"it","tag":"Testo e chat","count":11},{"language":"ko","tag":"모델","count":11},{"language":"ko","tag":"텍스트 및 채팅","count":11},{"language":"pt-BR","tag":"Modelos","count":11},{"language":"pt-BR","tag":"Texto e chat","count":11},{"language":"zh","tag":"模型","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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/veniceai/38e9692f6f9630fd/style.css"}],"page":{"pagePath":"es/api-reference/endpoint/image/generate","slug":"/es/api-reference/endpoint/image/generate","pageMetadata":{"title":"Generar imágenes","openapi":"POST /image/generate","og:title":"Image Generate | Venice API Docs","og:description":"Documentación de la API de generación de imágenes de 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":"/es/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:`opciones-de-tamaño`,children:`Opciones de tamaño`}),`\n`,_jsx(_components.p,{children:`Los modelos de imagen utilizan parámetros de tamaño específicos del modelo:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Los modelos basados en píxeles aceptan `,_jsx(_components.code,{children:`width`}),` y `,_jsx(_components.code,{children:`height`}),`, por ejemplo `,_jsx(_components.code,{children:`venice-sd35`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Los modelos basados en relación de aspecto aceptan `,_jsx(_components.code,{children:`aspect_ratio`}),`, por ejemplo `,_jsx(_components.code,{children:`qwen-image-2`}),`. La familia 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`}),` y `,_jsx(_components.code,{children:`qwen-image-2-1-pro`}),` — `,_jsx(_components.strong,{children:`rechaza`}),` `,_jsx(_components.code,{children:`width`}),` y `,_jsx(_components.code,{children:`height`}),` con un `,_jsx(_components.code,{children:`400`}),`; usa `,_jsx(_components.code,{children:`aspect_ratio`}),` con esos modelos.`]}),`\n`,_jsxs(_components.li,{children:[`Los modelos con niveles de resolución aceptan tanto `,_jsx(_components.code,{children:`aspect_ratio`}),` como `,_jsx(_components.code,{children:`resolution`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Por ejemplo, `,_jsx(_components.code,{children:`gpt-image-2`}),`, `,_jsx(_components.code,{children:`nano-banana-2`}),` y `,_jsx(_components.code,{children:`nano-banana-pro`}),` admiten valores de `,_jsx(_components.code,{children:`resolution`}),` de `,_jsx(_components.code,{children:`1K`}),`, `,_jsx(_components.code,{children:`2K`}),` y `,_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:`El mismo patrón de tamaño por nivel de resolución también se aplica a los modelos 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:[`Para los modelos que aceptan relación de aspecto pero no exponen niveles de resolución, envía `,_jsx(_components.code,{children:`aspect_ratio`}),` sin `,_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:[`Para los modelos que usan dimensiones directas en píxeles, envía `,_jsx(_components.code,{children:`width`}),` y `,_jsx(_components.code,{children:`height`}),` en su lugar:`]}),`\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:[`Consulta `,_jsx(_components.a,{href:`/es/models/image`,children:`Modelos de imagen`}),` o el `,_jsx(_components.a,{href:`/es/api-reference/endpoint/models/list`,children:`endpoint de Models`}),` para conocer las opciones de tamaño admitidas por cada modelo antes de mezclar campos de tamaño entre modelos.`]}),`\n`,_jsx(Heading,{level:`2`,id:`niveles-de-calidad`,children:`Niveles de calidad`}),`\n`,_jsxs(_components.p,{children:[`Algunos modelos aceptan un parámetro opcional `,_jsx(_components.code,{children:`quality`}),` (`,_jsx(_components.code,{children:`low`}),`, `,_jsx(_components.code,{children:`medium`}),`, `,_jsx(_components.code,{children:`high`}),`) que intercambia fidelidad visual por coste. Los modelos que incluyen `,_jsx(_components.code,{children:`qualities`}),` en `,_jsx(_components.code,{children:`model_spec.constraints`}),` de `,_jsx(_components.a,{href:`/es/api-reference/endpoint/models/list`,children:_jsx(_components.code,{children:`GET /models?type=image`})}),` solo aceptan esos valores, y algunos solo admiten un subconjunto, como `,_jsx(_components.code,{children:`low`}),` y `,_jsx(_components.code,{children:`medium`}),`. Otros modelos ignoran el parámetro.`]}),`\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:[`Cuando omites `,_jsx(_components.code,{children:`quality`}),`, el modelo utiliza su nivel predeterminado (`,_jsx(_components.code,{children:`high`}),` para `,_jsx(_components.code,{children:`gpt-image-2`}),`). El precio depende de la combinación de `,_jsx(_components.code,{children:`resolution`}),` y `,_jsx(_components.code,{children:`quality`}),`: los precios por nivel para `,_jsx(_components.code,{children:`gpt-image-2`}),` (1K/2K/4K × low/medium/high) se exponen en `,_jsx(_components.code,{children:`model_spec.pricing.quality`}),` en el `,_jsx(_components.a,{href:`/es/api-reference/endpoint/models/list`,children:`endpoint de Models`}),` y se listan en la `,_jsx(_components.a,{href:`/es/overview/pricing`,children:`vista general de precios`}),`.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`La facturación según la calidad es la predeterminada para todos los llamadores de la API y del SDK: no se requiere ninguna cabecera de activación. Las solicitudes que omiten `,_jsx(_components.code,{children:`quality`}),` se facturan al nivel predeterminado del modelo (`,_jsx(_components.code,{children:`high`}),` para `,_jsx(_components.code,{children:`gpt-image-2`}),`).`]})}),`\n`,_jsx(Heading,{level:`2`,id:`colección-de-postman`,children:`Colección de Postman`}),`\n`,_jsxs(_components.p,{children:[`Para ver más ejemplos, consulta esta `,_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:`Colección de Postman`}),`.`]}),`\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":"Generar imágenes","openapi":"POST /image/generate","og:title":"Image Generate | Venice API Docs","og:description":"Documentación de la API de generación de imágenes de 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":"/es/api-reference/endpoint/image/generate"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Opciones de tamaño","slug":"opciones-de-tamaño","depth":2,"children":[]},{"title":"Niveles de calidad","slug":"niveles-de-calidad","depth":2,"children":[]},{"title":"Colección de Postman","slug":"colección-de-postman","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":1},"de":{"href":"/de/api-reference/endpoint/image/generate","matchLevel":1},"es":{"href":"/es/api-reference/endpoint/image/generate","matchLevel":0},"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.840Z","originalFileLocation":"es/api-reference/endpoint/image/generate.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"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=\"Documentación de la API de generación de imágenes de 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/es/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=Im%C3%A1genes\u0026amp;title=Generar+im%C3%A1genes\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=508d743c1f2720564c9062e7\u0026amp;signature=0a547bbebd28c5b4a0f9932c472d1fe97685d980ce3d37a055c1c6bda41239f0\">\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=\"Documentación de la API de generación de imágenes de Venice.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://veniceai.mintlify.app/_mintlify/api/og/v2?division=Im%C3%A1genes\u0026amp;title=Generar+im%C3%A1genes\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=508d743c1f2720564c9062e7\u0026amp;signature=0a547bbebd28c5b4a0f9932c472d1fe97685d980ce3d37a055c1c6bda41239f0\">\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/es/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=\"/es/api-reference/endpoint/image/generate.md\">\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=\"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=\"it\" href=\"https://docs.venice.ai/it/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=\"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/es/api-reference/endpoint/image/generate#webpage\",\"url\":\"https://docs.venice.ai/es/api-reference/endpoint/image/generate\",\"name\":\"Generar imágenes\",\"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.840Z\",\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.venice.ai/es/api-reference/endpoint/image/generate#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.venice.ai/es/api-reference/endpoint/image/generate#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Venice APIs\",\"item\":\"https://docs.venice.ai/es/api-reference/api-spec\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Generar imágenes\",\"item\":\"https://docs.venice.ai/es/api-reference/endpoint/image/generate\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.venice.ai/es/api-reference/endpoint/image/generate#apireference\",\"headline\":\"Generar imágenes\",\"name\":\"Generar imágenes\",\"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/es/api-reference/endpoint/image/generate\",\"mainEntityOfPage\":{\"@id\":\"https://docs.venice.ai/es/api-reference/endpoint/image/generate#webpage\"},\"dateModified\":\"2026-10-20T10:23:08.840Z\",\"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","pages":[{"title":"it","href":"/it/api-reference/endpoint/image/generate"}]},{"language":"de","pages":[{"title":"de","href":"/de/api-reference/endpoint/image/generate"}]},{"language":"es","tabs":[{"tab":"Documentación","icon":"book","pages":[{"title":"Documentación","href":"/es/overview/about-venice"}]},{"tab":"Modelos","icon":"box","pages":[{"title":"Modelos","href":"/es/models/overview"}]},{"tab":"Aprender","icon":"layout-grid","pages":[{"title":"Aprender","href":"/es/learn"}]},{"tab":"Referencia de la API","icon":"code","groups":[{"group":"Venice APIs","pages":[{"title":"Introducción","href":"/es/api-reference/api-spec"},{"title":"Límites de velocidad","href":"/es/api-reference/rate-limiting"},{"title":"Códigos de error","href":"/es/api-reference/error-codes"},{"group":"Chat","expanded":false,"pages":[{"title":"Chat Completions","openapi":"POST /chat/completions","href":"/es/api-reference/endpoint/chat/completions"},{"title":"Responses","openapi":"POST /responses","href":"/es/api-reference/endpoint/responses/create"},{"title":"Sufijo de características del modelo","href":"/es/api-reference/endpoint/chat/model_feature_suffix"},{"title":"Crear decisiones","openapi":"POST /decisions","href":"/es/api-reference/endpoint/decisions/create"},{"title":"Compatibilidad 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":"/es/api-reference/endpoint/decisions/systemone"}]},{"group":"Imágenes","expanded":false,"pages":[{"title":"Generar imágenes","openapi":"POST /image/generate","href":"/es/api-reference/endpoint/image/generate"},{"title":"Escalar y mejorar","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":"/es/api-reference/endpoint/image/upscale"},{"title":"Editar (Inpaint)","openapi":"POST /image/edit","href":"/es/api-reference/endpoint/image/edit"},{"title":"Edición múltiple de imágenes","openapi":"POST /image/multi-edit","href":"/es/api-reference/endpoint/image/multi-edit"},{"title":"Eliminar fondo","openapi":"POST /image/background-remove","href":"/es/api-reference/endpoint/image/background-remove"},{"title":"Estilos de imagen","openapi":"GET /image/styles","href":"/es/api-reference/endpoint/image/styles"},{"title":"Generar imágenes (API compatible con OpenAI)","openapi":"POST /images/generations","href":"/es/api-reference/endpoint/image/generations"}]},{"group":"Audio","expanded":false,"pages":[{"title":"API de voz (Beta)","openapi":"POST /audio/speech","href":"/es/api-reference/endpoint/audio/speech"},{"title":"Clonar voz","openapi":"POST /audio/voices","href":"/es/api-reference/endpoint/audio/voices"},{"title":"API de transcripciones (Beta)","openapi":"POST /audio/transcriptions","href":"/es/api-reference/endpoint/audio/transcriptions"},{"title":"Encolar generación de audio","openapi":"POST /audio/queue","href":"/es/api-reference/endpoint/audio/queue"},{"title":"Recuperar audio","openapi":"POST /audio/retrieve","href":"/es/api-reference/endpoint/audio/retrieve"},{"title":"Cotizar generación de audio","openapi":"POST /audio/quote","href":"/es/api-reference/endpoint/audio/quote"},{"title":"Completar audio","openapi":"POST /audio/complete","href":"/es/api-reference/endpoint/audio/complete"},{"title":"Encolar Voice Changer","openapi":"POST /audio/voice-changer/queue","href":"/es/api-reference/endpoint/audio/voice-changer/queue"},{"title":"Recuperar Voice Changer","openapi":"POST /audio/voice-changer/retrieve","href":"/es/api-reference/endpoint/audio/voice-changer/retrieve"},{"title":"Cotizar Voice Changer","openapi":"POST /audio/voice-changer/quote","href":"/es/api-reference/endpoint/audio/voice-changer/quote"},{"title":"Completar Voice Changer","openapi":"POST /audio/voice-changer/complete","href":"/es/api-reference/endpoint/audio/voice-changer/complete"}]},{"group":"Vídeo","expanded":false,"pages":[{"title":"Encolar generación de vídeo","openapi":"POST /video/queue","href":"/es/api-reference/endpoint/video/queue"},{"title":"Recuperar vídeo","openapi":"POST /video/retrieve","href":"/es/api-reference/endpoint/video/retrieve"},{"title":"Cotizar generación de vídeo","openapi":"POST /video/quote","href":"/es/api-reference/endpoint/video/quote"},{"title":"Completar vídeo","openapi":"POST /video/complete","href":"/es/api-reference/endpoint/video/complete"}]},{"group":"Herramientas","expanded":false,"pages":[{"title":"Text Parser","openapi":"POST /augment/text-parser","href":"/es/api-reference/endpoint/augment/text-parser"},{"title":"Web Scrape","openapi":"POST /augment/scrape","href":"/es/api-reference/endpoint/augment/scrape"},{"title":"Búsqueda web","openapi":"POST /augment/search","href":"/es/api-reference/endpoint/augment/search"},{"title":"Redes cripto","openapi":"GET /crypto/rpc/networks","href":"/es/api-reference/endpoint/crypto/networks"},{"title":"RPC cripto","openapi":"POST /crypto/rpc/{network}","href":"/es/api-reference/endpoint/crypto/rpc"}]},{"group":"Embeddings","expanded":false,"pages":[{"title":"Generar embeddings","openapi":"POST /embeddings","href":"/es/api-reference/endpoint/embeddings/generate"}]},{"group":"Modelos","expanded":false,"pages":[{"title":"Listar modelos","openapi":"GET /models","href":"/es/api-reference/endpoint/models/list"},{"title":"Mapa de compatibilidad","openapi":"GET /models/compatibility_mapping","href":"/es/api-reference/endpoint/models/compatibility_mapping"},{"title":"Características","openapi":"GET /models/traits","href":"/es/api-reference/endpoint/models/traits"}]},{"group":"Claves de API","expanded":false,"pages":[{"title":"Listar API Keys","openapi":"GET /api_keys","href":"/es/api-reference/endpoint/api_keys/list"},{"title":"Obtener detalles de la API Key","openapi":"GET /api_keys/{id}","href":"/es/api-reference/endpoint/api_keys/get"},{"title":"Crear API Key","openapi":"POST /api_keys","href":"/es/api-reference/endpoint/api_keys/create"},{"title":"Actualizar API Key","openapi":"PATCH /api_keys","href":"/es/api-reference/endpoint/api_keys/update"},{"title":"Eliminar API Key","openapi":"DELETE /api_keys","href":"/es/api-reference/endpoint/api_keys/delete"},{"title":"Generar API Key con monedero Web3","openapi":"GET /api_keys/generate_web3_key","href":"/es/api-reference/endpoint/api_keys/generate_web3_key/get"},{"title":"Generar API Key con monedero Web3","openapi":"POST /api_keys/generate_web3_key","href":"/es/api-reference/endpoint/api_keys/generate_web3_key/post"}]},{"group":"Límites de las claves de API","expanded":false,"pages":[{"title":"Límites de velocidad y saldos","openapi":"GET /api_keys/rate_limits","href":"/es/api-reference/endpoint/api_keys/rate_limits"},{"title":"Registros de límites de velocidad","openapi":"GET /api_keys/rate_limits/log","href":"/es/api-reference/endpoint/api_keys/rate_limit_logs"}]},{"group":"Personajes","expanded":false,"pages":[{"title":"Obtener personaje","openapi":"GET /characters/{slug}","href":"/es/api-reference/endpoint/characters/get"},{"title":"Listar personajes","openapi":"GET /characters","href":"/es/api-reference/endpoint/characters/list"},{"title":"Listar reseñas de personaje","openapi":"GET /characters/{slug}/reviews","href":"/es/api-reference/endpoint/characters/reviews"}]},{"group":"Facturación","expanded":false,"pages":[{"title":"Saldo de facturación","openapi":"GET /billing/balance","href":"/es/api-reference/endpoint/billing/balance"},{"title":"Uso de facturación (eliminado)","openapi":"GET /billing/usage","href":"/es/api-reference/endpoint/billing/usage"},{"title":"Analíticas de uso de facturación (Beta)","openapi":"GET /billing/usage-analytics","href":"/es/api-reference/endpoint/billing/usage-analytics"},{"title":"Historial de uso de facturación","openapi":"GET /billing/usage-history","href":"/es/api-reference/endpoint/billing/usage-history"}]},{"group":"X402","expanded":true,"pages":[{"title":"Saldo X402","openapi":"GET /x402/balance/{walletAddress}","href":"/es/api-reference/endpoint/x402/balance"},{"title":"Recarga X402","openapi":"POST /x402/top-up","href":"/es/api-reference/endpoint/x402/top-up"},{"title":"Transacciones X402","openapi":"GET /x402/transactions/{walletAddress}","href":"/es/api-reference/endpoint/x402/transactions"}]}]}]},{"tab":"Cambios","icon":"history","href":"https://featurebase.venice.ai/changelog"},{"tab":"Estado","icon":"activity","href":"https://veniceai-status.com"}]},{"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"]}