> ## Documentation Index > Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt > Use this file to discover all available pages before exploring further. # GPT-Image-2.6 Генерация изображений > Асинхронная генерация и редактирование с Flare и Sunburst: разметка, анимированные GIF и SVG. Генерация, редактирование, GIF и SVG используют `POST /v1/images/generations`. Получите `data[0].task_id` из ответа, затем запросите результат задачи со ссылками на файлы. ```bash cURL theme={null} curl --request POST \ --url https://api.apimart.ai/v1/images/generations \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "model": "gpt-image-2.6-flare", "prompt": "A cozy reading nook by a rainy window, warm lamp light", "size": "1:1", "resolution": "1k", "quality": "medium", "n": 1 }' ``` ```python Python theme={null} import requests response = requests.post( "https://api.apimart.ai/v1/images/generations", headers={"Authorization": "Bearer "}, json={ "model": "gpt-image-2.6-flare", "prompt": "A cozy reading nook by a rainy window, warm lamp light", "size": "1:1", "resolution": "1k", "quality": "medium", "n": 1 }, ) response.raise_for_status() print(response.json()["data"][0]["task_id"]) ``` ```javascript JavaScript theme={null} const response = await fetch("https://api.apimart.ai/v1/images/generations", { method: "POST", headers: { Authorization: "Bearer ", "Content-Type": "application/json", }, body: JSON.stringify({ "model": "gpt-image-2.6-flare", "prompt": "A cozy reading nook by a rainy window, warm lamp light", "size": "1:1", "resolution": "1k", "quality": "medium", "n": 1 }), }); if (!response.ok) throw new Error(await response.text()); const result = await response.json(); console.log(result.data[0].task_id); ``` ```json 200 theme={null} { "code": 200, "data": [ { "status": "submitted", "task_id": "task_01KXXXXXXXXXXXXXXX" } ] } ``` ## Аутентификация **Authorization** `string` *required* Используйте Bearer Token. Ключ можно получить на [странице API-ключей](https://apimart.ai/keys). ```text theme={null} Authorization: Bearer YOUR_API_KEY ``` ## Выбор модели | Модель | Применение | | - | - | | `gpt-image-2.6-flare` | Быстрая генерация для частых итераций; рекомендуемый вариант по умолчанию. | | `gpt-image-2.6-sunburst` | Приоритет детализации и согласованности последовательных правок, особенно при качестве `medium` / `high`. | Тарифы за токен и расход при одинаковых настройках совпадают. Выбирайте по требованиям к скорости и детализации. ## Параметры запроса **model** `string` *required* Название модели: `gpt-image-2.6-flare` или `gpt-image-2.6-sunburst`. **prompt** `string` *required* Описание генерации или правок, до 32 000 символов. Укажите объект, композицию и то, что нужно изменить или сохранить. **size** `string` (default: auto) Статичные изображения и SVG поддерживают 15 соотношений сторон, точные размеры вроде `1600x1200` и `auto`. Явное `auto` передаёт выбор поставщику. При редактировании без этого поля размер определяется пропорциями первого изображения и `resolution`. Для GIF действуют отдельные правила ниже. **resolution** `string` (default: 1k) `1k` / `2k` / `4k`, строчными буквами. Вместе с пропорциями в `size` определяет пиксельные размеры; при точном размере игнорируется. **quality** `string` (default: auto) `low` / `medium` / `high` / `xhigh` / `max` / `auto`. Другие значения возвращают HTTP 400 при отправке. Если поле отсутствует или задано `auto`, модель выбирает уровень качества автоматически. Уровень может меняться и не фиксируется на `low`. Для фиксированного уровня задайте его явно. Если поле отсутствует или задано `auto`, средства резервируются по уровню `max`, а итоговая сумма рассчитывается по фактически выбранному уровню качества. **n** `integer` (default: 1) Целое число `1`–`4`; для GIF это число анимаций. SVG требует `1`. Явные значения `0`, отрицательные числа или значения больше `4` возвращают HTTP 400 и не заменяются значением по умолчанию. **output\_format** `string` (default: png) `png` / `jpeg` / `webp` / `gif` / `svg`. GIF и SVG поддерживают только генерацию по тексту. Другие значения возвращают HTTP 400 при отправке. **output\_compression** `integer` Целое число от `0` до `100`, только для `jpeg` / `webp`. Выход за диапазон или сочетание с `png` / `gif` / `svg` возвращает HTTP 400 при отправке. **background** `string` `transparent` / `opaque` / `auto`; без поля используется настройка поставщика. Явное `transparent` допустимо только с `png` / `webp`. Фон SVG прозрачен по умолчанию — не передавайте это поле для SVG. **moderation** `string` (default: low) Уровень модерации: `auto` / `low`. Другие значения возвращают HTTP 400 при отправке. **image\_urls** `string[]` До 16 исходных изображений; их передача включает редактирование. Используйте общедоступные HTTP(S) URL. Локальные файлы сначала отправьте через [API загрузки изображений](https://docs.apimart.ai/ru/api-reference/uploads/images.md), затем передайте полученный `url`. **mask\_url** `string` Маска локального редактирования, требует `image_urls`. Нужен PNG с альфа-каналом и размерами первого изображения; полностью прозрачные области обозначают зоны правок. Допустим URL или PNG Data URL. Нельзя сочетать с разметкой; точное сохранение пикселей вне маски не гарантируется. **complexity** `string` Интенсивность планирования: `low` / `medium` / `high`, по умолчанию у поставщика `high`, независимо от `quality`. Для локальных правок используйте `low`, для плотного текста, сложной композиции и связей объектов — `high`. Более интенсивное планирование может замедлить работу или внести лишние изменения. Отдельная плата не взимается; поддерживается только в 2.6. **safety\_identifier** `string` Необязательный стабильный идентификатор конечного пользователя, до 128 символов; рекомендуется хеш имени или почты. APIMart по умолчанию не передаёт его поставщику, кроме каналов с соответствующим разрешением. Можно не указывать. ## Размеры статичных изображений и SVG Точные ширина и высота должны быть кратны 16; каждая сторона — не более 3840, отношение длинной стороны к короткой — не более 3:1, общее число пикселей — 655 360–8 294 400. Разрешения выше 2560×1440 экспериментальные. Таблица совпадает с GPT-Image-2.5; эти ограничения нельзя напрямую применять к отдельному кадру GIF. | `size` | `1k` | `2k` | `4k` | | - | - | - | - | | `1:1` | 1024×1024 | 2048×2048 | 2880×2880 | | `3:2` | 1536×1024 | 2048×1360 | 3520×2336 | | `2:3` | 1024×1536 | 1360×2048 | 2336×3520 | | `4:3` | 1024×768 | 2048×1536 | 3312×2480 | | `3:4` | 768×1024 | 1536×2048 | 2480×3312 | | `5:4` | 1280×1024 | 2560×2048 | 3216×2576 | | `4:5` | 1024×1280 | 2048×2560 | 2576×3216 | | `16:9` | 1536×864 | 2048×1152 | 3840×2160 | | `9:16` | 864×1536 | 1152×2048 | 2160×3840 | | `2:1` | 2048×1024 | 2688×1344 | 3840×1920 | | `1:2` | 1024×2048 | 1344×2688 | 1920×3840 | | `21:9` | 2016×864 | 2688×1152 | 3840×1648 | | `9:21` | 864×2016 | 1152×2688 | 1648×3840 | | `3:1` | 1536×512 | 3072×1024 | 3840×1280 | | `1:3` | 512×1536 | 1024×3072 | 1280×3840 | ## Редактирование и маски Пример изменяет область первого изображения. Без `mask_url` редактируется всё изображение согласно описанию; без `size` размер выбирается по пропорциям первого изображения и `resolution`. Замените примерные URL доступными файлами. ```json theme={null} { "model": "gpt-image-2.6-sunburst", "prompt": "Replace the fully transparent masked area with a gold ribbon. Preserve the product and the rest of the background.", "image_urls": [ "https://example.com/product.png" ], "mask_url": "https://example.com/product-mask.png", "resolution": "2k", "quality": "high", "complexity": "low" } ``` ## Редактирование по разметке Передайте `markup_url` как HTTPS URL или Base64 Data URL. Псевдоним `markup` принимает строку или объект `{"image_url":"..."}`. `file_id` не поддерживается. * Обязательно передайте `image_urls`. Разметка относится к первому изображению, остальные используются как образцы. * Используйте отдельный прозрачный PNG-слой точно тех же размеров, что и первое изображение. Не объединяйте пометки с оригиналом. * Первое изображение и слой — не более 16 777 216 пикселей каждый; файл слоя — не более 50 MB. * Нельзя сочетать с `mask_url`. Слой не расходует токены изображений, но запрос может расходовать дополнительные текстовые токены. ```json theme={null} { "model": "gpt-image-2.6-flare", "prompt": "Recolor the striped vase inside the red circle to solid cobalt blue ceramic. Keep everything else unchanged. Remove the red circle.", "image_urls": [ "https://example.com/kitchen.webp" ], "markup_url": "https://example.com/vase-circle-overlay.png", "quality": "medium" } ``` ## Анимированные GIF Укажите `output_format: "gif"`. Только генерация по тексту: не передавайте `image_urls`, `mask_url`, `markup_url`, `markup` или `output_compression`. | Параметр | По умолчанию | Описание | | - | - | - | | `frame_count` | `9` | Целое число **2–16**. Текущий предел APIMart — 16 кадров; ограничение в 64 кадра из руководства поставщика здесь не применяется. | | `frame_duration_ms` | `200` | Длительность кадра в целых миллисекундах, минимум 20, округляется с шагом 10 мс. | | `size` | `auto` | Размер **каждого кадра** в пикселях; обе стороны кратны 16. Без поля или с `auto` сейчас используется 512×512. Пропорции вроде `1:1` недопустимы. | Поставщик размещает кадры на общем листе: 4×2 для 2–8 кадров, 3×3 для 9, 4×3 для 10–12 и 4×4 для 13–16. Строки и столбцы могут меняться местами для формы, близкой к квадрату. Весь лист должен иметь стороны не более 3840, не более 8 294 400 пикселей и пропорции не более 3:1, иначе отправка вернёт 400. > [!WARNING] > > `512x512` допускает все 2–16 кадров; `768x768` — максимум 12. Даже 2 кадра `1024x1024` превышают предел стороны общего листа. Каждая анимация оплачивается по всему листу; `n > 1` создаёт несколько отдельно оплачиваемых анимаций. ```json theme={null} { "model": "gpt-image-2.6-sunburst", "prompt": "A paper lantern swaying gently in the night breeze, seamless loop", "output_format": "gif", "frame_count": 9, "frame_duration_ms": 200, "quality": "low" } ``` ## Вывод SVG **svg** `object` Укажите `output_format: "svg"`. Модель изображений создаёт образец, затем текстовая модель из `svg.model` пишет SVG. **svg** **model** `string` *required* Обязателен. Выберите модель с тарификацией текстовых токенов на платформе, например `gpt-5.4-mini` или `gpt-5.6-sol`. **reasoning** `object` **reasoning** **effort** `string` Необязательно: `none` / `minimal` / `low` / `medium` / `high` / `xhigh` / `max`. Поддерживаемые значения зависят от текстовой модели. Рекомендуется не указывать поле, используя её настройку по умолчанию. * Только генерация по тексту, `n` равен 1. Нельзя передавать исходные изображения, маски, разметку или `output_compression`. * `quality` и `complexity` применяются к промежуточному образцу. Результат — статичный `.svg` без скриптов, внешних ресурсов и встроенных растровых изображений. * Помимо генерации изображения оплачивается текстовый расход `svg.model`. Аккаунты с фиксированной платой за изображение пока не поддерживают SVG; отправка вернёт 400. ```json theme={null} { "model": "gpt-image-2.6-flare", "prompt": "A minimalist bakery logo with a wheat stalk, flat colors", "output_format": "svg", "svg": { "model": "gpt-5.4-mini" }, "size": "1:1", "quality": "low", "n": 1 } ``` ## Получение результата задачи Опрашивайте [API статуса задачи](https://docs.apimart.ai/ru/api-reference/tasks/status.md) каждые 2–5 секунд до `completed` или `failed`. Не отправляйте запрос генерации повторно во время ожидания. ```bash theme={null} curl --request GET \ --url https://api.apimart.ai/v1/tasks/task_01KXXXXXXXXXXXXXXX \ --header 'Authorization: Bearer ' ``` После завершения получите URL из `data.result.images[].url[]` и своевременно скачайте файлы. Ниже показаны только основные поля. При `failed` проверьте `data.error.message`. Для нескольких задач используйте `POST /v1/tasks/batch`. ```json theme={null} { "code": 200, "data": { "id": "task_01KXXXXXXXXXXXXXXX", "status": "completed", "progress": 100, "result": { "images": [ { "url": [ "https://upload.apimart.ai/f/image/example.png" ] } ] } } } ``` ### Расход токенов SVG и пример ответа В ответе на запрос задачи `data.usage.svg_usage` содержит расход текстовой модели, создающей SVG. Остальные поля токенов в `data.usage` относятся к модели изображений, генерирующей образец. Каждая часть учитывается по правилам тарификации соответствующей модели. | Поле | Тип | Описание | | - | - | - | | `model` | string | Текстовая модель, фактически использованная для создания SVG. | | `input_tokens` | integer | Входные токены текстовой модели. | | `output_tokens` | integer | Выходные токены текстовой модели, включая токены рассуждений. | | `reasoning_tokens` | integer | Часть выходных токенов, потраченная на рассуждения; не прибавляйте её к `output_tokens` повторно. | Ниже показаны основные поля ответа задачи SVG. Числа токенов иллюстрируют связи между полями, а не фиксированный расход. ```json theme={null} { "code": 200, "data": { "id": "task_01KXXXXXXXXXXXXXXX", "status": "completed", "progress": 100, "result": { "images": [ { "url": [ "https://upload.apimart.ai/f/image/example.svg" ] } ] }, "usage": { "input_tokens": 40, "output_tokens": 1800, "total_tokens": 1840, "svg_usage": { "model": "gpt-5.4-mini", "input_tokens": 1200, "output_tokens": 800, "reasoning_tokens": 200 } } } } ``` ## Частые ошибки параметров Следующие ошибки проверки параметров синхронно возвращают HTTP 400 при отправке. Задача не создаётся, плата не взимается. Исправьте параметры перед повторной отправкой. | Ошибка | Решение | | - | - | | `quality "ultra" is not supported by gpt-image-2.6-flare` | Используйте `low` / `medium` / `high` / `xhigh` / `max` / `auto`; другие значения, например `ultra`, не поддерживаются. | | `` `n` must be an integer from 1 to 4 `` | Задайте `n` целым числом от 1 до 4; `0`, отрицательные значения и значения больше 4 недопустимы. | | `output_compression must be an integer from 0 to 100` | Задайте `output_compression` целым числом от 0 до 100. | | `output_compression is only supported with output_format jpeg or webp` | Используйте сжатие только для JPEG / WebP; для PNG / GIF / SVG удалите параметр. | | `moderation "xxx" is not supported` | Задайте `moderation` как `low` или `auto`. | | `markup requires image_urls` | Добавьте `image_urls` и согласуйте слой с первым изображением. | | `markup cannot be combined with mask` | Используйте либо разметку, либо маску. | | `frame_count must be an integer from 2 to 16` | Задайте `frame_count` целым числом от 2 до 16. | | `no supported sheet fits N GIF frames at size WxH` | Уменьшите размер или число кадров; не используйте названия пропорций. | | `output_format=svg requires svg.model` | Добавьте объект `svg` с поддерживаемой текстовой моделью. | | `output_format=svg requires n=1` | Для SVG задайте `n: 1`. | | `background=transparent requires an alpha-capable output_format` | Явная прозрачность требует PNG / WebP; для SVG не указывайте поле. | ## Неподдерживаемые параметры и оплата Не передавайте `stream`, `partial_images`, `input_fidelity`, `prompt_rewriter` или `response_format`. API возвращает асинхронные задачи и CDN URL, а не поток частичных изображений или ответы с изображениями Base64. `frame_count` / `frame_duration_ms` используются только для GIF, конфигурация `svg` — только для SVG. Flare и Sunburst используют одинаковую тарификацию. GPT-Image-2.6 расходует больше токенов при `low` / `medium`, чем 2.5, поэтому не переносите старые оценки без изменений. Актуальные тарифы доступны на [странице цен APIMart](https://apimart.ai/pricing) или через `/api/pricing`; фиксированные цены здесь не приводятся. Описание функций поставщика приведено в [руководстве OpenAI по генерации изображений](https://developers.openai.com/api/docs/guides/image-generation). Для APIMart используйте указанные здесь эндпоинты, асинхронные ответы и ограничения. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.