Image width (px). Only effective for image-01. Must be set together with height. Range [512, 2048], must be divisible by 8. If both width/height and aspect_ratio are provided, aspect_ratio takes priority.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"MiniMax API Docs","colors":{"primary":"#181E25","dark":"#181E25"},"logo":{"light":"https://mintcdn.com/minimax-cac98058/XYzsL2L2ynonu2Q_/logo/light.svg?fit=max\u0026auto=format\u0026n=XYzsL2L2ynonu2Q_\u0026q=85\u0026s=9c99bb2678d62388d8a4e7cce1750858","dark":"https://mintcdn.com/minimax-cac98058/XYzsL2L2ynonu2Q_/logo/dark.svg?fit=max\u0026auto=format\u0026n=XYzsL2L2ynonu2Q_\u0026q=85\u0026s=e62ef6e36d7512de91c8c48322614594","href":"https://minimax.io"},"favicon":"https://mintcdn.com/minimax-cac98058/3KE0RwwD41Lh3xt2/favicon.ico?fit=max\u0026auto=format\u0026n=3KE0RwwD41Lh3xt2\u0026q=85\u0026s=6a58247013972686c0a551c6c6b98d66","api":{"examples":{"prefill":true}},"appearance":{"default":"system","strict":false},"navbar":{"primary":{"type":"button","label":"Console","href":"https://platform.minimax.io/console/home"}},"footer":{"socials":{"discord":"https://www.minimax.io/discord","x":"https://x.com/MiniMax_AI","linkedin":"https://www.linkedin.com/company/minimax-ai","github":"https://github.com/MiniMax-AI"},"links":[{"header":"Research","items":[{"label":"MiniMax M3","href":"https://www.minimax.io/models/text/m3"},{"label":"MiniMax M2-her","href":"https://www.minimax.io/news/a-deep-dive-into-the-minimax-m2-her-2"},{"label":"MiniMax M2.1","href":"https://www.minimax.io/news/minimax-m21"},{"label":"MiniMax Speech 2.8","href":"https://www.minimax.io/news/minimax-speech-28"},{"label":"MiniMax H3","href":"https://www.minimax.io/blog/minimax-h3"},{"label":"MiniMax Music 3.0","href":"https://platform.minimax.io/docs/guides/music-generation"}]},{"header":"Product","items":[{"label":"MiniMax Code","href":"https://agent.minimax.io/download"},{"label":"MiniMax Design","href":"https://design.minimax.io/"},{"label":"Audio","href":"https://www.minimax.io/audio"},{"label":"Talkie","href":"https://www.talkie-ai.com/"}]},{"header":"API","items":[{"label":"Developer Docs","href":"https://platform.minimax.io/docs/guides/models-intro"},{"label":"M Plan","href":"https://platform.minimax.io/subscribe/token-plan"},{"label":"Pricing","href":"https://platform.minimax.io/docs/pricing/overview"},{"label":"Console Login","href":"https://platform.minimax.io/console/personal-info"},{"label":"Developer Program","href":"https://platform.minimax.io/activity/contact-us-en"}]},{"header":"Recommended","items":[{"label":"Model Introduction","href":"https://platform.minimax.io/docs/guides/models-intro"},{"label":"Text Generation","href":"https://platform.minimax.io/docs/guides/text-generation"},{"label":"M3 for AI Coding Tools","href":"https://platform.minimax.io/docs/token-plan/openclaw"},{"label":"Text to Speech","href":"https://platform.minimax.io/docs/guides/speech-t2a-websocket"},{"label":"Video Generation","href":"https://platform.minimax.io/docs/guides/video-generation"}]}]},"seo":{"metatags":{"og:image":"https://filecdn.minimax.chat/public/58eca777-e31f-448a-9823-e2220e49b426.png","title":"MiniMax API Docs","description":"Integrate Multi-modal AI into apps and products with ease and speed.","charset":"UTF-8","canonical":"https://platform.minimax.io/docs","viewport":"width=device-width, initial-scale=1.0"},"indexing":"all"},"fonts":{"family":"DM Sans"},"icons":{"library":"lucide"},"integrations":{"telemetry":{"enabled":true},"cookies":{"key":"minimax_docs_feedback_consent","value":"v1:granted"}},"banner":{"content":"š The new-generation MiniMax M3.1 Flash is now available! ā [View docs](/docs/guides/text-generation).","dismissible":true},"contextual":{"options":["copy","view","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"minimax-cac98058","hasAudioNarration":false,"actualSubdomain":"minimax-cac98058","customDomains":["platform.minimax.io"],"gitSource":{"type":"github","owner":"minimax-ai-dev","repo":"docs","deployBranch":"main","contentDirectory":"packages/docs-en","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae445226f5ed2a94d3e7d38","collectionId":"20d7a771-1442-45cd-a7fd-98d63c9f0f97","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae445226f5ed2a94d3e7d38"},"feedback":{"issues":false,"thumbs":true,"edits":false,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae88afe0522e59c033b9f85","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API","count":48},{"language":"default","tag":"Developer Guides","count":33},{"language":"default","tag":"Use Guides","count":23},{"language":"default","tag":"M Plan","count":18},{"language":"default","tag":"Speech","count":17},{"language":"default","tag":"Text","count":14},{"language":"default","tag":"Video","count":14},{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"Tools","count":9},{"language":"default","tag":"Video Generation","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableAskAiSearchBar":false},"basePath":"/docs","hasChatPermissions":false,"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":"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":"byok-sep-25","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":"billing-updated-9-15","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":true},"customCss":[{"filePath":"style.css","content":"@keyframes restricted-doc-spin{to{transform:rotate(360deg)}}.audio-container{height:50px;margin:16px 0}.video-agent-templates{width:300px;height:180px;object-fit:cover}video{border-radius:12px}table{overflow-x:auto}td,th{vertical-align:middle!important}td .video-agent-templates{margin:0}#navbar .docs-platform-brand{display:inline-flex;align-items:center;flex-shrink:0}#navbar .docs-platform-name{margin-left:20px;padding-left:20px;border-left:1px solid #e5e7eb;color:#6b7280;font-size:14px;font-weight:400;line-height:20px;white-space:nowrap}.dark #navbar .docs-platform-name{border-color:#374151;color:#9ca3af}#navbar .docs-console-mobile>span,#topbar-cta-button>a>span{background-color:#242424;border-radius:8px}#navbar .docs-console-mobile:hover>span,#topbar-cta-button>a:hover>span{background-color:#3a3a3a}#navbar .docs-console-mobile{display:none}#navbar nav:has(#topbar-cta-button){margin-right:0}@media (max-width:1023px){#navbar .docs-platform-name{margin-left:12px;padding-left:12px;font-size:12px}#navbar .docs-console-mobile{position:relative;display:inline-flex;align-items:center;flex-shrink:0;padding:8px 10px;font-size:12px;font-weight:500;white-space:nowrap}}@media (max-width:480px){#navbar .docs-topbar-row{column-gap:4px}#navbar .docs-platform-brand .nav-logo{width:80px;height:auto}#navbar .docs-platform-name{max-width:60px;margin-left:8px;padding-left:8px;font-size:11px;line-height:14px;white-space:normal}#navbar .docs-console-mobile{padding:8px;font-size:11px}#navbar :has(>#search-bar-entry-mobile){gap:6px}#navbar #search-bar-entry-mobile{width:24px}}#content-container p{font-size:1rem;line-height:1.5rem}.eyebrow{text-transform:uppercase}.method-nav-pill>span,.navbar-link>a{font-weight:400}:has(>.method-pill){border:0}.nav-tabs-item{font-weight:400}.nav-tabs-item.text-gray-800{font-weight:500}:has(>.navbar-link)>.navbar-link:first-child>a{color:#181e25;font-weight:500}.dark :has(>.navbar-link)>.navbar-link:first-child>a{color:#fff}#navbar,#sidebar{letter-spacing:.02em}.callout{margin-top:2rem;margin-bottom:2rem}#content:has(>.model-retirement-notice:first-child){margin-top:1rem}.callout.model-retirement-notice{margin-top:0}.video-package-alert{display:flex;width:100%;box-sizing:border-box;gap:12px;align-items:flex-start;padding:16px 18px;margin:12px 0 24px;border:1px solid #fde68a;border-radius:10px;background:#fffbeb}.video-package-alert__icon{display:grid;flex:0 0 auto;width:24px;height:24px;place-items:center;border-radius:6px;color:#d97706;background:#fef3c7}.video-package-alert__content{min-width:0}.video-package-alert__title{margin-bottom:4px;color:#b45309;font-size:14px;font-weight:600;line-height:20px}.video-package-alert__desc{color:#3f3f3f;font-size:14px;font-weight:400;line-height:20px}.video-package-alert__desc a,.video-package-alert__desc a:hover{color:#b45309!important;font-weight:600!important;text-decoration-line:underline!important;text-decoration-color:#b45309!important;text-decoration-thickness:2px;text-underline-offset:3px;border-bottom:0!important;box-shadow:none!important;transition:none}.video-package-alert__desc a:focus-visible{border-radius:3px;outline:2px solid #d97706;outline-offset:2px}.dark .video-package-alert{border-color:rgba(245,158,11,.45);background:rgba(120,53,15,.22)}.dark .video-package-alert__icon{color:#fbbf24;background:rgba(180,83,9,.32)}.dark .video-package-alert__title{color:#fcd34d}.dark .video-package-alert__desc{color:#e5e7eb}.dark .video-package-alert__desc a{color:#fbbf24!important;text-decoration-color:#fbbf24!important}@media (max-width:640px){.video-package-alert{gap:10px;padding:14px}}.card span{line-height:1.4rem;margin-top:8px!important}#banner a{border-bottom-color:#181e25;color:#fff}#footer a[href=\"mailto:api@minimax.io\"] svg{-webkit-mask-image:url(https://filecdn.minimax.chat/public/45f6ad6e-f42e-45ed-938e-7de67bfd367f.svg)!important;mask-image:url(https://filecdn.minimax.chat/public/45f6ad6e-f42e-45ed-938e-7de67bfd367f.svg)!important}#sidebar:has(a[href$=\"/pricing/overview\"]),#sidebar:has(a[href$=\"/pricing/overview/\"]){visibility:hidden}.pricing-sidebar-navigation{display:none}@media (min-width:1024px){#content:has([data-pricing-sidebar]){container-type:normal;contain:none;isolation:auto}.pricing-sidebar-navigation{--pricing-sidebar-top:calc(var(--mintlify-slot-header-height, calc(4rem + var(--topbar-tabs-height, 3rem))) + var(--banner-height, 0px));display:block;position:fixed;z-index:20;top:var(--pricing-sidebar-top);left:max(2rem,calc((100vw - 92rem)/2 + 2rem));width:var(--sidebar-width, 18rem);height:calc(100dvh - var(--pricing-sidebar-top));box-sizing:border-box;overflow-y:auto;overscroll-behavior:contain;padding:40px 24px 32px 0;margin:0}}[data-pricing-overview-active] [data-pricing-original]{display:none!important}.pricing-anchor-navigation{font-size:14px;line-height:1.5}.pricing-navigation-group+.pricing-navigation-group{margin-top:28px}.pricing-navigation-title{display:block;margin:0 0 10px;padding-left:16px;color:#111827;font-size:inherit;font-weight:600;line-height:1.5}.pricing-anchor-navigation .pricing-anchor-link{display:block;padding:6px 12px 6px 16px;margin:1px 0;border:0;border-radius:12px;color:#374151;line-height:1.5;text-decoration:none;overflow-wrap:anywhere}.pricing-anchor-navigation .pricing-anchor-link:hover{background:rgba(75,85,99,.05);color:#111827}.pricing-anchor-navigation .pricing-anchor-link[aria-current=location]{background:rgba(24,30,37,.075);color:#181e25;font-weight:600}.pricing-anchor-link:focus-visible{outline:2px solid currentColor;outline-offset:-2px}.pricing-section-toc{font-size:14px;line-height:1.5}.pricing-toc-title{margin-bottom:12px;color:#374151;font-weight:500}.pricing-section-toc .pricing-anchor-link{display:block;border:0;padding:5px 0 5px 12px;border-left:1px solid #e5e7eb;color:#6b7280;text-decoration:none;overflow-wrap:anywhere}.pricing-section-toc .pricing-anchor-link[aria-current=location]{border-left:2px solid #181e25;color:#181e25;font-weight:500}.pricing-mobile-navigation{display:none}#pricing-document .pricing-section,#pricing-document .pricing-section [id]{scroll-margin-top:10rem}.dark .pricing-navigation-title,.dark .pricing-toc-title{color:#e5e7eb}.dark .pricing-anchor-navigation .pricing-anchor-link,.dark .pricing-section-toc .pricing-anchor-link{color:#9ca3af}.dark .pricing-anchor-navigation .pricing-anchor-link:hover{background:rgba(229,231,235,.05);color:#d1d5db}.dark .pricing-anchor-navigation .pricing-anchor-link[aria-current=location]{background:rgba(229,231,235,.1);color:#f3f4f6}.dark .pricing-section-toc .pricing-anchor-link{border-left-color:#374151}.dark .pricing-section-toc .pricing-anchor-link[aria-current=location]{border-left-color:#e5e7eb;color:#e5e7eb}@media (max-width:1023px){#pricing-document .pricing-mobile-navigation{display:block;margin:0 0 24px}#pricing-document .pricing-mobile-navigation>.accordion{margin-bottom:0}#pricing-document .pricing-mobile-navigation .pricing-anchor-navigation{max-height:min(65vh,560px);overflow-y:auto;padding:8px 12px 20px;overscroll-behavior:contain}}#pricing-document>.pricing-section{margin-top:56px;padding-top:40px;border-top:1px solid #e5e7eb}#pricing-document>.pricing-overview+.pricing-section{margin-top:36px;border-top:0}#pricing-document>.pricing-section>h2:first-child{margin-top:0}#pricing-document .pricing-overview>span[data-as=p],#pricing-document .pricing-section>span[data-as=p]{display:block;margin:1em 0}.dark #pricing-document>.pricing-section{border-color:#374151}@media (max-width:767px){#pricing-document>.pricing-section{margin-top:40px;padding-top:28px}}#pricing-document section[id=\"models/text\"] table,#pricing-document section[id=\"models/video\"] table{table-layout:fixed;width:100%}#pricing-document section[id=\"models/text\"] table td:first-child,#pricing-document section[id=\"models/text\"] table th:first-child{width:32%}#pricing-document section[id=\"models/video\"] table td:first-child,#pricing-document section[id=\"models/video\"] table th:first-child{width:30%}#pricing-document .video-price-table,#pricing-document .video-task-table{display:table;table-layout:fixed;width:100%}#pricing-document .video-price-table tbody tr:not(:has(strong))>td:first-child,#pricing-document .video-price-table td:has(>strong)+td{padding-left:24px}#pricing-document .video-price-table thead th:nth-child(2){padding-left:24px}.restricted-doc{--restricted-border:rgba(15, 23, 42, .12);--restricted-border-strong:rgba(15, 23, 42, .18);--restricted-muted:#64748b;--restricted-surface:rgba(15, 23, 42, .035);--restricted-surface-hover:rgba(15, 23, 42, .055);--restricted-link:#2563eb;color:inherit}.dark .restricted-doc{--restricted-border:rgba(255, 255, 255, .12);--restricted-border-strong:rgba(255, 255, 255, .18);--restricted-muted:#94a3b8;--restricted-surface:rgba(255, 255, 255, .045);--restricted-surface-hover:rgba(255, 255, 255, .07);--restricted-link:#60a5fa}.restricted-doc-loading{min-height:12rem;display:flex;align-items:center;justify-content:center}.restricted-doc-spinner{width:1.75rem;height:1.75rem;border:2px solid rgba(98,112,132,.24);border-top-color:#627084;border-radius:50%;animation:restricted-doc-spin .75s linear infinite}@media (prefers-reduced-motion:reduce){.restricted-doc-spinner{animation-duration:1.5s}}.restricted-doc>h1{margin:0 0 .75rem;font-size:2.25rem;line-height:1.2;font-weight:700;letter-spacing:-.025em}.restricted-doc-description{margin:0 0 2rem;color:var(--restricted-muted);font-size:1.05rem;line-height:1.7}.restricted-doc h2,.restricted-doc h3,.restricted-doc h4{scroll-margin-top:6rem;font-weight:650;letter-spacing:-.015em}.restricted-doc h2{margin:2.75rem 0 1rem;padding-top:.25rem;font-size:1.65rem;line-height:1.35}.restricted-doc h3{margin:2.1rem 0 .75rem;font-size:1.3rem;line-height:1.4}.restricted-doc h4{margin:1.6rem 0 .5rem;font-size:1.1rem;line-height:1.45}.restricted-doc>p{margin:1rem 0}.restricted-doc li,.restricted-doc p{line-height:1.75}.restricted-doc ol,.restricted-doc ul{margin:1rem 0;padding-left:1.5rem}.restricted-doc li{padding-left:.15rem}.restricted-doc li+li{margin-top:.3rem}.restricted-doc li>p{margin:.25rem 0}.restricted-doc a{color:var(--restricted-link);text-decoration:underline;text-decoration-color:color-mix(in srgb,var(--restricted-link) 35%,transparent);text-underline-offset:.2em}.restricted-doc a:hover{text-decoration-color:currentColor}.restricted-doc :not(pre)>code{padding:.15rem .4rem;border:1px solid var(--restricted-border);border-radius:.35rem;background:var(--restricted-surface);font-size:.875em;font-weight:500}.restricted-doc-table-wrap{max-width:100%;margin:1.5rem 0;overflow-x:auto;border:1px solid var(--restricted-border-strong);border-radius:.75rem}.restricted-doc table{width:100%;border-collapse:separate;border-spacing:0;font-size:.925rem;line-height:1.55}.restricted-doc td,.restricted-doc th{min-width:7rem;padding:.75rem 1rem;border-bottom:1px solid var(--restricted-border);vertical-align:top;text-align:left}.restricted-doc td+td,.restricted-doc th+th{border-left:1px solid var(--restricted-border)}.restricted-doc th{background:var(--restricted-surface);font-weight:600;color:inherit}.restricted-doc tbody tr{transition:background-color .15s ease}.restricted-doc tbody tr:hover{background:var(--restricted-surface-hover)}.restricted-doc tr:last-child td{border-bottom:0}.restricted-doc-code{position:relative;margin:1.5rem 0;border:1px solid rgba(255,255,255,.09);border-radius:.75rem;background:#0f172a;color:#e5e7eb;box-shadow:0 1px 2px rgba(15,23,42,.08);overflow:hidden}.restricted-doc-code pre{margin:0;padding:1.1rem 1.2rem;overflow-x:auto;background:0 0}.restricted-doc-code code{display:block;min-width:max-content;padding-right:3.5rem;font-size:.85rem;line-height:1.7;white-space:pre;tab-size:2}.restricted-doc-code button{position:absolute;z-index:1;top:.65rem;right:.65rem;padding:.3rem .6rem;border:1px solid rgba(255,255,255,.16);border-radius:.4rem;background:rgba(30,41,59,.92);color:#cbd5e1;font-size:.75rem;line-height:1.25rem;cursor:pointer;transition:color .15s ease,border-color .15s ease,background-color .15s ease}.restricted-doc-code button:hover{border-color:rgba(255,255,255,.28);background:#334155;color:#fff}.restricted-doc-code .hljs-comment,.restricted-doc-code .hljs-quote{color:#7f8ea3;font-style:italic}.restricted-doc-code .hljs-keyword,.restricted-doc-code .hljs-link,.restricted-doc-code .hljs-literal,.restricted-doc-code .hljs-section,.restricted-doc-code .hljs-selector-tag{color:#c792ea}.restricted-doc-code .hljs-addition,.restricted-doc-code .hljs-attribute,.restricted-doc-code .hljs-bullet,.restricted-doc-code .hljs-name,.restricted-doc-code .hljs-string,.restricted-doc-code .hljs-symbol,.restricted-doc-code .hljs-template-tag,.restricted-doc-code .hljs-template-variable,.restricted-doc-code .hljs-title,.restricted-doc-code .hljs-type,.restricted-doc-code .hljs-variable{color:#addb67}.restricted-doc-code .hljs-built_in,.restricted-doc-code .hljs-builtin-name,.restricted-doc-code .hljs-meta,.restricted-doc-code .hljs-number,.restricted-doc-code .hljs-params{color:#f78c6c}.restricted-doc-code .hljs-attr,.restricted-doc-code .hljs-selector-attr,.restricted-doc-code .hljs-selector-class,.restricted-doc-code .hljs-selector-id,.restricted-doc-code .hljs-selector-pseudo{color:#ffcb6b}.restricted-doc-code .hljs-class .hljs-title,.restricted-doc-code .hljs-function{color:#82aaff}.restricted-doc-code .hljs-deletion,.restricted-doc-code .hljs-regexp{color:#ff5370}.restricted-doc-code .hljs-emphasis{font-style:italic}.restricted-doc-code .hljs-strong{font-weight:700}.restricted-doc-callout{margin:1.5rem 0;padding:.9rem 1rem;border:1px solid rgba(59,130,246,.22);border-radius:.65rem;background:rgba(59,130,246,.07)}.restricted-doc blockquote>:first-child,.restricted-doc-callout>:first-child{margin-top:0}.restricted-doc blockquote>:last-child,.restricted-doc-callout>:last-child{margin-bottom:0}.restricted-doc blockquote{margin:1.5rem 0;padding:.1rem 0 .1rem 1.1rem;border-left:2px solid var(--restricted-border-strong);color:var(--restricted-muted);font-style:italic}.restricted-doc-toc ul{margin:.6rem 0 0;padding:0;list-style:none}.restricted-doc-toc li{margin:.35rem 0;line-height:1.35}.restricted-doc-toc li[data-level=\"3\"]{padding-left:.75rem}.restricted-doc-toc li[data-level=\"4\"]{padding-left:1.5rem}.restricted-doc-toc a{color:var(--restricted-muted);text-decoration:none}.restricted-doc-toc a:hover{color:var(--restricted-link)}.restricted-doc-toc-title{font-weight:600}.restricted-doc-not-found{min-height:20rem;padding:4rem 0;text-align:center}.restricted-doc-not-found h1{font-size:3rem}@media (max-width:768px){.restricted-doc>h1{font-size:1.85rem}.restricted-doc td,.restricted-doc th{min-width:6.5rem;padding:.65rem .75rem}.restricted-doc-code pre{padding:1rem}}"}],"page":{"pagePath":"api-reference/image-generation-i2i","slug":"/api-reference/image-generation-i2i","pageMetadata":{"title":"Image-to-Image Generation","sidebarTitle":"Image to Image","description":"Use this API to generate images from image input.","openapi":"api-reference/image/generation/api/image-to-image.json POST /v1/image_generation","href":"/api-reference/image-generation-i2i"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Use this API to generate images from image input.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Image-to-Image Generation","sidebarTitle":"Image to Image","description":"Use this API to generate images from image input.","openapi":"api-reference/image/generation/api/image-to-image.json POST /v1/image_generation","href":"/api-reference/image-generation-i2i"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/minimax-cac98058/74cbedfd7ddc6a81/scripts/auto-token.js","/docs/_mintlify/custom/minimax-cac98058/08175b8daa74cd64/scripts/logo.js","/docs/_mintlify/custom/minimax-cac98058/41d20d74582a83ee/scripts/head-userinfo.js","/docs/_mintlify/custom/minimax-cac98058/ee26a6e83cc5ae7f/scripts/navbar-same-tab.js","/docs/_mintlify/custom/minimax-cac98058/b2a91de372d716f8/scripts/pricing-dropdown.js","/docs/_mintlify/custom/minimax-cac98058/c76999ca41eb4aec/scripts/domain-link-rewrite.js","/docs/_mintlify/custom/minimax-cac98058/12fca2eba4fcc970/scripts/cookie-consent.js","/docs/_mintlify/custom/minimax-cac98058/444224329a77c4b1/scripts/page-view-tracking.js","/docs/_mintlify/custom/minimax-cac98058/07d15e8ada8d8bbf/scripts/restricted-docs-core.js","/docs/_mintlify/custom/minimax-cac98058/409396746d530a03/scripts/restricted-docs-highlight.js","/docs/_mintlify/custom/minimax-cac98058/728362c2608a54be/scripts/restricted-docs.js","/docs/_mintlify/custom/minimax-cac98058/50d87c5c4c9a98b0/scripts/rum.js","/docs/_mintlify/custom/minimax-cac98058/d479ebcf1e03e32e/scripts/pricing-navigation.js","/docs/_mintlify/custom/minimax-cac98058/b067abec70d0dbb6/scripts/feedback-consent.js"],"openApiReferenceData":{"operation":{"summary":"Image Generation","operationId":"imageGeneration","tags":["Image"],"parameters":["0b06fd05-bcad-4b01-9c52-e8ebfa013b55"],"requestBody":"65eadfd5-e83f-4f1b-ad65-64526da35b58","responses":{"200":"fbc14e14-44a4-4cb2-b962-702714c316a2"},"method":"post","type":"path","servers":["0cbf2ae3-6e25-4ef5-9dca-66d5ed40e35d"],"security":["c7cd8faa-316b-41d1-98b8-81c3c1116f29"],"path":"/v1/image_generation","baseUrlOptions":["https://api.minimax.io"],"title":"Image Generation","description":"Use this API to generate images from image input.","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.model":"image-01","body.prompt":"A girl looking into the distance from a library window","body.subject_reference.items.0.type":"character","body.subject_reference.items.0.image_file":"https://cdn.hailuoai.com/prod/2025-08-12-17/video_cover/1754990600020238321-411603868533342214-cover.jpg","body.aspect_ratio":"16:9","body.n":2}]},"dependencies":{"parameters":{"0b06fd05-bcad-4b01-9c52-e8ebfa013b55":{"name":"Content-Type","in":"header","required":true,"description":"The media type of the request body. Must be set to `application/json` to ensure the data is sent in JSON format.","schema":{"type":"string","enum":["application/json"],"default":"application/json","isRequired":true,"description":"The media type of the request body. Must be set to `application/json` to ensure the data is sent in JSON format.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"requestBody":{"description":"","content":{"application/json":{"schema":{"type":"object","required":["prompt","model"],"properties":{"model":{"type":"string","description":"Model name. Options: `image-01`.","enum":["image-01","image-01-live"],"isRequired":true,"uniqueKey":"model","typeLabel":"enum\u003cstring>"},"prompt":{"type":"string","description":"Text description of the image, max length 1500 characters.","isRequired":true,"uniqueKey":"prompt","typeLabel":"string"},"subject_reference":{"type":"array","items":{"type":"object","required":["type","image_file"],"properties":{"type":{"type":"string","description":"Subject type. Currently only supports `character` (portrait).","isRequired":true,"uniqueKey":"subject_reference.items.[INDEX].type","typeLabel":"string"},"image_file":{"type":"string","description":"Reference image file. Supports public URLs or Base64-encoded [Data URL](https://developer.mozilla.org/en-US/docs/Web/URI/Reference/Schemes/data) (`data:image/jpeg;base64,...`).\nFor best results, upload a single front-facing portrait photo.\n- Image requirements:\n\t- Formats: JPG, JPEG, PNG\n\t- Size: less than 10MB","isRequired":true,"uniqueKey":"subject_reference.items.[INDEX].image_file","typeLabel":"string"}},"uniqueKey":"subject_reference.items.[INDEX]","typeLabel":"object"},"description":"Subject reference for image-to-image generation.","uniqueKey":"subject_reference","typeLabel":"object[]"},"aspect_ratio":{"type":"string","description":"Image aspect ratio, default `1:1`. Options:\n- `1:1` (1024x1024)\n- `16:9` (1280x720)\n- `4:3` (1152x864)\n- `3:2` (1248x832)\n- `2:3` (832x1248)\n- `3:4` (864x1152)\n- `9:16` (720x1280)\n- `21:9` (1344x576)","enum":["1:1","16:9","4:3","3:2","2:3","3:4","9:16","21:9"],"uniqueKey":"aspect_ratio","typeLabel":"enum\u003cstring>"},"width":{"type":"integer","description":"Image width (px). Only effective for `image-01`. Must be set together with `height`. Range [512, 2048], must be divisible by 8. If both `width/height` and `aspect_ratio` are provided, `aspect_ratio` takes priority.","uniqueKey":"width","typeLabel":"integer"},"height":{"type":"integer","description":"Height of generated image (pixels). Only effective when `model` is `image-01`.\nSame rules as `width`.","uniqueKey":"height","typeLabel":"integer"},"response_format":{"type":"string","enum":["url","base64"],"default":"url","description":"Response format for images. Default: url. Options: url, base64.\nā ļø Note: url expires in 24 hours.","uniqueKey":"response_format","typeLabel":"enum\u003cstring>"},"seed":{"type":"integer","format":"int64","description":"Random seed. Using the same seed and parameters allows result reproduction.\nIf omitted, each of the n images will use a unique random seed.","uniqueKey":"seed","typeLabel":"integer\u003cint64>"},"n":{"type":"integer","default":1,"minimum":1,"maximum":9,"description":"Number of images to generate per request. Range [1, 9]. Default: 1.","uniqueKey":"n","typeLabel":"integer"},"prompt_optimizer":{"type":"boolean","default":false,"description":"Enable automatic optimization of prompt. Default: `false`.","uniqueKey":"prompt_optimizer","typeLabel":"boolean"}},"example":{"model":"image-01","prompt":"A girl looking into the distance from a library window","aspect_ratio":"16:9","subject_reference":[{"type":"character","image_file":"https://cdn.hailuoai.com/prod/2025-08-12-17/video_cover/1754990600020238321-411603868533342214-cover.jpg"}],"n":2},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"model":"image-01","prompt":"A girl looking into the distance from a library window","aspect_ratio":"16:9","subject_reference":[{"type":"character","image_file":"https://cdn.hailuoai.com/prod/2025-08-12-17/video_cover/1754990600020238321-411603868533342214-cover.jpg"}],"n":2}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"fbc14e14-44a4-4cb2-b962-702714c316a2":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"image_urls":{"type":"array","items":{"type":"string","uniqueKey":"data.image_urls.items.[INDEX]","typeLabel":"string"},"description":"Returned when `response_format` = `url`, contains an array of image links.","uniqueKey":"data.image_urls","typeLabel":"string[]"},"image_base64":{"type":"array","items":{"type":"string","uniqueKey":"data.image_base64.items.[INDEX]","typeLabel":"string"},"description":"Returned when `response_format` = `base64`, contains an array of base64-encoded images.","uniqueKey":"data.image_base64","typeLabel":"string[]"}},"uniqueKey":"data","typeLabel":"object"},"metadata":{"type":"object","properties":{"success_count":{"type":"integer","description":"Number of successfully generated images.","uniqueKey":"metadata.success_count","typeLabel":"integer"},"failed_count":{"type":"integer","description":"Number of images blocked due to content safety.","uniqueKey":"metadata.failed_count","typeLabel":"integer"}},"description":"Additional metadata about the generation.","uniqueKey":"metadata","typeLabel":"object"},"id":{"type":"string","description":"Trace ID for request tracking","uniqueKey":"id","typeLabel":"string"},"base_resp":{"type":"object","properties":{"status_code":{"type":"integer","description":"The status codes and their meanings are as follows:\n- `0`, Request successful\n- `1002`, Rate limit triggered, please try again later\n- `1004`, Account authentication failed, please check if the API Key is correct\n- `1008`, Insufficient account balance\n- `1026`, Sensitive content detected in prompt\n- `2013`, Invalid input parameters, please check if the parameters are filled in as required\n- `2049`, Invalid API Key\n\nFor more information, please refer to the [Error Code Reference](/api-reference/errorcode). ","uniqueKey":"base_resp.status_code","typeLabel":"integer"},"status_msg":{"type":"string","description":"Status details.","uniqueKey":"base_resp.status_msg","typeLabel":"string"}},"uniqueKey":"base_resp","typeLabel":"object"}},"example":{"id":"03ff3cd0820949eb8a410056b5f21d38","data":{"image_urls":["XXX","XXX","XXX"]},"metadata":{"failed_count":"0","success_count":"3"},"base_resp":{"status_code":0,"status_msg":"success"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"03ff3cd0820949eb8a410056b5f21d38","data":{"image_urls":["XXX","XXX","XXX"]},"metadata":{"failed_count":"0","success_count":"3"},"base_resp":{"status_code":0,"status_msg":"success"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c7cd8faa-316b-41d1-98b8-81c3c1116f29":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"`HTTP: Bearer Auth`\n- Security Scheme Type: http\n- HTTP Authorization Scheme: `Bearer API_key`, can be found in [Account Management>API Keys](https://platform.minimax.io/user-center/basic-information/interface-key).","scopes":[]}}},"servers":{"0cbf2ae3-6e25-4ef5-9dca-66d5ed40e35d":{"url":"https://api.minimax.io"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"`HTTP: Bearer Auth`\n- Security Scheme Type: http\n- HTTP Authorization Scheme: `Bearer API_key`, can be found in [Account Management>API Keys](https://platform.minimax.io/user-center/basic-information/interface-key).","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"`HTTP: Bearer Auth`\n- Security Scheme Type: http\n- HTTP Authorization Scheme: `Bearer API_key`, can be found in [Account Management>API Keys](https://platform.minimax.io/user-center/basic-information/interface-key).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/image/generation/api/image-to-image.json"},"subdomain":"minimax-cac98058","siteName":"MiniMax API Docs","title":"Image-to-Image Generation - MiniMax API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-28T05:51:43.046Z","originalFileLocation":"api-reference/image-generation-i2i.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Use this API to generate images from image input.\">\u003cmeta data-mint-head name=\"application-name\" content=\"MiniMax API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Image-to-Image Generation - MiniMax API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Use this API to generate images from image input.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MiniMax API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://platform.minimax.io/docs/api-reference/image-generation-i2i\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://filecdn.minimax.chat/public/58eca777-e31f-448a-9823-e2220e49b426.png\">\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-to-Image Generation - MiniMax API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Use this API to generate images from image input.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://filecdn.minimax.chat/public/58eca777-e31f-448a-9823-e2220e49b426.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/minimax-cac98058/-WSO_KEoennf5XoM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MiniMax API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#181E25\">\u003cmeta data-mint-head name=\"charset\" content=\"UTF-8\">\u003cmeta data-mint-head name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://platform.minimax.io/docs/api-reference/image-generation-i2i\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/image-generation-i2i.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://platform.minimax.io/#organization\",\"name\":\"MiniMax API Docs\",\"url\":\"https://platform.minimax.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/minimax-cac98058/XYzsL2L2ynonu2Q_/logo/light.svg?fit=max\u0026auto=format\u0026n=XYzsL2L2ynonu2Q_\u0026q=85\u0026s=9c99bb2678d62388d8a4e7cce1750858\"}},{\"@type\":\"WebSite\",\"@id\":\"https://platform.minimax.io/docs#website\",\"name\":\"MiniMax API Docs\",\"url\":\"https://platform.minimax.io/docs\",\"publisher\":{\"@id\":\"https://platform.minimax.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://platform.minimax.io/docs/api-reference/image-generation-i2i#webpage\",\"url\":\"https://platform.minimax.io/docs/api-reference/image-generation-i2i\",\"name\":\"Image-to-Image Generation\",\"description\":\"Use this API to generate images from image input.\",\"dateModified\":\"2026-01-28T05:51:43.046Z\",\"isPartOf\":{\"@id\":\"https://platform.minimax.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://platform.minimax.io/docs/api-reference/image-generation-i2i#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://platform.minimax.io/docs/api-reference/image-generation-i2i#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Image\",\"item\":\"https://platform.minimax.io/docs/api-reference/image-generation-t2i\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Image Generation\",\"item\":\"https://platform.minimax.io/docs/api-reference/image-generation-t2i\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Image-to-Image Generation\",\"item\":\"https://platform.minimax.io/docs/api-reference/image-generation-i2i\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://platform.minimax.io/docs/api-reference/image-generation-i2i#apireference\",\"headline\":\"Image-to-Image Generation\",\"name\":\"Image-to-Image Generation\",\"description\":\"Use this API to generate images from image input.\",\"url\":\"https://platform.minimax.io/docs/api-reference/image-generation-i2i\",\"mainEntityOfPage\":{\"@id\":\"https://platform.minimax.io/docs/api-reference/image-generation-i2i#webpage\"},\"image\":\"https://filecdn.minimax.chat/public/58eca777-e31f-448a-9823-e2220e49b426.png\",\"dateModified\":\"2026-01-28T05:51:43.046Z\",\"publisher\":{\"@id\":\"https://platform.minimax.io/#organization\"},\"isPartOf\":{\"@id\":\"https://platform.minimax.io/docs#website\"}}]}\u003c/script>","siteName":"MiniMax API Docs","nav":{"global":null,"tabs":[{"tab":"Developer Guides","pages":[{"title":"Developer Guides","href":"/guides/models-intro"}]},{"tab":"API","groups":[{"group":"Using the API","pages":[{"title":"API Overview","sidebarTitle":"API Overview","href":"/api-reference/api-overview"},{"title":"Rate Limits","href":"/guides/rate-limits"},{"title":"Error Codes","sidebarTitle":"Error Code Reference","href":"/api-reference/errorcode"}]},{"group":"Text","icon":"https://filecdn.minimax.chat/public/4ab63cda-da2a-4c77-b1c7-900d2562073f.png","pages":[{"title":"Anthropic SDK","sidebarTitle":"Anthropic SDK (Recommended)","href":"/api-reference/text-anthropic-api"},{"title":"OpenAI SDK","sidebarTitle":"OpenAI SDK","href":"/api-reference/text-openai-api"},{"title":"AI SDK","sidebarTitle":"AI SDK","href":"/api-reference/text-ai-sdk"},{"group":"Anthropic Messages API","pages":[{"title":"Create Message","sidebarTitle":"Create Message","openapi":"api-reference/text/api/openapi-chat-anthropic.json POST /anthropic/v1/messages","href":"/api-reference/text-chat-anthropic"}]},{"group":"OpenAI Chat Completions API","pages":[{"title":"Create Chat Completion","sidebarTitle":"Create Chat Completion","openapi":"api-reference/text/api/openapi-chat-openai.json POST /v1/chat/completions","href":"/api-reference/text-chat-openai"}]},{"group":"OpenAI Responses API","pages":[{"title":"Create Response","sidebarTitle":"Create Response","openapi":"api-reference/text/api/openapi-responses.json POST /v1/responses","href":"/api-reference/responses-create"},{"title":"Estimate Input Tokens","sidebarTitle":"Estimate Input Tokens","openapi":"api-reference/text/api/openapi-responses.json POST /v1/responses/input_tokens","href":"/api-reference/responses-input-tokens"}]}]},{"group":"Video","icon":"https://filecdn.minimax.chat/public/766ab356-4817-4bf1-8849-0f64728d811f.png","pages":[{"group":"MiniMax-H3","tag":"NEW","pages":[{"title":"Create Video Generation Task","sidebarTitle":"Create Video Generation Task","openapi":"api-reference/video/generation/api/v2-video-generation.json POST /v2/video_generation","href":"/api-reference/video-generation-v2-create"},{"title":"Query Task","sidebarTitle":"Query Task","openapi":"api-reference/video/generation/api/v2-video-generation.json GET /v2/query/video_generation/{task_id}","href":"/api-reference/video-generation-v2-query"},{"title":"List Tasks","sidebarTitle":"List Tasks","openapi":"api-reference/video/generation/api/v2-video-generation.json GET /v2/query/video_generation","href":"/api-reference/video-generation-v2-list"},{"title":"Cancel or Delete Task","sidebarTitle":"Cancel or Delete Task","openapi":"api-reference/video/generation/api/v2-video-generation.json DELETE /v2/video_generation/{task_id}","href":"/api-reference/video-generation-v2-delete"},{"title":"Create H3-Context-IR Task","sidebarTitle":"Create H3-Context-IR Task","openapi":"api-reference/video/generation/api/v2-video-generation.json POST /v2/h3_context_ir","href":"/api-reference/video-generation-v2-h3-context-ir"},{"title":"Create Video Regeneration Task","sidebarTitle":"Create Video Regeneration Task","openapi":"api-reference/video/generation/api/v2-video-generation.json POST /v2/video_regeneration","href":"/api-reference/video-generation-v2-regeneration"}]},{"group":"Video Generation","pages":[{"title":"Create Text-to-Video Generation Task","sidebarTitle":"Text to Video","openapi":"api-reference/video/generation/api/text-to-video.json POST /v1/video_generation","href":"/api-reference/video-generation-t2v"},{"title":"Image-to-Video Task","sidebarTitle":"Image to Video","openapi":"api-reference/video/generation/api/image-to-video.json POST /v1/video_generation","href":"/api-reference/video-generation-i2v"},{"title":"Create First \u0026 Last Frame Video Generation Task","sidebarTitle":"Start / End to Video","openapi":"api-reference/video/generation/api/start-end-to-video.json POST /v1/video_generation","href":"/api-reference/video-generation-fl2v"},{"title":"Subject-Reference to Video Generation Task","sidebarTitle":"Subject Reference to Video","openapi":"api-reference/video/generation/api/subject-reference-to-video.json POST /v1/video_generation","href":"/api-reference/video-generation-s2v"},{"title":"Query Video Generation Task Status","openapi":"api-reference/video/generation/api/openapi.json GET /v1/query/video_generation","href":"/api-reference/video-generation-query"},{"title":"Video Download","sidebarTitle":"Download the Video File","openapi":"api-reference/video/generation/api/openapi.json GET /v1/files/retrieve","href":"/api-reference/video-generation-download"}]}]},{"group":"Speech","icon":"https://filecdn.minimax.chat/public/ebfd6f8e-5b5a-4edd-8253-6c731d3b368f.png","pages":[{"group":"Speech to Text","tag":"NEW","pages":[{"title":"Speech to Text","sidebarTitle":"Speech to Text","openapi":"api-reference/speech/speech-to-text/api/openapi.json POST /v1/speech_to_text","href":"/api-reference/speech-to-text"}]},{"group":"Text to Speech","pages":[{"title":"Synchronous Text to Speech","openapi":"api-reference/speech/t2a/api/openapi.json POST /v1/t2a_v2","href":"/api-reference/speech-t2a-http"},{"title":"Synchronous Text to Speech","asyncapi":"api-reference/speech/t2a/api/asyncapi.json t2a_v2_websocket","href":"/api-reference/speech-t2a-websocket"},{"title":"Bidirectional Streaming Text to Speech","asyncapi":"api-reference/speech/t2a/api/asyncapi-bidi.json t2a_v2_bidi_websocket","href":"/api-reference/speech-t2a-websocket-bidi"}]},{"group":"Async Text to Speech","pages":[{"title":"Create Speech Generation Task","openapi":"api-reference/speech/t2a-async/api/openapi.json POST /v1/t2a_async_v2","href":"/api-reference/speech-t2a-async-create"},{"title":"Query Speech Generation Task Status","openapi":"api-reference/speech/t2a-async/api/openapi.json GET /v1/query/t2a_async_query_v2","href":"/api-reference/speech-t2a-async-query"}]},{"group":"Voice Cloning","pages":[{"title":"Upload Audio for Voice Cloning","sidebarTitle":"Upload Audio File","openapi":"api-reference/speech/voice-cloning/api/upload-file.json POST /v1/files/upload","href":"/api-reference/voice-cloning-uploadcloneaudio"},{"title":"Upload Prompt Auido","sidebarTitle":"Upload Prompt Audio","openapi":"api-reference/speech/voice-cloning/api/upload-prompt.json POST /v1/files/upload","href":"/api-reference/voice-cloning-uploadprompt"},{"title":"Voice Clone","openapi":"api-reference/speech/voice-cloning/api/openapi.json POST /v1/voice_clone","href":"/api-reference/voice-cloning-clone"}]},{"group":"Voice Design","pages":[{"title":"Voice Design","openapi":"api-reference/speech/voice-design/api/openapi.json POST /v1/voice_design","href":"/api-reference/voice-design-design"}]},{"group":"Voice Management","pages":[{"title":"Get Voice","openapi":"api-reference/speech/voice-management/api/openapi.json POST /v1/get_voice","href":"/api-reference/voice-management-get"},{"title":"Delete Voice","openapi":"api-reference/speech/voice-management/api/openapi.json POST /v1/delete_voice","href":"/api-reference/voice-management-delete"}]}]},{"group":"Image","icon":"https://filecdn.minimax.chat/public/c67ded66-6213-441f-b784-6866c6943aef.png","pages":[{"group":"Image Generation","pages":[{"title":"Text to Image Generation","sidebarTitle":"Text-to-Image","description":"Use this API to generate images from text input.","openapi":"api-reference/image/generation/api/text-to-image.json POST /v1/image_generation","href":"/api-reference/image-generation-t2i"},{"title":"Image-to-Image Generation","sidebarTitle":"Image to Image","openapi":"api-reference/image/generation/api/image-to-image.json POST /v1/image_generation","href":"/api-reference/image-generation-i2i"}]}]},{"group":"Music","icon":"https://filecdn.minimax.chat/public/0f1ab37b-78fd-41ab-945d-a20c1ac436b4.png","pages":[{"group":"Music Generation","pages":[{"title":"Music Generation","description":"Use this API to generate a song from lyrics and a prompt.","openapi":"POST /v1/music_generation","href":"/api-reference/music-generation"},{"title":"Music Cover Preprocess","openapi":"POST /v1/music_cover_preprocess","href":"/api-reference/music-cover-preprocess"},{"title":"Lyrics Generation","openapi":"POST /v1/lyrics_generation","href":"/api-reference/lyrics-generation"}]}]},{"group":"File","icon":"https://filecdn.minimax.chat/public/1291e3fd-3307-4344-ba3e-40fa3780419f.png","pages":[{"group":"File Management","pages":[{"title":"Upload File","sidebarTitle":"Upload","openapi":"api-reference/file/management/api/openapi.json POST /v1/files/upload","href":"/api-reference/file-management-upload"},{"title":"List Files","sidebarTitle":"List","openapi":"api-reference/file/management/api/openapi.json GET /v1/files/list","href":"/api-reference/file-management-list"},{"title":"Retrieve File","sidebarTitle":"Retrieve","openapi":"api-reference/file/management/api/openapi.json GET /v1/files/retrieve","href":"/api-reference/file-management-retrieve"},{"title":"Retrieve Content","sidebarTitle":"Retrieve File Content","openapi":"api-reference/file/management/api/openapi.json GET /v1/files/retrieve_content","href":"/api-reference/file-management-retrieve-content"},{"title":"Delete File","sidebarTitle":"Delete","openapi":"api-reference/file/management/api/openapi.json POST /v1/files/delete","href":"/api-reference/file-management-delete"}]}]},{"group":"Models","icon":"boxes","pages":[{"group":"OpenAI Compatible","pages":[{"title":"List Models","openapi":"api-reference/models/openai/api/list-models.json GET /v1/models","href":"/api-reference/models/openai/list-models"},{"title":"Retrieve Model","openapi":"api-reference/models/openai/api/retrieve-model.json GET /v1/models/{model_id}","href":"/api-reference/models/openai/retrieve-model"}]},{"group":"Anthropic Compatible","pages":[{"title":"List Models","openapi":"api-reference/models/anthropic/api/list-models.json GET /anthropic/v1/models","href":"/api-reference/models/anthropic/list-models"},{"title":"Retrieve Model","openapi":"api-reference/models/anthropic/api/retrieve-model.json GET /anthropic/v1/models/{model_id}","href":"/api-reference/models/anthropic/retrieve-model"}]}]}]},{"tab":"M Plan","pages":[{"title":"M Plan","href":"/m-plan/intro"}]},{"tab":"Pricing","pages":[{"title":"Pricing","href":"/pricing/overview"}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes/models"}]},{"tab":"Developer Program","href":"https://platform.minimax.io/activity/contact-us-en"}]},"basePath":"","title":"Image-to-Image Generation - MiniMax API Docs","buildId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","deploymentId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-CGuHEvQW.js","dist-B66mVNPp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-BcghKhHb.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-CLz2_Z5D.js","utils-7A5jZhOT.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BVWmkKuv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-4SOfrh0F.js","snippetPresets-CMc8KicP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ba9tX7z3.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Be8krXvv.js","shallow-CBC3K1uB.js","getApiPlaygroundDisplay-4tKcUAYo.js","CodeSnippet-C1Xa06ft.js","CodeSnippets-vqiz27A_.js","Page-DeQN5MDd.js","getPastedJson-NUwRfM32.js","icon-DkIVqWh9.js","MethodPill-qmhT7_wz.js","DuplicateIcon-_gWp1vhn.js","createIcon-NA1p_TVA.js","DynamicMarkdown-Bas9A7wq.js","SectionHeading-a1cS-24U.js","axios-vUo_bRtp.js","Markdown-D3ZTwq_a.js","AssistantPageLink-DmooSyTN.js"]}