작업은 pending, queued, in_progress 를 거쳐 최종적으로 completed 또는 failed 가 됩니다. completed 이면 result.data 에서 이미지 URL을 읽고, failed 이면 error 를 읽습니다. 몇 초마다 한 번씩 조회하는 것을 권장합니다. 전체 필드는 이미지 작업 상태 조회 를 참고하세요.제출 성공은 작업이 생성되었음을 의미합니다. completed 가 된 뒤에 이미지를 다운로드하고, 대기하는 동안에는 같은 작업 ID를 계속 조회하세요.
화면 비율입니다. 예: 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 21:9.비율을 사용하고 resolution 을 명시적으로 입력하는 것을 권장합니다. 서버는 두 값을 기준으로 출력 픽셀 크기를 계산합니다. 일반 버전의 비율 표기 방식은 VIP 버전의 픽셀 크기 표기 방식과 다릅니다.
이미지 투 이미지 생성을 위한 선택 사항인 참조 이미지 URL 목록입니다. 이미지 주소는 서버에서 접근할 수 있어야 합니다. 이미지 URL 만 지원하며 로컬 파일 업로드와 base64 는 지원하지 않습니다. 로컬 이미지는 먼저 Upload 이미지 API 로 업로드해 URL 을 받으세요.image_urls 도 호환됩니다. 둘 중 하나의 필드만 사용하세요.
VIP 로 전환할 때는 모델명과 파라미터를 함께 조정하세요. 자세한 내용은 GPT-Image-2.5 VIP 를 참고하세요.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ToAPIs Documentation","colors":{"primary":"#2563EB","light":"#3B82F6","dark":"#1D4ED8"},"logo":{"light":"https://mintcdn.com/dashlyai/a_NCjmRocEr6wT0r/logo/light.svg?fit=max\u0026auto=format\u0026n=a_NCjmRocEr6wT0r\u0026q=85\u0026s=3d58ff2776a33f0fb61c09a496c32cde","dark":"https://mintcdn.com/dashlyai/a_NCjmRocEr6wT0r/logo/dark.svg?fit=max\u0026auto=format\u0026n=a_NCjmRocEr6wT0r\u0026q=85\u0026s=a743e3732e358cf5ef51f6d0e20b83e2"},"favicon":"https://mintcdn.com/dashlyai/a_NCjmRocEr6wT0r/favicon.svg?fit=max\u0026auto=format\u0026n=a_NCjmRocEr6wT0r\u0026q=85\u0026s=8faf46e48cc405e456b8d27296c8dadd","navbar":{"links":[{"href":"https://x.com/toapisai","label":"X"},{"href":"https://discord.gg/hvnszCrJ73","label":"Discord"},{"href":"https://toapis.com/wechat","label":"WeChat"}],"primary":{"type":"button","label":"Dashboard","href":"https://toapis.com/dashboard"}},"footer":{"socials":{"x":"https://x.com/toapisai","github":"https://github.com/ToAPIs","linkedin":"https://linkedin.com/company/ToAPIs","discord":"https://discord.gg/hvnszCrJ73"}},"seo":{"paths":[{"path":"docs/cn","metatags":{"og:image":"https://docs.toapis.com/docs/assets/images/og-default.png","twitter:image":"https://docs.toapis.com/docs/assets/images/og-default.png"}},{"path":"docs/zh-Hant","metatags":{"og:image":"https://docs.toapis.com/docs/assets/images/og-default.png","twitter:image":"https://docs.toapis.com/docs/assets/images/og-default.png"}},{"path":"docs/ja","metatags":{"og:image":"https://docs.toapis.com/docs/assets/images/og-default.png","twitter:image":"https://docs.toapis.com/docs/assets/images/og-default.png"}},{"path":"docs/ko","metatags":{"og:image":"https://docs.toapis.com/docs/assets/images/og-default.png","twitter:image":"https://docs.toapis.com/docs/assets/images/og-default.png"}}]},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":true},"navigation":{"languages":[{"language":"cn","href":"docs/cn/quickstart"},{"language":"zh-Hant","href":"docs/zh-Hant/quickstart"},{"language":"en","href":"docs/en"},{"language":"ja","href":"docs/ja"},{"language":"ko","href":"docs/ko"},{"language":"ru","href":"docs/ru"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dashlyai","hasAudioNarration":false,"actualSubdomain":"dashlyai","customDomains":["docs.toapis.com"],"gitSource":{"type":"github","owner":"blackai2025","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adca0d0dbdae3a1f6de3896","collectionId":"447aae0b-77b7-4d03-9d8f-5b308655a1d1","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adca0d0dbdae3a1f6de3896"},"entitlements":{},"buildId":"6adca0d0dbdae3a1f6de3896","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"en","tag":"API Reference","count":130},{"language":"cn","tag":"API 手册","count":129},{"language":"ru","tag":"Справочник API","count":111},{"language":"ja","tag":"APIリファレンス","count":110},{"language":"ko","tag":"API 참조","count":110},{"language":"zh-Hant","tag":"API 手冊","count":109},{"language":"cn","tag":"图像系列","count":47},{"language":"en","tag":"Image API","count":47},{"language":"cn","tag":"视频系列","count":45},{"language":"en","tag":"Video API","count":45},{"language":"ja","tag":"動画API","count":45},{"language":"ko","tag":"비디오 API","count":45},{"language":"ru","tag":"API видео","count":45},{"language":"zh-Hant","tag":"視頻系列","count":45},{"language":"ja","tag":"画像API","count":28},{"language":"ko","tag":"이미지 API","count":28},{"language":"ru","tag":"API изображений","count":28},{"language":"zh-Hant","tag":"圖像系列","count":28},{"language":"cn","tag":"Midjourney","count":19},{"language":"en","tag":"Midjourney","count":19},{"language":"cn","tag":"音乐系列","count":8},{"language":"cn","tag":"Suno 音乐","count":8},{"language":"cn","tag":"文本对话系列","count":8},{"language":"en","tag":"Music API","count":8},{"language":"en","tag":"Suno Music","count":8},{"language":"en","tag":"Chat API","count":8},{"language":"ja","tag":"音楽API","count":8},{"language":"ja","tag":"Suno 音楽","count":8},{"language":"ko","tag":"음악 API","count":8},{"language":"ko","tag":"Suno 음악","count":8},{"language":"ru","tag":"API музыки","count":8},{"language":"ru","tag":"Suno","count":8},{"language":"ru","tag":"API чата","count":8},{"language":"zh-Hant","tag":"音樂系列","count":8},{"language":"zh-Hant","tag":"Suno 音樂","count":8},{"language":"ja","tag":"チャットAPI","count":7},{"language":"ko","tag":"채팅 API","count":7},{"language":"zh-Hant","tag":"文本對話系列","count":7},{"language":"cn","tag":"快速上手","count":6},{"language":"en","tag":"Quick Start","count":6},{"language":"ja","tag":"クイックスタート","count":6},{"language":"ko","tag":"빠른 시작","count":6},{"language":"ru","tag":"Быстрый старт","count":6},{"language":"zh-Hant","tag":"快速上手","count":6},{"language":"cn","tag":"账户","count":5},{"language":"cn","tag":"任务管理","count":5},{"language":"en","tag":"Account","count":5},{"language":"en","tag":"Task Management","count":5},{"language":"ja","tag":"アカウント","count":5},{"language":"ja","tag":"タスク管理","count":5},{"language":"ko","tag":"계정","count":5},{"language":"ko","tag":"작업 관리","count":5},{"language":"ru","tag":"Аккаунт","count":5},{"language":"ru","tag":"Управление задачами","count":5},{"language":"zh-Hant","tag":"賬戶","count":5},{"language":"zh-Hant","tag":"任務管理","count":5},{"language":"ja","tag":"Grok Video","count":4},{"language":"ko","tag":"Grok Video","count":4},{"language":"ru","tag":"Grok Video","count":4},{"language":"zh-Hant","tag":"Grok Video","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"docs/ko/api-reference/images/gpt-image-2.5/generation","slug":"/docs/ko/api-reference/images/gpt-image-2.5/generation","pageMetadata":{"title":"GPT-Image-2.5 이미지 생성","sidebarTitle":"GPT-Image-2.5","api":"POST https://toapis.com/v1/images/generations","description":"gpt-image-2.5-flare 와 gpt-image-2.5-sunburst 일반 버전 연동 가이드로, 비동기 작업, 참조 이미지, 투명 배경, 고정 high 품질과 해상도별 과금을 다룹니다","href":"/docs/ko/api-reference/images/gpt-image-2.5/generation"},"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: \"gpt-image-2.5-flare 와 gpt-image-2.5-sunburst 일반 버전 연동 가이드로, 비동기 작업, 참조 이미지, 투명 배경, 고정 high 품질과 해상도별 과금을 다룹니다\"\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`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`일반 버전은 `,_jsx(_components.code,{children:`POST /v1/images/generations`}),` 로 이미지 작업을 생성하고 작업 ID를 반환합니다. 작업이 완료되면 조회 API로 이미지 URL을 가져옵니다. 두 모델은 동일한 요청 형식을 사용합니다:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`모델`}),_jsx(_components.th,{children:`요청의 model`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Flare`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`gpt-image-2.5-flare`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Sunburst`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`gpt-image-2.5-sunburst`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`gpt-image-2.5`}),` 는 시리즈 이름입니다. 호출할 때는 표에 있는 전체 모델명을 입력하세요.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`이 문서는 일반 버전을 설명합니다. 실제 token 으로 과금하려면 별도의 `,_jsx(_components.a,{href:`/docs/ko/api-reference/images/gpt-image-2.5-vip/generation`,children:`GPT-Image-2.5 VIP 문서`}),` 를 사용하세요. 두 버전 모두 비동기 작업이며, 주요 차이는 size 형식과 과금 방식입니다.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`중국 본토 사용자 안내:`}),` 중국 본토 사용자는 `,_jsx(_components.code,{children:`https://toapis.cn`}),` 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 `,_jsx(_components.code,{children:`https://toapis.com`}),` 을 `,_jsx(_components.code,{children:`https://toapis.cn`}),` 로 바꿔 주세요.`]})}),`\n`,_jsxs(_components.p,{children:[`API Key 는 `,_jsx(_components.a,{href:`https://toapis.com/dashboard`,children:`콘솔`}),` 에서 생성할 수 있습니다.`]}),`\n`,_jsx(Heading,{level:`2`,id:`빠른-시작`,children:`빠른 시작`}),`\n`,_jsxs(_components.p,{children:[`ToAPIs API Key 를 환경 변수 `,_jsx(_components.code,{children:`TOAPIS_API_KEY`}),` 로 설정한 뒤 작업을 제출하세요:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`12`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --fail-with-body`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://toapis.com/v1/images/generations`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$TOAPIS_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"model\": \"gpt-image-2.5-flare\",`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"prompt\": \"Children's`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` picture`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` book`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` style,`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` a`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` veterinarian`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` listening`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` to`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` a`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` baby`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` otter's heartbeat with a stethoscope\",`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"quality\": \"high\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"size\": \"1:1\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resolution\": \"1K\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"n\": 1`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`제출 응답 예시:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,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:`9`,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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tsk_img_example\"`}),_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:` \"object\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"generation.task\"`}),_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.5-flare\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pending\"`}),_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:` \"progress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_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:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1788951900`}),_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:` \"metadata\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {}`})]}),`\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:`id`}),` 를 저장하고 아래의 `,_jsx(_components.code,{children:`TASK_ID`}),` 를 해당 값으로 바꾼 뒤 조회하세요:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --fail-with-body`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://toapis.com/v1/images/generations/TASK_ID`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$TOAPIS_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`작업은 `,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`queued`}),`, `,_jsx(_components.code,{children:`in_progress`}),` 를 거쳐 최종적으로 `,_jsx(_components.code,{children:`completed`}),` 또는 `,_jsx(_components.code,{children:`failed`}),` 가 됩니다. `,_jsx(_components.code,{children:`completed`}),` 이면 `,_jsx(_components.code,{children:`result.data`}),` 에서 이미지 URL을 읽고, `,_jsx(_components.code,{children:`failed`}),` 이면 `,_jsx(_components.code,{children:`error`}),` 를 읽습니다. 몇 초마다 한 번씩 조회하는 것을 권장합니다. 전체 필드는 `,_jsx(_components.a,{href:`/docs/ko/api-reference/tasks/image-status`,children:`이미지 작업 상태 조회`}),` 를 참고하세요.`]}),`\n`,_jsxs(_components.p,{children:[`제출 성공은 작업이 생성되었음을 의미합니다. `,_jsx(_components.code,{children:`completed`}),` 가 된 뒤에 이미지를 다운로드하고, 대기하는 동안에는 같은 작업 ID를 계속 조회하세요.`]}),`\n`,_jsx(Heading,{level:`2`,id:`body`,children:`Body`}),`\n`,_jsx(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`Bearer YOUR_TOAPIS_API_KEY`}),` 로 인증합니다.`]})}),`\n`,_jsx(ParamField,{body:`model`,type:`string`,required:true,id:`param-model`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`gpt-image-2.5-flare`}),` 또는 `,_jsx(_components.code,{children:`gpt-image-2.5-sunburst`}),`.`]})}),`\n`,_jsx(ParamField,{body:`prompt`,type:`string`,required:true,id:`param-prompt`,children:_jsx(_components.p,{children:`이미지 설명입니다. 참조 이미지를 사용할 때는 유지할 대상과 수정할 내용을 설명에 담아야 합니다.`})}),`\n`,_jsxs(ParamField,{body:`quality`,type:`string`,default:`high`,id:`param-quality`,children:[_jsxs(_components.p,{children:[`현재 일반 버전은 `,_jsx(_components.code,{children:`high`}),` 로 고정되어 있어 이 파라미터를 생략할 수 있습니다. 다른 문자열 값을 전달하면 무시되고 `,_jsx(_components.code,{children:`high`}),` 가 사용됩니다. Playground 는 품질 옵션을 표시하지 않습니다.`]}),_jsx(_components.p,{children:`현재 일반 버전은 resolution 을 기준으로 요금이 책정됩니다.`})]}),`\n`,_jsxs(ParamField,{body:`size`,type:`string`,default:`1:1`,id:`param-size`,children:[_jsxs(_components.p,{children:[`화면 비율입니다. 예: `,_jsx(_components.code,{children:`1:1`}),`, `,_jsx(_components.code,{children:`3:2`}),`, `,_jsx(_components.code,{children:`2:3`}),`, `,_jsx(_components.code,{children:`4:3`}),`, `,_jsx(_components.code,{children:`3:4`}),`, `,_jsx(_components.code,{children:`5:4`}),`, `,_jsx(_components.code,{children:`4:5`}),`, `,_jsx(_components.code,{children:`16:9`}),`, `,_jsx(_components.code,{children:`9:16`}),`, `,_jsx(_components.code,{children:`21:9`}),`.`]}),_jsx(_components.p,{children:`비율을 사용하고 resolution 을 명시적으로 입력하는 것을 권장합니다. 서버는 두 값을 기준으로 출력 픽셀 크기를 계산합니다. 일반 버전의 비율 표기 방식은 VIP 버전의 픽셀 크기 표기 방식과 다릅니다.`})]}),`\n`,_jsx(ParamField,{body:`resolution`,type:`string`,default:`1K`,id:`param-resolution`,children:_jsxs(_components.p,{children:[`해상도 등급으로 `,_jsx(_components.code,{children:`1K`}),`, `,_jsx(_components.code,{children:`2K`}),`, `,_jsx(_components.code,{children:`4K`}),` 를 지원하고 소문자 형식도 허용합니다. 이 필드가 일반 버전의 과금 등급을 결정합니다.`]})}),`\n`,_jsxs(ParamField,{body:`background`,type:`string`,id:`param-background`,children:[_jsxs(_components.p,{children:[`선택적 배경 매개변수입니다. `,_jsx(_components.code,{children:`\"transparent\"`}),`를 지정하면 투명 배경 이미지를 생성합니다. 생략하면 일반 이미지를 생성합니다.`]}),_jsxs(_components.p,{children:[`텍스트 기반 생성과 `,_jsx(_components.code,{children:`reference_images`}),`가 포함된 요청 모두에 사용할 수 있습니다.`]})]}),`\n`,_jsx(ParamField,{body:`n`,type:`integer`,default:1,id:`param-n`,children:_jsxs(_components.p,{children:[`요청당 `,_jsx(_components.code,{children:`1`}),` 을 사용해 이미지 한 장을 생성합니다.`]})}),`\n`,_jsxs(ParamField,{body:`reference_images`,type:`string[]`,id:`param-reference-images`,children:[_jsxs(_components.p,{children:[`이미지 투 이미지 생성을 위한 선택 사항인 참조 이미지 URL 목록입니다. 이미지 주소는 서버에서 접근할 수 있어야 합니다. 이미지 URL 만 지원하며 로컬 파일 업로드와 base64 는 지원하지 않습니다. 로컬 이미지는 먼저 `,_jsx(_components.a,{href:`/docs/ko/api-reference/uploads/images`,children:`Upload 이미지 API`}),` 로 업로드해 URL 을 받으세요.`]}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`image_urls`}),` 도 호환됩니다. 둘 중 하나의 필드만 사용하세요.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`투명-배경`,children:`투명 배경`}),`\n`,_jsxs(_components.p,{children:[`생성 요청에 `,_jsx(_components.code,{children:`\"background\": \"transparent\"`}),`를 추가하면 투명 배경 이미지를 받을 수 있습니다. 생략하면 일반 생성이 됩니다.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --fail-with-body`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://toapis.com/v1/images/generations`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$TOAPIS_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"model\": \"gpt-image-2.5-flare\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"prompt\": \"투명 배경의 빨간 원형 스티커\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"quality\": \"high\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"size\": \"1:1\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resolution\": \"1K\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"background\": \"transparent\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"n\": 1`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`완료 후에는 평소처럼 작업 ID로 조회하고 `,_jsx(_components.code,{children:`result.data`}),`에서 이미지 URL을 읽습니다.`]}),`\n`,_jsx(Heading,{level:`2`,id:`비율과-해상도-예시`,children:`비율과 해상도 예시`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`size`}),_jsx(_components.th,{children:`1K`}),_jsx(_components.th,{children:`2K`}),_jsx(_components.th,{children:`4K`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1:1`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1024x1024`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2048x2048`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2880x2880`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`3:2`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1536x1024`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2048x1360`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`3520x2336`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2:3`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1024x1536`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1360x2048`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2336x3520`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`16:9`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1536x864`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2048x1152`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`3840x2160`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`9:16`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`864x1536`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1152x2048`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`2160x3840`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`4K`}),` 는 해상도 등급을 의미하고 실제 가로와 세로는 화면 비율에 따라 달라집니다. 예를 들어 정사각형 4K 출력은 `,_jsx(_components.code,{children:`2880x2880`}),` 입니다.`]}),`\n`,_jsx(Heading,{level:`2`,id:`참조-이미지-생성`,children:`참조 이미지 생성`}),`\n`,_jsxs(_components.p,{children:[`동일한 생성 API 를 사용하고 `,_jsx(_components.code,{children:`reference_images`}),` 를 추가합니다. 아래 예시는 Sunburst 를 사용하며 반환값은 여전히 비동기 작업입니다:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --fail-with-body`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://toapis.com/v1/images/generations`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$TOAPIS_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"model\": \"gpt-image-2.5-sunburst\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"prompt\": \"Keep the baby otter and the veterinarian from the reference image, and add a yellow scarf to the baby otter\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"reference_images\": [\"https://example.com/otter.png\"],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"quality\": \"high\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"size\": \"1:1\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"resolution\": \"2K\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"n\": 1`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`https://example.com/otter.png`}),` 를 자신의 참조 이미지 URL 로 바꾼 뒤 반환된 작업 ID로 결과를 조회하세요.`]}),`\n`,_jsx(Heading,{level:`2`,id:`가격`,children:`가격`}),`\n`,_jsx(_components.p,{children:`아래는 2026-09-09 기준으로 확인한 표준 가격이며 생성 1회당 이미지 한 장 기준입니다. 두 일반 버전 모델의 가격은 동일합니다:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`resolution`}),_jsx(_components.th,{style:{textAlign:`right`},children:`USD/장`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`1K`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`0.015`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`2K`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`0.020`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`4K`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`0.025`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`세 가격 모두 `,_jsx(_components.code,{children:`low`}),`, `,_jsx(_components.code,{children:`medium`}),`, `,_jsx(_components.code,{children:`high`}),`, `,_jsx(_components.code,{children:`xhigh`}),`, `,_jsx(_components.code,{children:`max`}),` 에 적용됩니다. 현재 참조 이미지 입력에는 별도의 장당 요금이 없습니다. 계정별 전용 가격이나 할인은 다를 수 있으며 최신 가격은 `,_jsx(_components.a,{href:`https://toapis.com/pricing`,children:`모델 가격 페이지`}),` 와 계정 실제 설정을 기준으로 하세요.`]}),`\n`,_jsx(Heading,{level:`2`,id:`vip-버전과의-차이`,children:`VIP 버전과의 차이`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`항목`}),_jsx(_components.th,{children:`일반 버전`}),_jsx(_components.th,{children:`VIP 버전`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`모델명`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`-vip`}),` 없음`]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`-vip`}),` 포함`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`작업 방식`}),_jsx(_components.td,{children:`비동기 작업이며 작업 ID로 이미지 URL 조회`}),_jsx(_components.td,{children:`비동기 작업이며 작업 ID로 이미지 URL 조회`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`size`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`16:9`}),` 처럼 비율 권장`]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`1536x1024`}),` 처럼 픽셀 크기`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`resolution`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`1K`}),`, `,_jsx(_components.code,{children:`2K`}),`, `,_jsx(_components.code,{children:`4K`})]}),_jsx(_components.td,{children:`생략하고 size 로 크기 표현`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`과금`}),_jsx(_components.td,{children:`resolution 에 해당하는 장당 가격`}),_jsx(_components.td,{children:`실제 텍스트와 이미지 token 기준`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`참조 이미지`}),_jsx(_components.td,{children:`생성 API 에 참조 이미지 URL 입력`}),_jsx(_components.td,{children:`편집 API 에 이미지 파일 업로드`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`VIP 로 전환할 때는 모델명과 파라미터를 함께 조정하세요. 자세한 내용은 `,_jsx(_components.a,{href:`/docs/ko/api-reference/images/gpt-image-2.5-vip/generation`,children:`GPT-Image-2.5 VIP`}),` 를 참고하세요.`]})]})}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":{"config":{},"pageMetadata":{"title":"GPT-Image-2.5 이미지 생성","sidebarTitle":"GPT-Image-2.5","api":"POST https://toapis.com/v1/images/generations","description":"gpt-image-2.5-flare 와 gpt-image-2.5-sunburst 일반 버전 연동 가이드로, 비동기 작업, 참조 이미지, 투명 배경, 고정 high 품질과 해상도별 과금을 다룹니다","href":"/docs/ko/api-reference/images/gpt-image-2.5/generation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"빠른 시작","slug":"빠른-시작","depth":2,"children":[]},{"title":"Body","slug":"body","depth":2,"children":[]},{"title":"투명 배경","slug":"투명-배경","depth":2,"children":[]},{"title":"비율과 해상도 예시","slug":"비율과-해상도-예시","depth":2,"children":[]},{"title":"참조 이미지 생성","slug":"참조-이미지-생성","depth":2,"children":[]},{"title":"가격","slug":"가격","depth":2,"children":[]},{"title":"VIP 버전과의 차이","slug":"vip-버전과의-차이","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"GPT-Image-2.5 이미지 생성","path":"/v1/images/generations","servers":[{"url":"https://toapis.com"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{"Authorization":{"schema":[{"type":"string","description":"`Bearer YOUR_TOAPIS_API_KEY` 로 인증합니다.","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"model":[{"type":"string","description":"`gpt-image-2.5-flare` 또는 `gpt-image-2.5-sunburst` .","required":true}],"prompt":[{"type":"string","description":"이미지 설명입니다. 참조 이미지를 사용할 때는 유지할 대상과 수정할 내용을 설명에 담아야 합니다.","required":true}],"quality":[{"type":"string","description":"현재 일반 버전은 `high` 로 고정되어 있어 이 파라미터를 생략할 수 있습니다. 다른 문자열 값을 전달하면 무시되고 `high` 가 사용됩니다. Playground 는 품질 옵션을 표시하지 않습니다. 현재 일반 버전은 resolution 을 기준으로 요금이 책정됩니다."}],"size":[{"type":"string","description":"화면 비율입니다. 예: `1:1` , `3:2` , `2:3` , `4:3` , `3:4` , `5:4` , `4:5` , `16:9` , `9:16` , `21:9` . 비율을 사용하고 resolution 을 명시적으로 입력하는 것을 권장합니다. 서버는 두 값을 기준으로 출력 픽셀 크기를 계산합니다. 일반 버전의 비율 표기 방식은 VIP 버전의 픽셀 크기 표기 방식과 다릅니다."}],"resolution":[{"type":"string","description":"해상도 등급으로 `1K` , `2K` , `4K` 를 지원하고 소문자 형식도 허용합니다. 이 필드가 일반 버전의 과금 등급을 결정합니다."}],"background":[{"type":"string","description":"선택적 배경 매개변수입니다. `\"transparent\"` 를 지정하면 투명 배경 이미지를 생성합니다. 생략하면 일반 이미지를 생성합니다. 텍스트 기반 생성과 `reference_images` 가 포함된 요청 모두에 사용할 수 있습니다."}],"n":[{"type":"integer","description":"요청당 `1` 을 사용해 이미지 한 장을 생성합니다."}],"reference_images":[{"type":"array","items":[{"type":"string"}],"description":"이미지 투 이미지 생성을 위한 선택 사항인 참조 이미지 URL 목록입니다. 이미지 주소는 서버에서 접근할 수 있어야 합니다. 이미지 URL 만 지원하며 로컬 파일 업로드와 base64 는 지원하지 않습니다. 로컬 이미지는 먼저 Upload 이미지 API 로 업로드해 URL 을 받으세요. `image_urls` 도 호환됩니다. 둘 중 하나의 필드만 사용하세요."}]}}],"examples":{"example":{"value":{"model":"\u003cstring>","prompt":"\u003cstring>","quality":"\u003cstring>","size":"\u003cstring>","resolution":"\u003cstring>","background":"\u003cstring>","n":123,"reference_images":["\u003cstring>"]}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"dashlyai","siteName":"ToAPIs Documentation","title":"GPT-Image-2.5 이미지 생성 - ToAPIs Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"cn":{"href":"/docs/cn/api-reference/images/gpt-image-2.5/generation","matchLevel":1},"zh-Hant":{"href":"/docs/zh-Hant/api-reference/images/gpt-image-2.5/generation","matchLevel":1},"en":{"href":"/docs/en/api-reference/images/gpt-image-2.5/generation","matchLevel":1},"ja":{"href":"/docs/ja/api-reference/images/gpt-image-2.5/generation","matchLevel":1},"ko":{"href":"/docs/ko/api-reference/images/gpt-image-2.5/generation","matchLevel":0},"ru":{"href":"/docs/ru/api-reference/images/gpt-image-2.5/generation","matchLevel":1}}},"lastModified":"2026-09-11T09:06:25.096Z","originalFileLocation":"docs/ko/api-reference/images/gpt-image-2.5/generation.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=\"gpt-image-2.5-flare 와 gpt-image-2.5-sunburst 일반 버전 연동 가이드로, 비동기 작업, 참조 이미지, 투명 배경, 고정 high 품질과 해상도별 과금을 다룹니다\">\u003cmeta data-mint-head name=\"application-name\" content=\"ToAPIs Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dashlyai/hXpIH8Ru6pZfB7RW/_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/dashlyai/hXpIH8Ru6pZfB7RW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dashlyai/hXpIH8Ru6pZfB7RW/_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/dashlyai/hXpIH8Ru6pZfB7RW/_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/dashlyai/hXpIH8Ru6pZfB7RW/_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/dashlyai/hXpIH8Ru6pZfB7RW/_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/dashlyai/hXpIH8Ru6pZfB7RW/_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/dashlyai/hXpIH8Ru6pZfB7RW/_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/dashlyai/hXpIH8Ru6pZfB7RW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"GPT-Image-2.5 이미지 생성 - ToAPIs Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"gpt-image-2.5-flare 와 gpt-image-2.5-sunburst 일반 버전 연동 가이드로, 비동기 작업, 참조 이미지, 투명 배경, 고정 high 품질과 해상도별 과금을 다룹니다\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ToAPIs Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.toapis.com/docs/ko/api-reference/images/gpt-image-2.5/generation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.toapis.com/docs/assets/images/og-default.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=\"GPT-Image-2.5 이미지 생성 - ToAPIs Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"gpt-image-2.5-flare 와 gpt-image-2.5-sunburst 일반 버전 연동 가이드로, 비동기 작업, 참조 이미지, 투명 배경, 고정 high 품질과 해상도별 과금을 다룹니다\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.toapis.com/docs/assets/images/og-default.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=\"/mintlify-assets/_mintlify/favicons/dashlyai/hXpIH8Ru6pZfB7RW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ToAPIs Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.toapis.com/docs/ko/api-reference/images/gpt-image-2.5/generation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/ko/api-reference/images/gpt-image-2.5/generation.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.toapis.com/docs/ko/api-reference/images/gpt-image-2.5/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.toapis.com/docs/cn/api-reference/images/gpt-image-2.5/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hant\" href=\"https://docs.toapis.com/docs/zh-Hant/api-reference/images/gpt-image-2.5/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.toapis.com/docs/en/api-reference/images/gpt-image-2.5/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.toapis.com/docs/ja/api-reference/images/gpt-image-2.5/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.toapis.com/docs/ru/api-reference/images/gpt-image-2.5/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.toapis.com/docs/cn/api-reference/images/gpt-image-2.5/generation\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.toapis.com/#organization\",\"name\":\"ToAPIs Documentation\",\"url\":\"https://docs.toapis.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dashlyai/a_NCjmRocEr6wT0r/logo/light.svg?fit=max\u0026auto=format\u0026n=a_NCjmRocEr6wT0r\u0026q=85\u0026s=3d58ff2776a33f0fb61c09a496c32cde\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.toapis.com#website\",\"name\":\"ToAPIs Documentation\",\"url\":\"https://docs.toapis.com\",\"publisher\":{\"@id\":\"https://docs.toapis.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.toapis.com/docs/ko/api-reference/images/gpt-image-2.5/generation#webpage\",\"url\":\"https://docs.toapis.com/docs/ko/api-reference/images/gpt-image-2.5/generation\",\"name\":\"GPT-Image-2.5 이미지 생성\",\"description\":\"gpt-image-2.5-flare 와 gpt-image-2.5-sunburst 일반 버전 연동 가이드로, 비동기 작업, 참조 이미지, 투명 배경, 고정 high 품질과 해상도별 과금을 다룹니다\",\"dateModified\":\"2026-09-11T09:06:25.096Z\",\"isPartOf\":{\"@id\":\"https://docs.toapis.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.toapis.com/docs/ko/api-reference/images/gpt-image-2.5/generation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.toapis.com/docs/ko/api-reference/images/gpt-image-2.5/generation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"이미지 API\",\"item\":\"https://docs.toapis.com/docs/ko/api-reference/images/gemini-3-pro-image/generation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GPT-Image-2.5 이미지 생성\",\"item\":\"https://docs.toapis.com/docs/ko/api-reference/images/gpt-image-2.5/generation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.toapis.com/docs/ko/api-reference/images/gpt-image-2.5/generation#apireference\",\"headline\":\"GPT-Image-2.5 이미지 생성\",\"name\":\"GPT-Image-2.5 이미지 생성\",\"description\":\"gpt-image-2.5-flare 와 gpt-image-2.5-sunburst 일반 버전 연동 가이드로, 비동기 작업, 참조 이미지, 투명 배경, 고정 high 품질과 해상도별 과금을 다룹니다\",\"url\":\"https://docs.toapis.com/docs/ko/api-reference/images/gpt-image-2.5/generation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.toapis.com/docs/ko/api-reference/images/gpt-image-2.5/generation#webpage\"},\"image\":\"https://docs.toapis.com/docs/assets/images/og-default.png\",\"dateModified\":\"2026-09-11T09:06:25.096Z\",\"publisher\":{\"@id\":\"https://docs.toapis.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.toapis.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ToAPIs Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"ToAPIs Documentation","nav":{"global":null,"languages":[{"language":"cn","pages":[{"title":"cn","href":"/docs/cn/api-reference/images/gpt-image-2.5/generation"}]},{"language":"zh-Hant","pages":[{"title":"zh-Hant","href":"/docs/zh-Hant/api-reference/images/gpt-image-2.5/generation"}]},{"language":"en","pages":[{"title":"en","href":"/docs/en/api-reference/images/gpt-image-2.5/generation"}]},{"language":"ja","pages":[{"title":"ja","href":"/docs/ja/api-reference/images/gpt-image-2.5/generation"}]},{"language":"ko","tabs":[{"tab":"API 참조","groups":[{"group":"개요","pages":[{"title":"API 매뉴얼","sidebarTitle":"API 매뉴얼","href":"/docs/ko"}]},{"group":"빠른 시작","pages":[{"title":"빠른 시작","sidebarTitle":"가이드","href":"/docs/ko/quickstart"},{"title":"Claude Code 설정 가이드","sidebarTitle":"Claude Code","href":"/docs/ko/integrations/claude-code"},{"title":"Codex 설정 가이드","sidebarTitle":"Codex","href":"/docs/ko/integrations/codex"},{"title":"ToAPIs 사용: OpenClaw","sidebarTitle":"OpenClaw","href":"/docs/ko/integrations/openclaw"},{"title":"Cherry Studio 설정 가이드","sidebarTitle":"Cherry Studio","href":"/docs/ko/integrations/cherry-studio"},{"title":"Integrations","sidebarTitle":"Integrations","href":"/docs/ko/integrations/chatbox"}]},{"group":"모델 카탈로그","pages":[{"title":"공개 모델 카탈로그","sidebarTitle":"모델 카탈로그","href":"/docs/ko/api-reference/models"}]},{"group":"채팅 API","pages":[{"title":"Supported Text 모델","sidebarTitle":"모델 List","href":"/docs/ko/api-reference/chat/models"},{"title":"List 모델","sidebarTitle":"List 모델","api":"GET https://toapis.com/v1/models","href":"/docs/ko/api-reference/chat/list-models"},{"group":"GPT-5 시리즈","pages":[{"title":"GPT-5.4 Chat","sidebarTitle":"gpt-5.4","api":"POST https://toapis.com/v1/chat/completions","href":"/docs/ko/api-reference/chat/gpt-5.4/chat"},{"title":"GPT-5.5 Chat","sidebarTitle":"gpt-5.5","api":"POST https://toapis.com/v1/chat/completions","href":"/docs/ko/api-reference/chat/gpt-5.5/chat"}]},{"group":"OpenAI 형식","pages":[{"title":"Chat Completions","sidebarTitle":"Chat Completions API","api":"POST https://toapis.com/v1/chat/completions","href":"/docs/ko/api-reference/chat/chat"}]},{"group":"Anthropic 형식","pages":[{"title":"Anthropic Messages API","sidebarTitle":"POST /v1/messages","api":"POST https://toapis.com/v1/messages","href":"/docs/ko/api-reference/chat/messages"}]},{"group":"Responses 형식","pages":[{"title":"응답s API","sidebarTitle":"응답s API","api":"POST https://toapis.com/v1/responses","href":"/docs/ko/api-reference/chat/responses"}]}]},{"group":"이미지 API","pages":[{"group":"Gemini-3-Pro-Image-preview (Nano banana2)","pages":[{"title":"Gemini-3-Pro 이미지 생성","sidebarTitle":"Gemini-3-Pro-Image","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gemini-3-pro-image/generation"}]},{"group":"Gemini-3-Pro-Image VIP","pages":[{"title":"Gemini 3 Pro Image VIP 이미지 생성","sidebarTitle":"VIP","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gemini-3-pro-image-vip/generation"}]},{"group":"Gemini Nano Banana 2.1","pages":[{"title":"Gemini Nano Banana 2.1 이미지 생성","sidebarTitle":"이미지 생성","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gemini-nano-banana-2.1/generation"},{"title":"Gemini Nano Banana 2.1 Official 이미지 생성","sidebarTitle":"Official","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gemini-nano-banana-2.1-official/generation"}]},{"group":"Gemini-3.1-Flash-Image-preview (Nano banana2)","pages":[{"title":"Gemini-3.1-Flash 이미지 생성","sidebarTitle":"Gemini-3.1-Flash-Image","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gemini-3.1-flash/generation"}]},{"group":"Gemini-3.1-Flash-Image VIP","pages":[{"title":"Gemini 3.1 Flash Image VIP 이미지 생성","sidebarTitle":"VIP","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gemini-3.1-flash-vip/generation"}]},{"group":"Gemini-2.5-Flash-Image-preview (Nano banana)","pages":[{"title":"Gemini-2.5-Flash 이미지 생성","sidebarTitle":"Gemini-2.5-Flash-Image","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gemini-2.5-flash/generation"}]},{"group":"Gemini-3-Pro-Image Official / Nano Banana Pro","pages":[{"title":"Gemini-3-Pro Official 이미지 생성","sidebarTitle":"Gemini-3-Pro-Image Official","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gemini-3-pro-image-official/generation"}]},{"group":"gemini-3.1-flash-image-official","pages":[{"title":"Gemini-3.1-Flash Official 이미지 생성","sidebarTitle":"Gemini-3.1-Flash-Image Official","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gemini-3.1-flash-official/generation"}]},{"group":"Gemini-2.5-Flash-Image Official","pages":[{"title":"Gemini-2.5-Flash Official 이미지 생성","sidebarTitle":"Gemini-2.5-Flash-Image Official","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gemini-2.5-flash-official/generation"}]},{"group":"GPT-4o-image","pages":[{"title":"GPT-4o 이미지 생성","sidebarTitle":"GPT-4o-image","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gpt-4o/generation"}]},{"group":"GPT-Image-2","pages":[{"title":"GPT-Image-2 이미지 생성","sidebarTitle":"gpt-image-2","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gpt-image-2/generation"},{"title":"GPT-Image-2 Official Channel 이미지 생성","sidebarTitle":"gpt-image-2-official","api":"POST https://toapis.com/v1/images/generations","description":"Generate images with the official OpenAI gpt-image-2-official model — text-to-image, image-to-image, and inpainting (mask) in one API, with 1K / 2K / 4K resolution tiers","href":"/docs/ko/api-reference/images/gpt-image-2/official"}]},{"group":"GPT-Image-2.5","pages":[{"title":"GPT-Image-2.5 이미지 생성","sidebarTitle":"GPT-Image-2.5","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gpt-image-2.5/generation"},{"title":"GPT-Image-2.5 VIP 이미지 생성과 편집","sidebarTitle":"GPT-Image-2.5 VIP","api":"POST https://toapis.com/v1/images/generations","description":"gpt-image-2.5-flare-vip 와 gpt-image-2.5-sunburst-vip 비동기 이미지 작업 연동 가이드로, 6단계 품질, 픽셀 크기, 투명 배경과 실제 token 기준 후불 과금을 다룹니다","href":"/docs/ko/api-reference/images/gpt-image-2.5-vip/generation"},{"title":"GPT-Image-2.5 공식 채널 이미지 생성","sidebarTitle":"GPT-Image-2.5 Official","api":"POST https://api.toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gpt-image-2.5-official/generation"}]},{"group":"GPT-Image-2-VIP","pages":[{"title":"GPT-Image-2-VIP 이미지 생성","sidebarTitle":"gpt-image-2-vip","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/gpt-image-2-vip/generation"}]},{"group":"Qwen Image 3.0","pages":[{"title":"Qwen Image 3.0 이미지 생성","sidebarTitle":"Qwen Image 3.0 / Pro","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/qwen-image-3.0/generation"}]},{"group":"Flux Kontext","pages":[{"title":"Flux Kontext 이미지 생성","sidebarTitle":"Flux Kontext","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/flux-kontext/generation"}]},{"group":"Flux 2.0","pages":[{"title":"Flux 2.0 이미지 생성","sidebarTitle":"Flux 2.0","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/flux-2/generation"}]},{"group":"Seedream-4.0","pages":[{"title":"Seedream-4.0 이미지 생성","sidebarTitle":"Seedream-4.0","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/seedream-4.0/generation"}]},{"group":"Seedream-4.5","pages":[{"title":"Seedream-4.5 이미지 생성","sidebarTitle":"Seedream-4.5","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/seedream-4.5/generation"}]},{"group":"Seedream-5.0","pages":[{"title":"Seedream-5.0 이미지 생성","sidebarTitle":"Seedream-5.0","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/seedream-5.0/generation"}]},{"group":"Seedream-5.0-Pro","pages":[{"title":"Seedream-5.0-Pro 이미지 생성","sidebarTitle":"Seedream-5.0-Pro","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/seedream-5.0-pro/generation"}]},{"group":"Grok Image","pages":[{"title":"Grok 이미지 생성","sidebarTitle":"Grok Image","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/grok-image/generation"}]},{"group":"Grok Imagine 1.0","pages":[{"title":"Grok Imagine 1.0 이미지 생성","sidebarTitle":"Generation","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/grok-imagine-1.0/generation"},{"title":"Grok Imagine 1.0 Image Editing","sidebarTitle":"Edits","api":"POST https://toapis.com/v1/images/edits","href":"/docs/ko/api-reference/images/grok-imagine-1.0/edits"}]},{"group":"Vidu Image","pages":[{"title":"Vidu Image Generation","sidebarTitle":"Vidu Image","api":"POST https://toapis.com/v1/images/generations","href":"/docs/ko/api-reference/images/vidu-image/generation"}]}]},{"group":"비디오 API","pages":[{"group":"doubao-seedance-1-0-pro","pages":[{"title":"Doubao SeeDance 비디오 생성","sidebarTitle":"doubao-seedance","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/doubao-seedance/generation"}]},{"group":"doubao-seedance-1-5-pro","pages":[{"title":"Doubao SeeDance 1.5 Pro 비디오 생성","sidebarTitle":"doubao-seedance-1-5-pro","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/doubao-seedance-1-5/generation"}]},{"group":"Seedance 가격표","pages":[{"title":"Volcano Ark 동영상 생성 모델 가격표","sidebarTitle":"Seedance 가격표","href":"/docs/ko/api-reference/videos/seedance/pricing"}]},{"group":"seedance-2","pages":[{"title":"seedance-2 비디오 생성","sidebarTitle":"seedance-2","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/seedance-2/generation"}]},{"group":"seedance-2-5","pages":[{"title":"Seedance 2.5 동영상 생성","sidebarTitle":"Seedance 2.5","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/seedance-2-5/generation"},{"title":"Seedance 2.5 드래프트 모드","sidebarTitle":"드래프트 모드","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/seedance-2-5/draft"}]},{"group":"seedance-ext","pages":[{"title":"seedance-2.5-ext 비디오 생성","sidebarTitle":"seedance-2.5-ext","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/seedance-2-5-ext/generation"},{"title":"seedance-2-ext 비디오 생성","sidebarTitle":"seedance-2-ext","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/seedance-2-ext/generation"},{"title":"seedance-2-fast-ext 비디오 생성","sidebarTitle":"seedance-2-fast-ext","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/seedance-2-fast-ext/generation"}]},{"group":"HappyHorse","pages":[{"title":"HappyHorse 1.1 비디오 생성","sidebarTitle":"happyhorse-1.1","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/happyhorse/generation"}]},{"group":"Sora2","pages":[{"title":"Sora2 VVIP 비디오 생성","sidebarTitle":"Sora2 VVIP","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/sora2/generation"},{"title":"Sora2 Create Character","sidebarTitle":"Create Character","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/sora2/create-persona"},{"title":"Sora2 Query Character 상태","sidebarTitle":"Query Character 상태","api":"GET https://toapis.com/v1/characters_tasks/{task_id}","href":"/docs/ko/api-reference/videos/sora2/get-personas"},{"title":"Sora2 Video Remix","sidebarTitle":"Video Remix","api":"POST https://toapis.com/v1/videos/{video_id}/remix","href":"/docs/ko/api-reference/videos/sora2/remix"}]},{"group":"Sora 2 Official (Azure)","pages":[{"title":"Azure Sora 2 비디오 생성","sidebarTitle":"Sora 2 Official","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/sora-2-official/generation"},{"title":"Azure Sora 2 Remix","sidebarTitle":"Remix","api":"POST https://toapis.com/v1/videos/{video_id}/remix","href":"/docs/ko/api-reference/videos/sora-2-official/remix"}]},{"group":"Veo3","pages":[{"title":"Veo3 비디오 생성","sidebarTitle":"Veo3","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/veo3/generation"}]},{"group":"Gemini Omni Flash","pages":[{"title":"Gemini Omni Flash 비디오 생성","sidebarTitle":"Gemini Omni Flash","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/gemini-omni-flash/generation"},{"title":"Gemini Omni 1.1 일반","sidebarTitle":"Omni 1.1 일반","api":"POST https://toapis.com/v1/videos","href":"/docs/ko/api-reference/videos/gemini-omni-flash/generation-1-1"},{"title":"Gemini Omni 1.1 VIP","sidebarTitle":"Omni 1.1 VIP","api":"POST https://toapis.com/v1/videos","href":"/docs/ko/api-reference/videos/gemini-omni-flash/generation-1-1-vip"}]},{"group":"Gemini Omni Official","pages":[{"title":"Gemini Omni Flash 비디오 생성","sidebarTitle":"Gemini Omni Flash Preview Official","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/gemini-omni-flash-preview-official/generation"},{"title":"Gemini Omni 1.1 동영상 생성 및 편집","sidebarTitle":"Gemini Omni 1.1 Flash Preview Official","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/gemini-omni-1.1-flash-preview-official/generation"}]},{"group":"Veo3 Official (including Veo3.1 Lite)","pages":[{"title":"Veo3 Official 비디오 생성","sidebarTitle":"Veo3 Official","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/veo3-official/generation"}]},{"group":"MiniMax-Hailuo-02","pages":[{"title":"MiniMax-Hailuo-02 비디오 생성","sidebarTitle":"MiniMax-Hailuo-02","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/minimax-hailuo/generation"}]},{"group":"Wan 3.0","pages":[{"title":"Wan 3.0 올인원 비디오 생성","sidebarTitle":"Wan 3.0","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/wan3.0/generation"}]},{"group":"Wan2.6","pages":[{"title":"Wan2.6 비디오 생성","sidebarTitle":"Wan2.6","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/wan2.6/generation"},{"title":"Wan2.6 Flash 비디오 생성","sidebarTitle":"Wan2.6 Flash","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/wan2.6-flash/generation"}]},{"group":"Kling v2.6","pages":[{"title":"Kling v2.6 비디오 생성","sidebarTitle":"Kling v2.6","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/kling-2-6/generation"}]},{"group":"Kling v3","pages":[{"title":"Kling v3 비디오 생성","sidebarTitle":"Kling v3","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/kling-v3/generation"}]},{"group":"kling-3.0-turbo","pages":[{"title":"kling-3.0-turbo 비디오 생성","sidebarTitle":"kling-3.0-turbo","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/kling-3.0-turbo/generation"}]},{"group":"Kling v3 Omni","pages":[{"title":"Kling v3 Omni 비디오 생성","sidebarTitle":"Kling v3 Omni","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/kling-v3-omni/generation"}]},{"group":"Kling v4","pages":[{"title":"Kling v4 동영상 생성","sidebarTitle":"Kling v4","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/kling-4.0/generation"}]},{"group":"Kling Video O1","pages":[{"title":"Kling Video O1 비디오 생성","sidebarTitle":"Kling Video O1","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/kling-video-o1/generation"}]},{"group":"MiniMax-Hailuo-2.3","pages":[{"title":"MiniMax-Hailuo-2.3 비디오 생성","sidebarTitle":"MiniMax-Hailuo-2.3","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/minimax-hailuo-2.3/generation"}]},{"group":"MiniMax-H3","pages":[{"title":"MiniMax Hailuo H3 비디오 생성","sidebarTitle":"MiniMax-H3","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/minimax-h3/generation"}]},{"group":"Vidu Q3","pages":[{"title":"Vidu Q3 비디오 생성","sidebarTitle":"Vidu Q3","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/viduq3/generation"},{"title":"Vidu Q3 비디오 생성","sidebarTitle":"Vidu Q3 (멀티 모델)","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/vidu-ali/generation"}]},{"group":"Vidu Q4 Preview","pages":[{"title":"Vidu Q4 Preview 비디오 생성","sidebarTitle":"Vidu Q4 Preview","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/viduq4-preview/generation"}]},{"group":"Grok Video","pages":[{"title":"Grok Video 1.5 동영상 생성","sidebarTitle":"Grok Video 1.5","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/grok-video-1.5/generation"},{"title":"Grok 비디오 생성","sidebarTitle":"Grok Video","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/grok-video/generation"},{"title":"Grok Video Remix","sidebarTitle":"Video Remix","api":"POST https://toapis.com/v1/videos/{video_id}/remix","href":"/docs/ko/api-reference/videos/grok-video/remix"},{"title":"Grok Video Extend","sidebarTitle":"Video Extend","api":"POST https://toapis.com/v1/videos/{video_id}/extend","href":"/docs/ko/api-reference/videos/grok-video/extend"}]},{"group":"Grok Imagine Video (Official)","pages":[{"title":"Grok Imagine Video 동영상 생성 (공식 채널)","sidebarTitle":"Grok Imagine Video","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/grok-imagine-video-official/generation"},{"title":"Grok Imagine Video Extend (공식 채널)","sidebarTitle":"Video Extend","api":"POST https://toapis.com/v1/videos/{video_id}/extend","href":"/docs/ko/api-reference/videos/grok-imagine-video-official/extend"},{"title":"Grok Imagine Video 1.5 동영상 생성 (공식 채널)","sidebarTitle":"Grok Imagine Video 1.5","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/ko/api-reference/videos/grok-imagine-video-1.5-official/generation"}]}]},{"group":"음악 API","pages":[{"group":"Suno 음악","pages":[{"title":"Suno 음악 생성","sidebarTitle":"개요 및 가격","href":"/docs/ko/api-reference/audios/suno/overview"},{"title":"음악 생성","sidebarTitle":"음악 생성","api":"POST https://toapis.com/v1/music/generations/generation","href":"/docs/ko/api-reference/audios/suno/generation"},{"title":"연장과 업로드","sidebarTitle":"연장과 업로드","api":"POST https://toapis.com/v1/music/generations/extend","href":"/docs/ko/api-reference/audios/suno/upload-extend"},{"title":"편집과 변환","sidebarTitle":"편집과 변환","api":"POST https://toapis.com/v1/music/generations/crop","href":"/docs/ko/api-reference/audios/suno/edit"},{"title":"스템 분리와 트랙 추가","sidebarTitle":"스템과 트랙","api":"POST https://toapis.com/v1/music/generations/stems","href":"/docs/ko/api-reference/audios/suno/stems"},{"title":"가사 / 영감 / 효과음 / 태그","sidebarTitle":"보조 생성","api":"POST https://toapis.com/v1/music/generations/lyrics","href":"/docs/ko/api-reference/audios/suno/create-extras"},{"title":"분석과보내기","sidebarTitle":"분석과보내기","api":"POST https://toapis.com/v1/music/generations/midi","href":"/docs/ko/api-reference/audios/suno/analysis"},{"title":"에셋 작업","sidebarTitle":"에셋","api":"POST https://toapis.com/v1/music/generations/persona","href":"/docs/ko/api-reference/audios/suno/assets"}]}]},{"group":"작업 관리","pages":[{"title":"Get Image Task 상태","sidebarTitle":"Get Image Task 상태","api":"GET https://toapis.com/v1/images/generations/{task_id}","href":"/docs/ko/api-reference/tasks/image-status"},{"title":"Get Video Task 상태","sidebarTitle":"Get Video Task 상태","api":"GET https://toapis.com/v1/videos/generations/{task_id}","href":"/docs/ko/api-reference/tasks/video-status"},{"title":"비동기 작업 Webhook","href":"/docs/ko/api-reference/webhooks/task-webhooks"},{"title":"비동기 작업 속도 제한","href":"/docs/ko/api-reference/rate-limits/async-tasks"},{"group":"음악 태스크 상태 조회","pages":[{"title":"음악 태스크 상태 조회","sidebarTitle":"음악 태스크 상태 조회","api":"GET https://toapis.com/v1/music/tasks/{task_id}","href":"/docs/ko/api-reference/tasks/music-status"}]}]},{"group":"파일 업로드","pages":[{"title":"Upload Image","sidebarTitle":"Upload Image","api":"POST https://toapis.com/v1/uploads/images","href":"/docs/ko/api-reference/uploads/images"},{"title":"Upload Video","sidebarTitle":"Upload Video","api":"POST https://toapis.com/v1/uploads/videos","href":"/docs/ko/api-reference/uploads/videos"},{"title":"오디오 업로드","sidebarTitle":"오디오 업로드","api":"POST https://toapis.com/v1/uploads/audios","href":"/docs/ko/api-reference/uploads/audios"}]},{"group":"계정","pages":[{"title":"토큰 잔액 조회","sidebarTitle":"토큰 잔액 조회","api":"GET https://toapis.com/v1/balance","href":"/docs/ko/api-reference/account/token-balance"},{"title":"토큰 사용량 조회","sidebarTitle":"토큰 사용량 조회","api":"GET https://toapis.com/api/usage/tokens/requests","href":"/docs/ko/api-reference/account/token-usage"},{"title":"사용자 잔액 조회","sidebarTitle":"사용자 잔액 조회","api":"GET https://toapis.com/v1/user/balance","href":"/docs/ko/api-reference/account/user-balance"},{"title":"가격 및 실제 청구 금액","sidebarTitle":"가격 및 실제 청구 금액","api":"GET https://toapis.com/v1/pricing","href":"/docs/ko/api-reference/account/pricing"},{"title":"API 토큰 생성","sidebarTitle":"Create Token","api":"POST https://toapis.com/v1/tokens","href":"/docs/ko/api-reference/account/create-token"}]},{"group":"자주 묻는 질문","pages":[{"title":"자주 묻는 질문","sidebarTitle":"자주 묻는 질문","href":"/docs/ko/faqs"}]}]}]},{"language":"ru","pages":[{"title":"ru","href":"/docs/ru/api-reference/images/gpt-image-2.5/generation"}]}]},"title":"GPT-Image-2.5 이미지 생성 - ToAPIs Documentation","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js"]}