GPT-Image-2.6 Генерация изображений

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --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
}'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/images/generations",
    headers={"Authorization": "Bearer <token>"},
    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"])

const response = await fetch("https://api.apimart.ai/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "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);

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KXXXXXXXXXXXXXXX"
    }
  ]
}

POST

images

generations

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --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
}'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/images/generations",
    headers={"Authorization": "Bearer <token>"},
    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"])

const response = await fetch("https://api.apimart.ai/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "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);

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KXXXXXXXXXXXXXXX"
    }
  ]
}

Генерация, редактирование, GIF и SVG используют POST /v1/images/generations. Получите data[0].task_id из ответа, затем запросите результат задачи со ссылками на файлы.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --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
}'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/images/generations",
    headers={"Authorization": "Bearer <token>"},
    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"])

const response = await fetch("https://api.apimart.ai/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "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);

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KXXXXXXXXXXXXXXX"
    }
  ]
}

Аутентификация

string

обязательно

Используйте Bearer Token. Ключ можно получить на странице API-ключей.

Authorization: Bearer YOUR_API_KEY

Выбор модели

Модель	Применение
`gpt-image-2.6-flare`	Быстрая генерация для частых итераций; рекомендуемый вариант по умолчанию.
`gpt-image-2.6-sunburst`	Приоритет детализации и согласованности последовательных правок, особенно при качестве `medium` / `high`.

Тарифы за токен и расход при одинаковых настройках совпадают. Выбирайте по требованиям к скорости и детализации.

Параметры запроса

string

обязательно

Название модели: gpt-image-2.6-flare или gpt-image-2.6-sunburst.

string

обязательно

Описание генерации или правок, до 32 000 символов. Укажите объект, композицию и то, что нужно изменить или сохранить.

string

по умолчанию:"auto"

Статичные изображения и SVG поддерживают 15 соотношений сторон, точные размеры вроде 1600x1200 и auto. Явное auto передаёт выбор поставщику. При редактировании без этого поля размер определяется пропорциями первого изображения и resolution. Для GIF действуют отдельные правила ниже.

string

по умолчанию:"1k"

1k / 2k / 4k, строчными буквами. Вместе с пропорциями в size определяет пиксельные размеры; при точном размере игнорируется.

string

по умолчанию:"auto"

low / medium / high / xhigh / max / auto. Другие значения возвращают HTTP 400 при отправке. Если поле отсутствует или задано auto, модель выбирает уровень качества автоматически. Уровень может меняться и не фиксируется на low. Для фиксированного уровня задайте его явно.Если поле отсутствует или задано auto, средства резервируются по уровню max, а итоговая сумма рассчитывается по фактически выбранному уровню качества.

integer

по умолчанию:"1"

Целое число 1–4; для GIF это число анимаций. SVG требует 1. Явные значения 0, отрицательные числа или значения больше 4 возвращают HTTP 400 и не заменяются значением по умолчанию.

string

по умолчанию:"png"

png / jpeg / webp / gif / svg. GIF и SVG поддерживают только генерацию по тексту. Другие значения возвращают HTTP 400 при отправке.

integer

Целое число от 0 до 100, только для jpeg / webp. Выход за диапазон или сочетание с png / gif / svg возвращает HTTP 400 при отправке.

string

transparent / opaque / auto; без поля используется настройка поставщика. Явное transparent допустимо только с png / webp. Фон SVG прозрачен по умолчанию — не передавайте это поле для SVG.

string

по умолчанию:"low"

Уровень модерации: auto / low. Другие значения возвращают HTTP 400 при отправке.

string[]

До 16 исходных изображений; их передача включает редактирование. Используйте общедоступные HTTP(S) URL. Локальные файлы сначала отправьте через API загрузки изображений, затем передайте полученный url.

string

Маска локального редактирования, требует image_urls. Нужен PNG с альфа-каналом и размерами первого изображения; полностью прозрачные области обозначают зоны правок. Допустим URL или PNG Data URL. Нельзя сочетать с разметкой; точное сохранение пикселей вне маски не гарантируется.

string

Интенсивность планирования: low / medium / high, по умолчанию у поставщика high, независимо от quality. Для локальных правок используйте low, для плотного текста, сложной композиции и связей объектов — high. Более интенсивное планирование может замедлить работу или внести лишние изменения. Отдельная плата не взимается; поддерживается только в 2.6.

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 доступными файлами.

{
  "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. Слой не расходует токены изображений, но запрос может расходовать дополнительные текстовые токены.

{
  "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.

512x512 допускает все 2–16 кадров; 768x768 — максимум 12. Даже 2 кадра 1024x1024 превышают предел стороны общего листа. Каждая анимация оплачивается по всему листу; n > 1 создаёт несколько отдельно оплачиваемых анимаций.

{
  "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

object

Укажите output_format: "svg". Модель изображений создаёт образец, затем текстовая модель из svg.model пишет SVG.

Показать svg

string

обязательно

Обязателен. Выберите модель с тарификацией текстовых токенов на платформе, например gpt-5.4-mini или gpt-5.6-sol.

object

Показать reasoning

string

Необязательно: none / minimal / low / medium / high / xhigh / max. Поддерживаемые значения зависят от текстовой модели. Рекомендуется не указывать поле, используя её настройку по умолчанию.

Только генерация по тексту, n равен 1. Нельзя передавать исходные изображения, маски, разметку или output_compression.
quality и complexity применяются к промежуточному образцу. Результат — статичный .svg без скриптов, внешних ресурсов и встроенных растровых изображений.
Помимо генерации изображения оплачивается текстовый расход svg.model. Аккаунты с фиксированной платой за изображение пока не поддерживают SVG; отправка вернёт 400.

{
  "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 статуса задачи каждые 2–5 секунд до completed или failed. Не отправляйте запрос генерации повторно во время ожидания.

curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01KXXXXXXXXXXXXXXX \
  --header 'Authorization: Bearer <token>'

После завершения получите URL из data.result.images[].url[] и своевременно скачайте файлы. Ниже показаны только основные поля. При failed проверьте data.error.message. Для нескольких задач используйте POST /v1/tasks/batch.

{
  "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. Числа токенов иллюстрируют связи между полями, а не фиксированный расход.

{
  "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 или через /api/pricing; фиксированные цены здесь не приводятся. Описание функций поставщика приведено в руководстве OpenAI по генерации изображений. Для APIMart используйте указанные здесь эндпоинты, асинхронные ответы и ограничения.

Обзор

Модели

Текстовая серия

Серия изображений

Видеосерия

Аудиосерия

Серия модерации

Управление загрузками

Управление задачами

Управление аккаунтом

GPT-Image-2.6 Генерация изображений

Аутентификация

Выбор модели

Параметры запроса

Размеры статичных изображений и SVG

Редактирование и маски

Редактирование по разметке

Анимированные GIF

Вывод SVG

Получение результата задачи

Расход токенов SVG и пример ответа

Частые ошибки параметров

Неподдерживаемые параметры и оплата

​Аутентификация

​Выбор модели

​Параметры запроса

​Размеры статичных изображений и SVG

​Редактирование и маски

​Редактирование по разметке

​Анимированные GIF

​Вывод SVG

​Получение результата задачи

​Расход токенов SVG и пример ответа

​Частые ошибки параметров

​Неподдерживаемые параметры и оплата

Аутентификация

Выбор модели

Параметры запроса

Размеры статичных изображений и SVG

Редактирование и маски

Редактирование по разметке

Анимированные GIF

Вывод SVG

Получение результата задачи

Расход токенов SVG и пример ответа

Частые ошибки параметров

Неподдерживаемые параметры и оплата