Async task guide for gpt-image-2.5-flare-vip and gpt-image-2.5-sunburst-vip, with six quality levels, pixel dimensions, transparent backgrounds, and postpaid billing by actual token usage
The VIP tier creates an image task through POST /v1/images/generations and returns a task ID. After the task finishes, retrieve the image URL through the status endpoint. Like the standard tier, the VIP tier runs as an async task; the differences are the model names, the size format, and the billing model.
Model
model in the request
Flare VIP
gpt-image-2.5-flare-vip
Sunburst VIP
gpt-image-2.5-sunburst-vip
gpt-image-2.5-vip is the series name used in this document. Always pass the full model name from the table.
The standard tier also runs as an async task, but it is priced by resolution and uses ratio values for size; see the separate GPT-Image-2.5 documentation. The VIP tier uses pixel dimensions and settles by actual token usage.
Note for users in mainland China: Please use https://toapis.cn as the API endpoint (Base URL). Replace https://toapis.com with https://toapis.cn in the examples in this document.
A task moves through pending, queued, and in_progress, and finally reaches completed or failed. On completed, read the image URL from result.data; on failed, read error. Poll every few seconds. The full set of fields is documented in Image Task Status.A successful submit only means the task was created. Wait until completed before downloading the image, and keep polling the same task ID while you wait. High-quality requests take longer, so keep polling instead of resubmitting.
Six levels are supported: auto, low, medium, high, xhigh, and max. The default is high. Use lowercase values. With auto, the upstream model selects the quality level for each request.Quality affects the generation result and the actual output tokens. Images with the same quality can still cost different amounts depending on dimensions and content.
Output pixel dimensions in widthxheight format, for example 1024x1024, 1536x1024, 1024x1536, 1280x1024.Custom pixel dimensions allowed by the upstream provider are supported, not only the examples above. The valid size range is enforced by the endpoint validation. VIP examples do not use ratio values such as 1:1, and no separate resolution is required.Custom pixel dimensions must match one of the following aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9.
Optional background setting. Set "transparent" to generate an image with a transparent background. Omit this field for normal image generation.Works with both text-to-image requests and reference image editing.
Optional list of reference image URLs for image-to-image generation. The images must be reachable by the server. Only image URLs are supported: local file uploads and base64 images are not accepted. For local images, obtain a URL first through the Upload Image API.image_urls is also accepted. Use one of the two fields. Passing reference image URLs to the generation endpoint triggers image-to-image generation.
Editing uses POST /v1/images/edits with a multipart/form-data request. Async editing supports image URLs only: put the URL in the image field and pass model, prompt, quality, size, and n alongside it. Local file uploads and base64 images are not supported. Editing is also an async task: the submit returns a task ID, and you query the result the same way as generation.The example below uses Sunburst VIP to add a yellow scarf to the baby otter in the reference image. Replace the example URL with your own image URL:
curl --fail-with-body --request POST \ --url https://toapis.com/v1/images/edits \ --header "Authorization: Bearer $TOAPIS_API_KEY" \ --form 'model=gpt-image-2.5-sunburst-vip' \ --form 'prompt=Keep the baby otter and the veterinarian from the original image, and add a yellow scarf to the baby otter' \ --form 'image=https://example.com/otter.png' \ --form 'quality=low' \ --form 'size=1024x1024' \ --form 'n=1'
Let curl set the multipart Content-Type and boundary automatically. Poll the status endpoint with the returned task ID and read the edited image URL from result.data.Flare VIP supports the same editing approach; change the model to gpt-image-2.5-flare-vip. Reference image input incurs image input token costs.
The prices below are standard prices verified on 2026-09-09. Both VIP models are the same and are billed at 20% off the official token unit prices:
Type
USD per million tokens
Text input
4.00
Cached text input
1.00
Image input
6.40
Cached image input
1.60
Image output
24.00
All six quality levels share these token unit prices. VIP has no fixed per-image price tied to quality; the task is settled by actual usage after it completes. Submitting a task pre-authorizes an amount, and the final charge is settled from the actual text and image tokens after completion, with any difference refunded or charged. You still need sufficient account balance and API Key quota before calling.Cost formula, in USD:
For example, a low quality 1024x1024 text-to-image request with 27 text input tokens and 196 image output tokens costs:
(27 * 4 + 196 * 24) / 1,000,000 = $0.004812
One measured reference image edit contained 21 text input tokens, 1024 image input tokens, and 196 image output tokens. The formula gives $0.0113416, which is charged as $0.011342 after rounding to the smallest platform quota unit. These are examples for specific requests and do not represent a fixed cost per image at the same quality.Account-specific pricing or discounts may differ; check the model pricing page and your account configuration for the latest prices. You can verify the final charge in the usage logs.
{"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/en/api-reference/images/gpt-image-2.5-vip/generation","slug":"/docs/en/api-reference/images/gpt-image-2.5-vip/generation","pageMetadata":{"title":"GPT-Image-2.5 VIP Image Generation and Editing","sidebarTitle":"GPT-Image-2.5 VIP","api":"POST https://toapis.com/v1/images/generations","description":"Async task guide for gpt-image-2.5-flare-vip and gpt-image-2.5-sunburst-vip, with six quality levels, pixel dimensions, transparent backgrounds, and postpaid billing by actual token usage","href":"/docs/en/api-reference/images/gpt-image-2.5-vip/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: \"Async task guide for gpt-image-2.5-flare-vip and gpt-image-2.5-sunburst-vip, with six quality levels, pixel dimensions, transparent backgrounds, and postpaid billing by actual token usage\"\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`,li:`li`,ol:`ol`,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:[`The VIP tier creates an image task through `,_jsx(_components.code,{children:`POST /v1/images/generations`}),` and returns a task ID. After the task finishes, retrieve the image URL through the status endpoint. Like the standard tier, the VIP tier runs as an async task; the differences are the model names, the `,_jsx(_components.code,{children:`size`}),` format, and the billing model.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Model`}),_jsxs(_components.th,{children:[_jsx(_components.code,{children:`model`}),` in the request`]})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Flare VIP`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`gpt-image-2.5-flare-vip`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Sunburst VIP`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`gpt-image-2.5-sunburst-vip`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`gpt-image-2.5-vip`}),` is the series name used in this document. Always pass the full model name from the table.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The standard tier also runs as an async task, but it is priced by resolution and uses ratio values for `,_jsx(_components.code,{children:`size`}),`; see the separate `,_jsx(_components.a,{href:`/docs/en/api-reference/images/gpt-image-2.5/generation`,children:`GPT-Image-2.5 documentation`}),`. The VIP tier uses pixel dimensions and settles by actual token usage.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Note for users in mainland China:`}),` Please use `,_jsx(_components.code,{children:`https://toapis.cn`}),` as the API endpoint (Base URL). Replace `,_jsx(_components.code,{children:`https://toapis.com`}),` with `,_jsx(_components.code,{children:`https://toapis.cn`}),` in the examples in this document.`]})}),`\n`,_jsxs(_components.p,{children:[`Create an API Key in the `,_jsx(_components.a,{href:`https://toapis.com/dashboard`,children:`ToAPIs console`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`quick-start`,children:`Quick Start`}),`\n`,_jsxs(_components.p,{children:[`Set your API Key as the `,_jsx(_components.code,{children:`TOAPIS_API_KEY`}),` environment variable, then submit the task:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,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:`11`,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-vip\",`})}),`\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\": \"low\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"size\": \"1024x1024\",`})}),`\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:`Example submit response:`}),`\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-vip\"`}),_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:[`Save the returned `,_jsx(_components.code,{children:`id`}),`, replace `,_jsx(_components.code,{children:`TASK_ID`}),` below with that value, and query the result:`]}),`\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:[`A task moves through `,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`queued`}),`, and `,_jsx(_components.code,{children:`in_progress`}),`, and finally reaches `,_jsx(_components.code,{children:`completed`}),` or `,_jsx(_components.code,{children:`failed`}),`. On `,_jsx(_components.code,{children:`completed`}),`, read the image URL from `,_jsx(_components.code,{children:`result.data`}),`; on `,_jsx(_components.code,{children:`failed`}),`, read `,_jsx(_components.code,{children:`error`}),`. Poll every few seconds. The full set of fields is documented in `,_jsx(_components.a,{href:`/docs/en/api-reference/tasks/image-status`,children:`Image Task Status`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`A successful submit only means the task was created. Wait until `,_jsx(_components.code,{children:`completed`}),` before downloading the image, and keep polling the same task ID while you wait. High-quality requests take longer, so keep polling instead of resubmitting.`]}),`\n`,_jsx(Heading,{level:`2`,id:`generation-request-parameters`,children:`Generation Request Parameters`}),`\n`,_jsx(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsxs(_components.p,{children:[`Authenticate with `,_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-vip`}),` or `,_jsx(_components.code,{children:`gpt-image-2.5-sunburst-vip`}),`.`]})}),`\n`,_jsx(ParamField,{body:`prompt`,type:`string`,required:true,id:`param-prompt`,children:_jsx(_components.p,{children:`Description of the image. When editing, describe what to keep and what to change.`})}),`\n`,_jsxs(ParamField,{body:`quality`,type:`string`,default:`high`,id:`param-quality`,children:[_jsxs(_components.p,{children:[`Six levels are supported: `,_jsx(_components.code,{children:`auto`}),`, `,_jsx(_components.code,{children:`low`}),`, `,_jsx(_components.code,{children:`medium`}),`, `,_jsx(_components.code,{children:`high`}),`, `,_jsx(_components.code,{children:`xhigh`}),`, and `,_jsx(_components.code,{children:`max`}),`. The default is `,_jsx(_components.code,{children:`high`}),`. Use lowercase values. With `,_jsx(_components.code,{children:`auto`}),`, the upstream model selects the quality level for each request.`]}),_jsx(_components.p,{children:`Quality affects the generation result and the actual output tokens. Images with the same quality can still cost different amounts depending on dimensions and content.`})]}),`\n`,_jsxs(ParamField,{body:`size`,type:`string`,default:`1024x1024`,id:`param-size`,children:[_jsxs(_components.p,{children:[`Output pixel dimensions in `,_jsx(_components.code,{children:`widthxheight`}),` format, for example `,_jsx(_components.code,{children:`1024x1024`}),`, `,_jsx(_components.code,{children:`1536x1024`}),`, `,_jsx(_components.code,{children:`1024x1536`}),`, `,_jsx(_components.code,{children:`1280x1024`}),`.`]}),_jsxs(_components.p,{children:[`Custom pixel dimensions allowed by the upstream provider are supported, not only the examples above. The valid size range is enforced by the endpoint validation. VIP examples do not use ratio values such as `,_jsx(_components.code,{children:`1:1`}),`, and no separate `,_jsx(_components.code,{children:`resolution`}),` is required.`]}),_jsxs(_components.p,{children:[`Custom pixel dimensions must match one of the following aspect ratios: `,_jsx(_components.code,{children:`1:1`}),`, `,_jsx(_components.code,{children:`16:9`}),`, `,_jsx(_components.code,{children:`9:16`}),`, `,_jsx(_components.code,{children:`4:3`}),`, `,_jsx(_components.code,{children:`3:4`}),`, `,_jsx(_components.code,{children:`3:2`}),`, `,_jsx(_components.code,{children:`2:3`}),`, `,_jsx(_components.code,{children:`5:4`}),`, `,_jsx(_components.code,{children:`4:5`}),`, `,_jsx(_components.code,{children:`21:9`}),`.`]})]}),`\n`,_jsxs(ParamField,{body:`background`,type:`string`,id:`param-background`,children:[_jsxs(_components.p,{children:[`Optional background setting. Set `,_jsx(_components.code,{children:`\"transparent\"`}),` to generate an image with a transparent background. Omit this field for normal image generation.`]}),_jsx(_components.p,{children:`Works with both text-to-image requests and reference image editing.`})]}),`\n`,_jsx(ParamField,{body:`n`,type:`integer`,default:1,id:`param-n`,children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`1`}),` per request to generate one image.`]})}),`\n`,_jsxs(ParamField,{body:`reference_images`,type:`string[]`,id:`param-reference-images`,children:[_jsxs(_components.p,{children:[`Optional list of reference image URLs for image-to-image generation. The images must be reachable by the server. Only image URLs are supported: local file uploads and base64 images are not accepted. For local images, obtain a URL first through the `,_jsx(_components.a,{href:`/docs/en/api-reference/uploads/images`,children:`Upload Image API`}),`.`]}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`image_urls`}),` is also accepted. Use one of the two fields. Passing reference image URLs to the generation endpoint triggers image-to-image generation.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`transparent-background`,children:`Transparent Background`}),`\n`,_jsxs(_components.p,{children:[`Add `,_jsx(_components.code,{children:`\"background\": \"transparent\"`}),` to the generation request to get an image with a transparent background. Omit the field for normal generation.`]}),`\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-vip\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"prompt\": \"A red circular sticker on a transparent background\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"quality\": \"low\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"size\": \"1024x1024\",`})}),`\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:[`The task is queried by task ID as usual; read the image URL from `,_jsx(_components.code,{children:`result.data`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`reference-image-editing`,children:`Reference Image Editing`}),`\n`,_jsxs(_components.p,{children:[`Editing uses `,_jsx(_components.code,{children:`POST /v1/images/edits`}),` with a `,_jsx(_components.code,{children:`multipart/form-data`}),` request. Async editing supports image URLs only: put the URL in the `,_jsx(_components.code,{children:`image`}),` field and pass `,_jsx(_components.code,{children:`model`}),`, `,_jsx(_components.code,{children:`prompt`}),`, `,_jsx(_components.code,{children:`quality`}),`, `,_jsx(_components.code,{children:`size`}),`, and `,_jsx(_components.code,{children:`n`}),` alongside it. Local file uploads and base64 images are not supported. Editing is also an async task: the submit returns a task ID, and you query the result the same way as generation.`]}),`\n`,_jsx(_components.p,{children:`The example below uses Sunburst VIP to add a yellow scarf to the baby otter in the reference image. Replace the example URL with your own image URL:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,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:`9`,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/edits`}),_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:` --form`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'model=gpt-image-2.5-sunburst-vip'`}),_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:` --form`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'prompt=Keep the baby otter and the veterinarian from the original image, and add a yellow scarf to the baby otter'`}),_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:` --form`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'image=https://example.com/otter.png'`}),_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:` --form`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'quality=low'`}),_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:` --form`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'size=1024x1024'`}),_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:` --form`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'n=1'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Let curl set the multipart Content-Type and boundary automatically. Poll the status endpoint with the returned task ID and read the edited image URL from `,_jsx(_components.code,{children:`result.data`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Flare VIP supports the same editing approach; change the model to `,_jsx(_components.code,{children:`gpt-image-2.5-flare-vip`}),`. Reference image input incurs image input token costs.`]}),`\n`,_jsx(Heading,{level:`2`,id:`token-pricing`,children:`Token Pricing`}),`\n`,_jsx(_components.p,{children:`The prices below are standard prices verified on 2026-09-09. Both VIP models are the same and are billed at 20% off the official token unit prices:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{style:{textAlign:`right`},children:`USD per million tokens`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Text input`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`4.00`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cached text input`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`1.00`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Image input`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`6.40`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cached image input`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`1.60`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Image output`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`right`},children:`24.00`})]})]})]}),`\n`,_jsx(_components.p,{children:`All six quality levels share these token unit prices. VIP has no fixed per-image price tied to quality; the task is settled by actual usage after it completes. Submitting a task pre-authorizes an amount, and the final charge is settled from the actual text and image tokens after completion, with any difference refunded or charged. You still need sufficient account balance and API Key quota before calling.`}),`\n`,_jsx(_components.p,{children:`Cost formula, in USD:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`cost = (`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` uncached text input tokens * 4`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` + cached text input tokens * 1`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` + uncached image input tokens * 6.4`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` + cached image input tokens * 1.6`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` + image output tokens * 24`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`) / 1,000,000`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`For example, a `,_jsx(_components.code,{children:`low`}),` quality 1024x1024 text-to-image request with 27 text input tokens and 196 image output tokens costs:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`(27 * 4 + 196 * 24) / 1,000,000 = $0.004812`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`One measured reference image edit contained 21 text input tokens, 1024 image input tokens, and 196 image output tokens. The formula gives `,`$0.0113416, which is charged as $`,`0.011342 after rounding to the smallest platform quota unit. These are examples for specific requests and do not represent a fixed cost per image at the same quality.`]}),`\n`,_jsxs(_components.p,{children:[`Account-specific pricing or discounts may differ; check the `,_jsx(_components.a,{href:`https://toapis.com/pricing`,children:`model pricing page`}),` and your account configuration for the latest prices. You can verify the final charge in the usage logs.`]}),`\n`,_jsx(Heading,{level:`2`,id:`switching-from-the-standard-tier`,children:`Switching from the Standard Tier`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Change the full model name to the matching `,_jsx(_components.code,{children:`-vip`}),` model name.`]}),`\n`,_jsxs(_components.li,{children:[`Change `,_jsx(_components.code,{children:`size`}),` from a ratio to pixel dimensions, and omit `,_jsx(_components.code,{children:`resolution`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`For both text-to-image and reference image editing, poll the result by task ID and read the image URL from `,_jsx(_components.code,{children:`result.data`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`For reference image editing, switch to `,_jsx(_components.code,{children:`/v1/images/edits`}),` and pass an image URL.`]}),`\n`,_jsx(_components.li,{children:`Estimate cost from actual tokens.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`For async submission and task polling examples in the standard tier, see the `,_jsx(_components.a,{href:`/docs/en/api-reference/images/gpt-image-2.5/generation`,children:`GPT-Image-2.5 documentation`}),`.`]})]})}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 VIP Image Generation and Editing","sidebarTitle":"GPT-Image-2.5 VIP","api":"POST https://toapis.com/v1/images/generations","description":"Async task guide for gpt-image-2.5-flare-vip and gpt-image-2.5-sunburst-vip, with six quality levels, pixel dimensions, transparent backgrounds, and postpaid billing by actual token usage","href":"/docs/en/api-reference/images/gpt-image-2.5-vip/generation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Quick Start","slug":"quick-start","depth":2,"children":[]},{"title":"Generation Request Parameters","slug":"generation-request-parameters","depth":2,"children":[]},{"title":"Transparent Background","slug":"transparent-background","depth":2,"children":[]},{"title":"Reference Image Editing","slug":"reference-image-editing","depth":2,"children":[]},{"title":"Token Pricing","slug":"token-pricing","depth":2,"children":[]},{"title":"Switching from the Standard Tier","slug":"switching-from-the-standard-tier","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"GPT-Image-2.5 VIP Image Generation and Editing","path":"/v1/images/generations","servers":[{"url":"https://toapis.com"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{"Authorization":{"schema":[{"type":"string","description":"Authenticate with `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-vip` or `gpt-image-2.5-sunburst-vip` .","required":true}],"prompt":[{"type":"string","description":"Description of the image. When editing, describe what to keep and what to change.","required":true}],"quality":[{"type":"string","description":"Six levels are supported: `auto` , `low` , `medium` , `high` , `xhigh` , and `max` . The default is `high` . Use lowercase values. With `auto` , the upstream model selects the quality level for each request. Quality affects the generation result and the actual output tokens. Images with the same quality can still cost different amounts depending on dimensions and content."}],"size":[{"type":"string","description":"Output pixel dimensions in `widthxheight` format, for example `1024x1024` , `1536x1024` , `1024x1536` , `1280x1024` . Custom pixel dimensions allowed by the upstream provider are supported, not only the examples above. The valid size range is enforced by the endpoint validation. VIP examples do not use ratio values such as `1:1` , and no separate `resolution` is required. Custom pixel dimensions must match one of the following aspect ratios: `1:1` , `16:9` , `9:16` , `4:3` , `3:4` , `3:2` , `2:3` , `5:4` , `4:5` , `21:9` ."}],"background":[{"type":"string","description":"Optional background setting. Set `\"transparent\"` to generate an image with a transparent background. Omit this field for normal image generation. Works with both text-to-image requests and reference image editing."}],"n":[{"type":"integer","description":"Use `1` per request to generate one image."}],"reference_images":[{"type":"array","items":[{"type":"string"}],"description":"Optional list of reference image URLs for image-to-image generation. The images must be reachable by the server. Only image URLs are supported: local file uploads and base64 images are not accepted. For local images, obtain a URL first through the Upload Image API . `image_urls` is also accepted. Use one of the two fields. Passing reference image URLs to the generation endpoint triggers image-to-image generation."}]}}],"examples":{"example":{"value":{"model":"\u003cstring>","prompt":"\u003cstring>","quality":"\u003cstring>","size":"\u003cstring>","background":"\u003cstring>","n":123,"reference_images":["\u003cstring>"]}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"dashlyai","siteName":"ToAPIs Documentation","title":"GPT-Image-2.5 VIP Image Generation and Editing - ToAPIs Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"cn":{"href":"/docs/cn/api-reference/images/gpt-image-2.5-vip/generation","matchLevel":1},"zh-Hant":{"href":"/docs/zh-Hant/api-reference/images/gpt-image-2.5-vip/generation","matchLevel":1},"en":{"href":"/docs/en/api-reference/images/gpt-image-2.5-vip/generation","matchLevel":0},"ja":{"href":"/docs/ja/api-reference/images/gpt-image-2.5-vip/generation","matchLevel":1},"ko":{"href":"/docs/ko/api-reference/images/gpt-image-2.5-vip/generation","matchLevel":1},"ru":{"href":"/docs/ru/api-reference/images/gpt-image-2.5-vip/generation","matchLevel":1}}},"lastModified":"2026-09-29T08:42:54.423Z","originalFileLocation":"docs/en/api-reference/images/gpt-image-2.5-vip/generation.mdx","locale":"en"},"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=\"Async task guide for gpt-image-2.5-flare-vip and gpt-image-2.5-sunburst-vip, with six quality levels, pixel dimensions, transparent backgrounds, and postpaid billing by actual token usage\">\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 VIP Image Generation and Editing - ToAPIs Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Async task guide for gpt-image-2.5-flare-vip and gpt-image-2.5-sunburst-vip, with six quality levels, pixel dimensions, transparent backgrounds, and postpaid billing by actual token usage\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ToAPIs Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.toapis.com/docs/en/api-reference/images/gpt-image-2.5-vip/generation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dashlyai.mintlify.app/_mintlify/api/og/v2?division=GPT-Image-2.5\u0026amp;title=GPT-Image-2.5+VIP+Image+Generation+and+Editing\u0026amp;description=Async+task+guide+for+gpt-image-2.5-flare-vip+and+gpt-image-2.5-sunburst-vip%2C+with+six+quality+levels%2C+pixel+dimensions%2C+transparent+backgrounds%2C+and+postpaid+bi\u0026amp;theme=05a42d799ed79e408e323a53\u0026amp;signature=34dc44e6f9aaa6ae04ea0b6dbfa0a300679c790c02f76348ecad623b19087ae5\">\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 VIP Image Generation and Editing - ToAPIs Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Async task guide for gpt-image-2.5-flare-vip and gpt-image-2.5-sunburst-vip, with six quality levels, pixel dimensions, transparent backgrounds, and postpaid billing by actual token usage\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dashlyai.mintlify.app/_mintlify/api/og/v2?division=GPT-Image-2.5\u0026amp;title=GPT-Image-2.5+VIP+Image+Generation+and+Editing\u0026amp;description=Async+task+guide+for+gpt-image-2.5-flare-vip+and+gpt-image-2.5-sunburst-vip%2C+with+six+quality+levels%2C+pixel+dimensions%2C+transparent+backgrounds%2C+and+postpaid+bi\u0026amp;theme=05a42d799ed79e408e323a53\u0026amp;signature=34dc44e6f9aaa6ae04ea0b6dbfa0a300679c790c02f76348ecad623b19087ae5\">\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/en/api-reference/images/gpt-image-2.5-vip/generation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/en/api-reference/images/gpt-image-2.5-vip/generation.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.toapis.com/docs/en/api-reference/images/gpt-image-2.5-vip/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.toapis.com/docs/cn/api-reference/images/gpt-image-2.5-vip/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-vip/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.toapis.com/docs/ja/api-reference/images/gpt-image-2.5-vip/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.toapis.com/docs/ko/api-reference/images/gpt-image-2.5-vip/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.toapis.com/docs/ru/api-reference/images/gpt-image-2.5-vip/generation\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.toapis.com/docs/cn/api-reference/images/gpt-image-2.5-vip/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/en/api-reference/images/gpt-image-2.5-vip/generation#webpage\",\"url\":\"https://docs.toapis.com/docs/en/api-reference/images/gpt-image-2.5-vip/generation\",\"name\":\"GPT-Image-2.5 VIP Image Generation and Editing\",\"description\":\"Async task guide for gpt-image-2.5-flare-vip and gpt-image-2.5-sunburst-vip, with six quality levels, pixel dimensions, transparent backgrounds, and postpaid billing by actual token usage\",\"dateModified\":\"2026-09-29T08:42:54.423Z\",\"isPartOf\":{\"@id\":\"https://docs.toapis.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.toapis.com/docs/en/api-reference/images/gpt-image-2.5-vip/generation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.toapis.com/docs/en/api-reference/images/gpt-image-2.5-vip/generation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Image API\",\"item\":\"https://docs.toapis.com/docs/en/api-reference/images/gemini-3-pro-image/generation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GPT-Image-2.5\",\"item\":\"https://docs.toapis.com/docs/en/api-reference/images/gpt-image-2.5/generation\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"GPT-Image-2.5 VIP Image Generation and Editing\",\"item\":\"https://docs.toapis.com/docs/en/api-reference/images/gpt-image-2.5-vip/generation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.toapis.com/docs/en/api-reference/images/gpt-image-2.5-vip/generation#apireference\",\"headline\":\"GPT-Image-2.5 VIP Image Generation and Editing\",\"name\":\"GPT-Image-2.5 VIP Image Generation and Editing\",\"description\":\"Async task guide for gpt-image-2.5-flare-vip and gpt-image-2.5-sunburst-vip, with six quality levels, pixel dimensions, transparent backgrounds, and postpaid billing by actual token usage\",\"url\":\"https://docs.toapis.com/docs/en/api-reference/images/gpt-image-2.5-vip/generation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.toapis.com/docs/en/api-reference/images/gpt-image-2.5-vip/generation#webpage\"},\"dateModified\":\"2026-09-29T08:42:54.423Z\",\"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-vip/generation"}]},{"language":"zh-Hant","pages":[{"title":"zh-Hant","href":"/docs/zh-Hant/api-reference/images/gpt-image-2.5-vip/generation"}]},{"language":"en","tabs":[{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Manual","sidebarTitle":"API Manual","href":"/docs/en"}]},{"group":"Quick Start","pages":[{"title":"Quick Start","sidebarTitle":"Guides","href":"/docs/en/quickstart"},{"title":"Claude Code Setup Guide","sidebarTitle":"Claude Code","href":"/docs/en/integrations/claude-code"},{"title":"Codex Setup Guide","sidebarTitle":"Codex","href":"/docs/en/integrations/codex"},{"title":"Using ToAPIs with OpenClaw","sidebarTitle":"OpenClaw","href":"/docs/en/integrations/openclaw"},{"title":"Cherry Studio Setup Guide","sidebarTitle":"Cherry Studio","href":"/docs/en/integrations/cherry-studio"},{"title":"Integrations","sidebarTitle":"Integrations","href":"/docs/en/integrations/chatbox"}]},{"group":"Model Catalog","pages":[{"title":"Public Model Catalog","sidebarTitle":"Model Catalog","href":"/docs/en/api-reference/models"}]},{"group":"Chat API","pages":[{"title":"Supported Text Models","sidebarTitle":"Model List","href":"/docs/en/api-reference/chat/models"},{"title":"List Models","sidebarTitle":"List Models","api":"GET https://toapis.com/v1/models","href":"/docs/en/api-reference/chat/list-models"},{"group":"GPT-5 Series","pages":[{"title":"GPT-5.4 Chat","sidebarTitle":"gpt-5.4","api":"POST https://toapis.com/v1/chat/completions","href":"/docs/en/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/en/api-reference/chat/gpt-5.5/chat"},{"title":"GPT-5.6 Family Chat","sidebarTitle":"gpt-5.6 family","api":"POST https://toapis.com/v1/chat/completions","href":"/docs/en/api-reference/chat/gpt-5.6/chat"}]},{"group":"OpenAI Format","pages":[{"title":"Chat Completions","sidebarTitle":"Chat Completions API","api":"POST https://toapis.com/v1/chat/completions","href":"/docs/en/api-reference/chat/chat"}]},{"group":"Anthropic Format","pages":[{"title":"Anthropic Messages API","sidebarTitle":"POST /v1/messages","api":"POST https://toapis.com/v1/messages","href":"/docs/en/api-reference/chat/messages"}]},{"group":"Responses Format","pages":[{"title":"Responses API","sidebarTitle":"Responses API","api":"POST https://toapis.com/v1/responses","href":"/docs/en/api-reference/chat/responses"}]}]},{"group":"Image API","pages":[{"group":"Gemini-3-Pro-Image-preview (Nano banana2)","pages":[{"title":"Gemini-3-Pro Image Generation","sidebarTitle":"Gemini-3-Pro-Image","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gemini-3-pro-image/generation"}]},{"group":"Gemini-3-Pro-Image VIP","pages":[{"title":"Gemini 3 Pro Image VIP Image Generation","sidebarTitle":"VIP","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gemini-3-pro-image-vip/generation"}]},{"group":"Gemini Nano Banana 2.1","pages":[{"title":"Gemini Nano Banana 2.1 Image Generation","sidebarTitle":"Image Generation","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gemini-nano-banana-2.1/generation"},{"title":"Gemini Nano Banana 2.1 Official Image Generation","sidebarTitle":"Official","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/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 Image Generation","sidebarTitle":"Gemini-3.1-Flash-Image","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gemini-3.1-flash/generation"}]},{"group":"Gemini-3.1-Flash-Image VIP","pages":[{"title":"Gemini 3.1 Flash Image VIP Image Generation","sidebarTitle":"VIP","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gemini-3.1-flash-vip/generation"}]},{"group":"Gemini-2.5-Flash-Image-preview (Nano banana)","pages":[{"title":"Gemini-2.5-Flash Image Generation","sidebarTitle":"Gemini-2.5-Flash-Image","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gemini-2.5-flash/generation"}]},{"group":"Gemini-3-Pro-Image Official / Nano Banana Pro","pages":[{"title":"Gemini 3 Pro Image Official Image Generation","sidebarTitle":"Official","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gemini-3-pro-image-official/generation"}]},{"group":"gemini-3.1-flash-image-official","pages":[{"title":"Gemini-3.1-Flash Official Image Generation","sidebarTitle":"Gemini-3.1-Flash-Image Official","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gemini-3.1-flash-official/generation"}]},{"group":"Gemini-2.5-Flash-Image Official","pages":[{"title":"Gemini-2.5-Flash Official Image Generation","sidebarTitle":"Gemini-2.5-Flash-Image Official","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gemini-2.5-flash-official/generation"}]},{"group":"GPT-4o-image","pages":[{"title":"GPT-4o Image Generation","sidebarTitle":"GPT-4o-image","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gpt-4o/generation"}]},{"group":"GPT-Image-2","pages":[{"title":"GPT-Image-2 Image Generation","sidebarTitle":"gpt-image-2","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gpt-image-2/generation"},{"title":"GPT-Image-2 Official Channel Image Generation","sidebarTitle":"gpt-image-2-official","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gpt-image-2/official"}]},{"group":"GPT-Image-2.5","pages":[{"title":"GPT-Image-2.5 Image Generation","sidebarTitle":"GPT-Image-2.5","api":"POST https://toapis.com/v1/images/generations","description":"Access guide for the standard gpt-image-2.5-flare and gpt-image-2.5-sunburst tiers, including async tasks, reference images, transparent backgrounds, fixed high quality, and resolution-based pricing","href":"/docs/en/api-reference/images/gpt-image-2.5/generation"},{"title":"GPT-Image-2.5 VIP Image Generation and Editing","sidebarTitle":"GPT-Image-2.5 VIP","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gpt-image-2.5-vip/generation"},{"title":"GPT-Image-2.5 Official Image Generation","sidebarTitle":"GPT-Image-2.5 Official","api":"POST https://api.toapis.com/v1/images/generations","description":"Async Sunburst and Flare image tasks through the official channel, with R2 delivery and token pricing at 80% of official rates","href":"/docs/en/api-reference/images/gpt-image-2.5-official/generation"}]},{"group":"GPT-Image-2-VIP","pages":[{"title":"GPT-Image-2-VIP Image Generation","sidebarTitle":"gpt-image-2-vip","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/gpt-image-2-vip/generation"}]},{"group":"Qwen Image 3.0","pages":[{"title":"Qwen Image 3.0 Image Generation","sidebarTitle":"Qwen Image 3.0 / Pro","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/qwen-image-3.0/generation"}]},{"group":"Flux Kontext","pages":[{"title":"Flux Kontext Image Generation","sidebarTitle":"Flux Kontext","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/flux-kontext/generation"}]},{"group":"Flux 2.0","pages":[{"title":"Flux 2.0 Image Generation","sidebarTitle":"Flux 2.0","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/flux-2/generation"}]},{"group":"Seedream-4.0","pages":[{"title":"Seedream-4.0 Image Generation","sidebarTitle":"Seedream-4.0","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/seedream-4.0/generation"}]},{"group":"Seedream-4.5","pages":[{"title":"Seedream-4.5 Image Generation","sidebarTitle":"Seedream-4.5","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/seedream-4.5/generation"}]},{"group":"Seedream-5.0","pages":[{"title":"Seedream-5.0 Image Generation","sidebarTitle":"Seedream-5.0","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/seedream-5.0/generation"}]},{"group":"Seedream-5.0-Pro","pages":[{"title":"Seedream-5.0-Pro Image Generation","sidebarTitle":"Seedream-5.0-Pro","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/seedream-5.0-pro/generation"}]},{"group":"Grok Image","pages":[{"title":"Grok Image Generation","sidebarTitle":"Grok Image","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/api-reference/images/grok-image/generation"}]},{"group":"Grok Imagine 1.0","pages":[{"title":"Grok Imagine 1.0 Image Generation","sidebarTitle":"Generation","api":"POST https://toapis.com/v1/images/generations","href":"/docs/en/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/en/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/en/api-reference/images/vidu-image/generation"}]},{"group":"Midjourney","pages":[{"title":"Midjourney API","sidebarTitle":"Overview","api":"POST https://toapis.com/v1/midjourney/generations","href":"/docs/en/api-reference/images/midjourney/generation"},{"title":"Midjourney Imagine","api":"POST https://toapis.com/v1/midjourney/generations/imagine","href":"/docs/en/api-reference/images/midjourney/imagine"},{"title":"Midjourney Blend","api":"POST https://toapis.com/v1/midjourney/generations/blend","href":"/docs/en/api-reference/images/midjourney/blend"},{"title":"Midjourney Describe","api":"POST https://toapis.com/v1/midjourney/generations/describe","href":"/docs/en/api-reference/images/midjourney/describe"},{"title":"Midjourney Edits","api":"POST https://toapis.com/v1/midjourney/generations/edits","href":"/docs/en/api-reference/images/midjourney/edits"},{"title":"Midjourney Upscale","api":"POST https://toapis.com/v1/midjourney/generations/upscale","href":"/docs/en/api-reference/images/midjourney/upscale"},{"title":"Midjourney Variation","api":"POST https://toapis.com/v1/midjourney/generations/variation","href":"/docs/en/api-reference/images/midjourney/variation"},{"title":"Midjourney High Variation","api":"POST https://toapis.com/v1/midjourney/generations/high-variation","href":"/docs/en/api-reference/images/midjourney/high-variation"},{"title":"Midjourney Low Variation","api":"POST https://toapis.com/v1/midjourney/generations/low-variation","href":"/docs/en/api-reference/images/midjourney/low-variation"},{"title":"Midjourney Reroll","api":"POST https://toapis.com/v1/midjourney/generations/reroll","href":"/docs/en/api-reference/images/midjourney/reroll"},{"title":"Midjourney Zoom","api":"POST https://toapis.com/v1/midjourney/generations/zoom","href":"/docs/en/api-reference/images/midjourney/zoom"},{"title":"Midjourney Pan","api":"POST https://toapis.com/v1/midjourney/generations/pan","href":"/docs/en/api-reference/images/midjourney/pan"},{"title":"Midjourney Inpaint","api":"POST https://toapis.com/v1/midjourney/generations/inpaint","href":"/docs/en/api-reference/images/midjourney/inpaint"},{"title":"Midjourney Modal","api":"POST https://toapis.com/v1/midjourney/generations/modal","href":"/docs/en/api-reference/images/midjourney/modal"},{"title":"Midjourney Video","api":"POST https://toapis.com/v1/midjourney/generations/video","href":"/docs/en/api-reference/images/midjourney/video"},{"title":"Midjourney Remix","api":"POST https://toapis.com/v1/midjourney/generations/remix-strong","href":"/docs/en/api-reference/images/midjourney/remix"},{"title":"Query a Midjourney Task","sidebarTitle":"Query Tasks","api":"GET https://toapis.com/v1/midjourney/{task_id}","href":"/docs/en/api-reference/images/midjourney/query"},{"title":"Midjourney Best Practices","sidebarTitle":"Best Practices","href":"/docs/en/api-reference/images/midjourney/best-practices"},{"title":"Midjourney Workflow","sidebarTitle":"Workflow","href":"/docs/en/api-reference/images/midjourney/workflow"}]}]},{"group":"Video API","pages":[{"group":"doubao-seedance-1-0-pro","pages":[{"title":"Doubao SeeDance Video Generation","sidebarTitle":"doubao-seedance","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/doubao-seedance/generation"}]},{"group":"doubao-seedance-1-5-pro","pages":[{"title":"Doubao SeeDance 1.5 Pro Video Generation","sidebarTitle":"doubao-seedance-1-5-pro","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/doubao-seedance-1-5/generation"}]},{"group":"Seedance Price Lookup","pages":[{"title":"Volcano Ark Video Generation Model Price Lookup","sidebarTitle":"Seedance Price Lookup","href":"/docs/en/api-reference/videos/seedance/pricing"}]},{"group":"seedance-2","pages":[{"title":"seedance-2 Video Generation","sidebarTitle":"seedance-2","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/seedance-2/generation"}]},{"group":"seedance-2-5","pages":[{"title":"Seedance 2.5 Video Generation","sidebarTitle":"Seedance 2.5","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/seedance-2-5/generation"},{"title":"Seedance 2.5 Draft Mode","sidebarTitle":"Draft Mode","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/seedance-2-5/draft"}]},{"group":"seedance-ext","pages":[{"title":"seedance-2.5-ext Video Generation","sidebarTitle":"seedance-2.5-ext","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/seedance-2-5-ext/generation"},{"title":"seedance-2-ext Video Generation","sidebarTitle":"seedance-2-ext","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/seedance-2-ext/generation"},{"title":"seedance-2-fast-ext Video Generation","sidebarTitle":"seedance-2-fast-ext","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/seedance-2-fast-ext/generation"}]},{"group":"HappyHorse","pages":[{"title":"HappyHorse 1.1 Video Generation","sidebarTitle":"happyhorse-1.1","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/happyhorse/generation"}]},{"group":"Sora2","pages":[{"title":"Sora2 VVIP Video Generation","sidebarTitle":"Sora2 VVIP","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/sora2/generation"},{"title":"Sora2 Create Character","sidebarTitle":"Create Character","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/sora2/create-persona"},{"title":"Sora2 Query Character Status","sidebarTitle":"Query Character Status","api":"GET https://toapis.com/v1/characters_tasks/{task_id}","href":"/docs/en/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/en/api-reference/videos/sora2/remix"}]},{"group":"Sora 2 Official (Azure)","pages":[{"title":"Azure Sora 2 Video Generation","sidebarTitle":"Sora 2 Official","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/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/en/api-reference/videos/sora-2-official/remix"}]},{"group":"Veo3","pages":[{"title":"Veo3 Video Generation","sidebarTitle":"Veo3","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/veo3/generation"}]},{"group":"Gemini Omni Flash","pages":[{"title":"Gemini Omni Flash Video Generation","sidebarTitle":"Gemini Omni Flash","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/gemini-omni-flash/generation"},{"title":"Gemini Omni 1.1 Standard","sidebarTitle":"Omni 1.1 Standard","api":"POST https://toapis.com/v1/videos","href":"/docs/en/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/en/api-reference/videos/gemini-omni-flash/generation-1-1-vip"}]},{"group":"Gemini Omni Official","pages":[{"title":"Gemini Omni Flash Video Generation","sidebarTitle":"Gemini Omni Flash Preview Official","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/gemini-omni-flash-preview-official/generation"},{"title":"Gemini Omni 1.1 Video Generation and Editing","sidebarTitle":"Gemini Omni 1.1 Flash Preview Official","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/gemini-omni-1.1-flash-preview-official/generation"}]},{"group":"Veo3 Official (including Veo3.1 Lite)","pages":[{"title":"Veo3 Official Video Generation","sidebarTitle":"Veo3 Official","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/veo3-official/generation"}]},{"group":"MiniMax-Hailuo-02","pages":[{"title":"MiniMax-Hailuo-02 Video Generation","sidebarTitle":"MiniMax-Hailuo-02","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/minimax-hailuo/generation"}]},{"group":"Wan 3.0","pages":[{"title":"Wan 3.0 All-in-One Video Generation","sidebarTitle":"Wan 3.0","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/wan3.0/generation"}]},{"group":"Wan2.6","pages":[{"title":"Wan2.6 Video Generation","sidebarTitle":"Wan2.6","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/wan2.6/generation"},{"title":"Wan2.6 Flash Video Generation","sidebarTitle":"Wan2.6 Flash","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/wan2.6-flash/generation"}]},{"group":"Kling v2.6","pages":[{"title":"Kling v2.6 Video Generation","sidebarTitle":"Kling v2.6","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/kling-2-6/generation"}]},{"group":"Kling v3","pages":[{"title":"Kling v3 Video Generation","sidebarTitle":"Kling v3","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/kling-v3/generation"}]},{"group":"kling-3.0-turbo","pages":[{"title":"kling-3.0-turbo Video Generation","sidebarTitle":"kling-3.0-turbo","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/kling-3.0-turbo/generation"}]},{"group":"Kling v3 Omni","pages":[{"title":"Kling v3 Omni Video Generation","sidebarTitle":"Kling v3 Omni","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/kling-v3-omni/generation"}]},{"group":"Kling v4","pages":[{"title":"Kling v4 Video Generation","sidebarTitle":"Kling v4","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/kling-4.0/generation"}]},{"group":"Kling Video O1","pages":[{"title":"Kling Video O1 Video Generation","sidebarTitle":"Kling Video O1","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/kling-video-o1/generation"}]},{"group":"MiniMax-Hailuo-2.3","pages":[{"title":"MiniMax-Hailuo-2.3 Video Generation","sidebarTitle":"MiniMax-Hailuo-2.3","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/minimax-hailuo-2.3/generation"}]},{"group":"MiniMax-H3","pages":[{"title":"MiniMax Hailuo H3 Video Generation","sidebarTitle":"MiniMax-H3","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/minimax-h3/generation"}]},{"group":"Vidu Q3","pages":[{"title":"Vidu Q3 Video Generation","sidebarTitle":"Vidu Q3","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/viduq3/generation"},{"title":"Vidu Q3 Video Generation","sidebarTitle":"Vidu Q3 (Multi-Model)","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/vidu-ali/generation"}]},{"group":"Vidu Q4 Preview","pages":[{"title":"Vidu Q4 Preview Video Generation","sidebarTitle":"Vidu Q4 Preview","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/viduq4-preview/generation"}]},{"group":"Grok Video","pages":[{"title":"Grok Video 1.5 Generation","sidebarTitle":"Grok Video 1.5","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/grok-video-1.5/generation"},{"title":"Grok Video Generation","sidebarTitle":"Grok Video","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/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/en/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/en/api-reference/videos/grok-video/extend"}]},{"group":"Grok Imagine Video (Official)","pages":[{"title":"Grok Imagine Video Generation (Official)","sidebarTitle":"Grok Imagine Video","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/grok-imagine-video-official/generation"},{"title":"Grok Imagine Video Extend (Official)","sidebarTitle":"Video Extend","api":"POST https://toapis.com/v1/videos/{video_id}/extend","href":"/docs/en/api-reference/videos/grok-imagine-video-official/extend"},{"title":"Grok Imagine Video 1.5 Generation (Official)","sidebarTitle":"Grok Imagine Video 1.5","api":"POST https://toapis.com/v1/videos/generations","href":"/docs/en/api-reference/videos/grok-imagine-video-1.5-official/generation"}]}]},{"group":"Music API","pages":[{"group":"Suno Music","pages":[{"title":"Suno Music","sidebarTitle":"Overview \u0026 Pricing","href":"/docs/en/api-reference/audios/suno/overview"},{"title":"Music Generation","sidebarTitle":"Generation","api":"POST https://toapis.com/v1/music/generations/generation","href":"/docs/en/api-reference/audios/suno/generation"},{"title":"Extend \u0026 Upload","sidebarTitle":"Extend \u0026 Upload","api":"POST https://toapis.com/v1/music/generations/extend","href":"/docs/en/api-reference/audios/suno/upload-extend"},{"title":"Edit \u0026 Transform","sidebarTitle":"Edit \u0026 Transform","api":"POST https://toapis.com/v1/music/generations/crop","href":"/docs/en/api-reference/audios/suno/edit"},{"title":"Stems \u0026 Add Tracks","sidebarTitle":"Stems \u0026 Tracks","api":"POST https://toapis.com/v1/music/generations/stems","href":"/docs/en/api-reference/audios/suno/stems"},{"title":"Lyrics / Inspo / Sounds / Tags","sidebarTitle":"Auxiliary Generation","api":"POST https://toapis.com/v1/music/generations/lyrics","href":"/docs/en/api-reference/audios/suno/create-extras"},{"title":"Analysis \u0026 Export","sidebarTitle":"Analysis \u0026 Export","api":"POST https://toapis.com/v1/music/generations/midi","href":"/docs/en/api-reference/audios/suno/analysis"},{"title":"Asset Operations","sidebarTitle":"Assets","api":"POST https://toapis.com/v1/music/generations/persona","href":"/docs/en/api-reference/audios/suno/assets"}]}]},{"group":"Task Management","pages":[{"title":"Get Image Task Status","sidebarTitle":"Get Image Task Status","api":"GET https://toapis.com/v1/images/generations/{task_id}","href":"/docs/en/api-reference/tasks/image-status"},{"title":"Get Video Task Status","sidebarTitle":"Get Video Task Status","api":"GET https://toapis.com/v1/videos/generations/{task_id}","href":"/docs/en/api-reference/tasks/video-status"},{"title":"Task Webhooks","href":"/docs/en/api-reference/webhooks/task-webhooks"},{"title":"Async task rate limits","href":"/docs/en/api-reference/rate-limits/async-tasks"},{"group":"Get Music Task Status","pages":[{"title":"Get Music Task Status","sidebarTitle":"Get Music Task Status","api":"GET https://toapis.com/v1/music/tasks/{task_id}","href":"/docs/en/api-reference/tasks/music-status"}]}]},{"group":"File Uploads","pages":[{"title":"Upload Image","sidebarTitle":"Upload Image","api":"POST https://toapis.com/v1/uploads/images","href":"/docs/en/api-reference/uploads/images"},{"title":"Upload Video","sidebarTitle":"Upload Video","api":"POST https://toapis.com/v1/uploads/videos","href":"/docs/en/api-reference/uploads/videos"},{"title":"Upload Audio","sidebarTitle":"Upload Audio","api":"POST https://toapis.com/v1/uploads/audios","href":"/docs/en/api-reference/uploads/audios"}]},{"group":"Account","pages":[{"title":"Query Token Balance","sidebarTitle":"Query Token Balance","api":"GET https://toapis.com/v1/balance","href":"/docs/en/api-reference/account/token-balance"},{"title":"Query Token Usage","sidebarTitle":"Query Token Usage","api":"GET https://toapis.com/api/usage/tokens/requests","href":"/docs/en/api-reference/account/token-usage"},{"title":"Query User Balance","sidebarTitle":"Query User Balance","api":"GET https://toapis.com/v1/user/balance","href":"/docs/en/api-reference/account/user-balance"},{"title":"Pricing and Actual Charges","sidebarTitle":"Pricing and Actual Charges","api":"GET https://toapis.com/v1/pricing","href":"/docs/en/api-reference/account/pricing"},{"title":"Create API Token","sidebarTitle":"Create Token","api":"POST https://toapis.com/v1/tokens","href":"/docs/en/api-reference/account/create-token"}]},{"group":"FAQs","pages":[{"title":"FAQs","sidebarTitle":"FAQs","href":"/docs/en/faqs"}]}]}]},{"language":"ja","pages":[{"title":"ja","href":"/docs/ja/api-reference/images/gpt-image-2.5-vip/generation"}]},{"language":"ko","pages":[{"title":"ko","href":"/docs/ko/api-reference/images/gpt-image-2.5-vip/generation"}]},{"language":"ru","pages":[{"title":"ru","href":"/docs/ru/api-reference/images/gpt-image-2.5-vip/generation"}]}]},"title":"GPT-Image-2.5 VIP Image Generation and Editing - 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"]}