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
}
일부 모델은 시각적 충실도와 비용 간의 균형을 맞추는 선택적 quality 매개변수(low, medium, high)를 허용합니다. GET /models?type=image의 model_spec.constraints에 qualities가 나열된 모델은 해당 값만 허용하며, 일부 모델은 low와 medium 같은 일부 값만 지원합니다. 다른 모델은 이 매개변수를 무시합니다.
{ "model": "gpt-image-2", "prompt": "a cinematic wide shot of Venice at sunset", "aspect_ratio": "16:9", "resolution": "2K", "quality": "medium"}
quality를 생략하면 모델은 기본 등급(gpt-image-2의 경우 high)을 사용합니다. 가격은 resolution과 quality의 조합에 따라 다릅니다 — gpt-image-2의 등급별 가격(1K/2K/4K × low/medium/high)은 모델 엔드포인트의 model_spec.pricing.quality 아래에 노출되어 있으며 가격 개요에 나열되어 있습니다.
품질 인식 가격은 모든 API 및 SDK 호출자의 기본값입니다 — opt-in 헤더가 필요하지 않습니다. quality를 생략한 요청은 모델의 기본 등급(gpt-image-2의 경우 high)으로 청구됩니다.
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":"ko/api-reference/endpoint/image/generate","slug":"/ko/api-reference/endpoint/image/generate","pageMetadata":{"title":"이미지 생성","openapi":"POST /image/generate","og:title":"Image Generate | Venice API Docs","og:description":"Documentation covering Venice's image generation API.","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":"/ko/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:`크기-옵션`,children:`크기 옵션`}),`\n`,_jsx(_components.p,{children:`이미지 모델은 모델별 크기 매개변수를 사용합니다:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`픽셀 기반 모델은 `,_jsx(_components.code,{children:`width`}),`와 `,_jsx(_components.code,{children:`height`}),`를 허용합니다(예: `,_jsx(_components.code,{children:`venice-sd35`}),`).`]}),`\n`,_jsxs(_components.li,{children:[`종횡비 모델은 `,_jsx(_components.code,{children:`aspect_ratio`}),`를 허용합니다(예: `,_jsx(_components.code,{children:`qwen-image-2`}),`). 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`}),`, `,_jsx(_components.code,{children:`qwen-image-2-1-pro`}),` — 은 `,_jsx(_components.code,{children:`width`}),`와 `,_jsx(_components.code,{children:`height`}),`를 `,_jsx(_components.code,{children:`400`}),`으로 `,_jsx(_components.strong,{children:`거부`}),`하므로, 이 모델에는 `,_jsx(_components.code,{children:`aspect_ratio`}),`를 사용하세요.`]}),`\n`,_jsxs(_components.li,{children:[`해상도 등급 모델은 `,_jsx(_components.code,{children:`aspect_ratio`}),`와 `,_jsx(_components.code,{children:`resolution`}),` 둘 다 허용합니다.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`예를 들어, `,_jsx(_components.code,{children:`gpt-image-2`}),`, `,_jsx(_components.code,{children:`nano-banana-2`}),`, `,_jsx(_components.code,{children:`nano-banana-pro`}),`는 `,_jsx(_components.code,{children:`resolution`}),` 값으로 `,_jsx(_components.code,{children:`1K`}),`, `,_jsx(_components.code,{children:`2K`}),`, `,_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:`동일한 해상도 등급 크기 패턴은 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:[`종횡비를 허용하지만 해상도 등급을 노출하지 않는 모델의 경우, `,_jsx(_components.code,{children:`resolution`}),` 없이 `,_jsx(_components.code,{children:`aspect_ratio`}),`를 전송하세요:`]}),`\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:[`직접 픽셀 크기를 사용하는 모델의 경우, `,_jsx(_components.code,{children:`width`}),`와 `,_jsx(_components.code,{children:`height`}),`를 대신 전송하세요:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"venice-sd35\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prompt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a serene canal in venice at sunset\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"width\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1024`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"height\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1024`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`모델 간에 크기 필드를 혼합하기 전에 각 모델의 지원되는 크기 옵션은 `,_jsx(_components.a,{href:`/ko/models/image`,children:`이미지 모델`}),` 또는 `,_jsx(_components.a,{href:`/ko/api-reference/endpoint/models/list`,children:`모델 엔드포인트`}),`를 확인하세요.`]}),`\n`,_jsx(Heading,{level:`2`,id:`품질-등급`,children:`품질 등급`}),`\n`,_jsxs(_components.p,{children:[`일부 모델은 시각적 충실도와 비용 간의 균형을 맞추는 선택적 `,_jsx(_components.code,{children:`quality`}),` 매개변수(`,_jsx(_components.code,{children:`low`}),`, `,_jsx(_components.code,{children:`medium`}),`, `,_jsx(_components.code,{children:`high`}),`)를 허용합니다. `,_jsx(_components.a,{href:`/ko/api-reference/endpoint/models/list`,children:_jsx(_components.code,{children:`GET /models?type=image`})}),`의 `,_jsx(_components.code,{children:`model_spec.constraints`}),`에 `,_jsx(_components.code,{children:`qualities`}),`가 나열된 모델은 해당 값만 허용하며, 일부 모델은 `,_jsx(_components.code,{children:`low`}),`와 `,_jsx(_components.code,{children:`medium`}),` 같은 일부 값만 지원합니다. 다른 모델은 이 매개변수를 무시합니다.`]}),`\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:[_jsx(_components.code,{children:`quality`}),`를 생략하면 모델은 기본 등급(`,_jsx(_components.code,{children:`gpt-image-2`}),`의 경우 `,_jsx(_components.code,{children:`high`}),`)을 사용합니다. 가격은 `,_jsx(_components.code,{children:`resolution`}),`과 `,_jsx(_components.code,{children:`quality`}),`의 조합에 따라 다릅니다 — `,_jsx(_components.code,{children:`gpt-image-2`}),`의 등급별 가격(1K/2K/4K × low/medium/high)은 `,_jsx(_components.a,{href:`/ko/api-reference/endpoint/models/list`,children:`모델 엔드포인트`}),`의 `,_jsx(_components.code,{children:`model_spec.pricing.quality`}),` 아래에 노출되어 있으며 `,_jsx(_components.a,{href:`/ko/overview/pricing`,children:`가격 개요`}),`에 나열되어 있습니다.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`품질 인식 가격은 모든 API 및 SDK 호출자의 기본값입니다 — opt-in 헤더가 필요하지 않습니다. `,_jsx(_components.code,{children:`quality`}),`를 생략한 요청은 모델의 기본 등급(`,_jsx(_components.code,{children:`gpt-image-2`}),`의 경우 `,_jsx(_components.code,{children:`high`}),`)으로 청구됩니다.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`postman-컬렉션`,children:`Postman 컬렉션`}),`\n`,_jsxs(_components.p,{children:[`추가 예제는 이 `,_jsx(_components.a,{href:`https://www.postman.com/veniceai/workspace/venice-ai-workspace/folder/38652128-0adc004d-2edf-4b88-a3bb-0f868c791c9c?action=share\u0026source=copy-link\u0026creator=38652128\u0026ctx=documentation`,children:`Postman 컬렉션`}),`을 참조하세요.`]}),`\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":"이미지 생성","openapi":"POST /image/generate","og:title":"Image Generate | Venice API Docs","og:description":"Documentation covering Venice's image generation API.","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":"/ko/api-reference/endpoint/image/generate"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"크기 옵션","slug":"크기-옵션","depth":2,"children":[]},{"title":"품질 등급","slug":"품질-등급","depth":2,"children":[]},{"title":"Postman 컬렉션","slug":"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":1},"fr":{"href":"/fr/api-reference/endpoint/image/generate","matchLevel":1},"zh":{"href":"/zh/api-reference/endpoint/image/generate","matchLevel":1},"ko":{"href":"/ko/api-reference/endpoint/image/generate","matchLevel":0}}},"lastModified":"2026-10-20T10:23:08.847Z","originalFileLocation":"ko/api-reference/endpoint/image/generate.mdx","locale":"ko"},"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=\"Documentation covering Venice\u0026#x27;s image generation API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Venice API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.venice.ai/ko/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=%EC%9D%B4%EB%AF%B8%EC%A7%80\u0026amp;title=%EC%9D%B4%EB%AF%B8%EC%A7%80+%EC%83%9D%EC%84%B1\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=7d98ead546c1b5be1902eddc352012097fb76b9df34cf25685fcaa51925ee519\">\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=\"Documentation covering Venice\u0026#x27;s image generation API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://veniceai.mintlify.app/_mintlify/api/og/v2?division=%EC%9D%B4%EB%AF%B8%EC%A7%80\u0026amp;title=%EC%9D%B4%EB%AF%B8%EC%A7%80+%EC%83%9D%EC%84%B1\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=7d98ead546c1b5be1902eddc352012097fb76b9df34cf25685fcaa51925ee519\">\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/ko/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=\"/ko/api-reference/endpoint/image/generate.md\">\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=\"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=\"es\" href=\"https://docs.venice.ai/es/api-reference/endpoint/image/generate\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.venice.ai/fr/api-reference/endpoint/image/generate\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.venice.ai/zh/api-reference/endpoint/image/generate\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"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/ko/api-reference/endpoint/image/generate#webpage\",\"url\":\"https://docs.venice.ai/ko/api-reference/endpoint/image/generate\",\"name\":\"이미지 생성\",\"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.847Z\",\"isPartOf\":{\"@id\":\"https://docs.venice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.venice.ai/ko/api-reference/endpoint/image/generate#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.venice.ai/ko/api-reference/endpoint/image/generate#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Venice APIs\",\"item\":\"https://docs.venice.ai/ko/api-reference/api-spec\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"이미지 생성\",\"item\":\"https://docs.venice.ai/ko/api-reference/endpoint/image/generate\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.venice.ai/ko/api-reference/endpoint/image/generate#apireference\",\"headline\":\"이미지 생성\",\"name\":\"이미지 생성\",\"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/ko/api-reference/endpoint/image/generate\",\"mainEntityOfPage\":{\"@id\":\"https://docs.venice.ai/ko/api-reference/endpoint/image/generate#webpage\"},\"dateModified\":\"2026-10-20T10:23:08.847Z\",\"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","pages":[{"title":"es","href":"/es/api-reference/endpoint/image/generate"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/api-reference/endpoint/image/generate"}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/api-reference/endpoint/image/generate"}]},{"language":"ko","tabs":[{"tab":"문서","icon":"book","pages":[{"title":"문서","href":"/ko/overview/about-venice"}]},{"tab":"모델","icon":"box","pages":[{"title":"모델","href":"/ko/models/overview"}]},{"tab":"학습","icon":"layout-grid","pages":[{"title":"학습","href":"/ko/learn"}]},{"tab":"API 레퍼런스","icon":"code","groups":[{"group":"Venice APIs","pages":[{"title":"소개","href":"/ko/api-reference/api-spec"},{"title":"속도 제한","href":"/ko/api-reference/rate-limiting"},{"title":"오류 코드","href":"/ko/api-reference/error-codes"},{"group":"채팅","expanded":false,"pages":[{"title":"Chat Completions","openapi":"POST /chat/completions","href":"/ko/api-reference/endpoint/chat/completions"},{"title":"Responses","openapi":"POST /responses","href":"/ko/api-reference/endpoint/responses/create"},{"title":"모델 기능 접미사","href":"/ko/api-reference/endpoint/chat/model_feature_suffix"},{"title":"결정 생성","openapi":"POST /decisions","href":"/ko/api-reference/endpoint/decisions/create"},{"title":"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":"/ko/api-reference/endpoint/decisions/systemone"}]},{"group":"이미지","expanded":false,"pages":[{"title":"이미지 생성","openapi":"POST /image/generate","href":"/ko/api-reference/endpoint/image/generate"},{"title":"업스케일 및 향상","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":"/ko/api-reference/endpoint/image/upscale"},{"title":"편집 (인페인트)","openapi":"POST /image/edit","href":"/ko/api-reference/endpoint/image/edit"},{"title":"다중 이미지 편집","openapi":"POST /image/multi-edit","href":"/ko/api-reference/endpoint/image/multi-edit"},{"title":"배경 제거","openapi":"POST /image/background-remove","href":"/ko/api-reference/endpoint/image/background-remove"},{"title":"이미지 스타일","openapi":"GET /image/styles","href":"/ko/api-reference/endpoint/image/styles"},{"title":"이미지 생성 (OpenAI 호환 API)","openapi":"POST /images/generations","href":"/ko/api-reference/endpoint/image/generations"}]},{"group":"오디오","expanded":false,"pages":[{"title":"음성 API (Beta)","openapi":"POST /audio/speech","href":"/ko/api-reference/endpoint/audio/speech"},{"title":"음성 복제","openapi":"POST /audio/voices","href":"/ko/api-reference/endpoint/audio/voices"},{"title":"전사 API (Beta)","openapi":"POST /audio/transcriptions","href":"/ko/api-reference/endpoint/audio/transcriptions"},{"title":"오디오 생성 큐","openapi":"POST /audio/queue","href":"/ko/api-reference/endpoint/audio/queue"},{"title":"오디오 검색","openapi":"POST /audio/retrieve","href":"/ko/api-reference/endpoint/audio/retrieve"},{"title":"오디오 생성 비용 견적","openapi":"POST /audio/quote","href":"/ko/api-reference/endpoint/audio/quote"},{"title":"오디오 완료 처리","openapi":"POST /audio/complete","href":"/ko/api-reference/endpoint/audio/complete"},{"title":"보이스 체인저 큐","openapi":"POST /audio/voice-changer/queue","href":"/ko/api-reference/endpoint/audio/voice-changer/queue"},{"title":"보이스 체인저 검색","openapi":"POST /audio/voice-changer/retrieve","href":"/ko/api-reference/endpoint/audio/voice-changer/retrieve"},{"title":"보이스 체인저 비용 견적","openapi":"POST /audio/voice-changer/quote","href":"/ko/api-reference/endpoint/audio/voice-changer/quote"},{"title":"보이스 체인저 완료 처리","openapi":"POST /audio/voice-changer/complete","href":"/ko/api-reference/endpoint/audio/voice-changer/complete"}]},{"group":"비디오","expanded":false,"pages":[{"title":"비디오 생성 큐","openapi":"POST /video/queue","href":"/ko/api-reference/endpoint/video/queue"},{"title":"비디오 검색","openapi":"POST /video/retrieve","href":"/ko/api-reference/endpoint/video/retrieve"},{"title":"비디오 생성 비용 견적","openapi":"POST /video/quote","href":"/ko/api-reference/endpoint/video/quote"},{"title":"비디오 완료 처리","openapi":"POST /video/complete","href":"/ko/api-reference/endpoint/video/complete"}]},{"group":"도구","expanded":false,"pages":[{"title":"텍스트 파서","openapi":"POST /augment/text-parser","href":"/ko/api-reference/endpoint/augment/text-parser"},{"title":"웹 스크래핑","openapi":"POST /augment/scrape","href":"/ko/api-reference/endpoint/augment/scrape"},{"title":"웹 검색","openapi":"POST /augment/search","href":"/ko/api-reference/endpoint/augment/search"},{"title":"Crypto Networks","openapi":"GET /crypto/rpc/networks","href":"/ko/api-reference/endpoint/crypto/networks"},{"title":"Crypto RPC","openapi":"POST /crypto/rpc/{network}","href":"/ko/api-reference/endpoint/crypto/rpc"}]},{"group":"임베딩","expanded":false,"pages":[{"title":"임베딩 생성","openapi":"POST /embeddings","href":"/ko/api-reference/endpoint/embeddings/generate"}]},{"group":"모델","expanded":false,"pages":[{"title":"모델 목록","openapi":"GET /models","href":"/ko/api-reference/endpoint/models/list"},{"title":"호환성 매핑","openapi":"GET /models/compatibility_mapping","href":"/ko/api-reference/endpoint/models/compatibility_mapping"},{"title":"특성","openapi":"GET /models/traits","href":"/ko/api-reference/endpoint/models/traits"}]},{"group":"API 키","expanded":false,"pages":[{"title":"API 키 목록","openapi":"GET /api_keys","href":"/ko/api-reference/endpoint/api_keys/list"},{"title":"API 키 세부 정보 가져오기","openapi":"GET /api_keys/{id}","href":"/ko/api-reference/endpoint/api_keys/get"},{"title":"API 키 생성","openapi":"POST /api_keys","href":"/ko/api-reference/endpoint/api_keys/create"},{"title":"API 키 업데이트","openapi":"PATCH /api_keys","href":"/ko/api-reference/endpoint/api_keys/update"},{"title":"API 키 삭제","openapi":"DELETE /api_keys","href":"/ko/api-reference/endpoint/api_keys/delete"},{"title":"Web3 지갑으로 API 키 생성","openapi":"GET /api_keys/generate_web3_key","href":"/ko/api-reference/endpoint/api_keys/generate_web3_key/get"},{"title":"Web3 지갑으로 API 키 생성","openapi":"POST /api_keys/generate_web3_key","href":"/ko/api-reference/endpoint/api_keys/generate_web3_key/post"}]},{"group":"API 키 속도 제한","expanded":false,"pages":[{"title":"속도 제한 및 잔액","openapi":"GET /api_keys/rate_limits","href":"/ko/api-reference/endpoint/api_keys/rate_limits"},{"title":"속도 제한 로그","openapi":"GET /api_keys/rate_limits/log","href":"/ko/api-reference/endpoint/api_keys/rate_limit_logs"}]},{"group":"캐릭터","expanded":false,"pages":[{"title":"캐릭터 가져오기","openapi":"GET /characters/{slug}","href":"/ko/api-reference/endpoint/characters/get"},{"title":"캐릭터 목록","openapi":"GET /characters","href":"/ko/api-reference/endpoint/characters/list"},{"title":"캐릭터 리뷰 목록","openapi":"GET /characters/{slug}/reviews","href":"/ko/api-reference/endpoint/characters/reviews"}]},{"group":"결제","expanded":false,"pages":[{"title":"청구 잔액","openapi":"GET /billing/balance","href":"/ko/api-reference/endpoint/billing/balance"},{"title":"청구 사용량 (제거됨)","openapi":"GET /billing/usage","href":"/ko/api-reference/endpoint/billing/usage"},{"title":"청구 사용량 분석 (Beta)","openapi":"GET /billing/usage-analytics","href":"/ko/api-reference/endpoint/billing/usage-analytics"},{"title":"청구 사용 내역","openapi":"GET /billing/usage-history","href":"/ko/api-reference/endpoint/billing/usage-history"}]},{"group":"X402","expanded":true,"pages":[{"title":"X402 잔액","openapi":"GET /x402/balance/{walletAddress}","href":"/ko/api-reference/endpoint/x402/balance"},{"title":"X402 충전","openapi":"POST /x402/top-up","href":"/ko/api-reference/endpoint/x402/top-up"},{"title":"X402 트랜잭션","openapi":"GET /x402/transactions/{walletAddress}","href":"/ko/api-reference/endpoint/x402/transactions"}]}]}]},{"tab":"변경 사항","icon":"history","href":"https://featurebase.venice.ai/changelog"},{"tab":"상태","icon":"activity","href":"https://veniceai-status.com"}]}]},"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"]}