GPT Image 2.6

GPT Image 2.6 принимает текстовые промпты и необязательные референсные изображения. Отправьте запрос один раз в POST /v1/images/generations, сохраните ID задачи и опрашивайте GET /v1/tasks/{id} для получения результата. Готовые файлы возвращаются в виде URL.

ID моделей и цены

Используйте GET /v1/models, чтобы узнать модели, доступные вашему ключу. Настроенные ID Sunburst: gpt-image-2.6-sunburst-official и gpt-image-2.6-sunburst. ID Flare, если они есть в списке, используют тот же контракт параметров. ID модели без суффикса использует группу Default; дополнительные группы используют ID model:group из списка доступных моделей.

Смотрите текущие цены и Playground. Модели с оплатой за токены рассчитываются по фактическому использованию; модели с оплатой за изображение используют настроенную цену изображения. Ответы SVG отдельно сообщают токены модели, пишущей SVG-код, в svg_usage; они оплачиваются по её собственному тарифу SeedRouter.

Генерация изображения

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

Ответ содержит id. Опрашивайте этот ID, не отправляя генерацию повторно:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

После завершения output.data содержит объекты с url. Скачайте файл по URL, чтобы сохранить исходный формат, а для GIF — все кадры анимации. Неуспешная задача содержит error и не тарифицируется. Смотрите состояния задач и опрос.

Параметры

Всего 18 полей верхнего уровня. Обязательны только model и prompt. Необязательные поля принимают null, что равнозначно отсутствию поля. Неизвестные поля отбрасываются. Некорректные значения поддерживаемых полей отклоняются при проверке до генерации изображения.

URL референсных изображений должны использовать HTTP или HTTPS и не содержать учётных данных. ID файлов, встроенный base64 и multipart-загрузки не принимаются; сначала загрузите файлы и укажите их публичные URL. Запросы используют асинхронный опрос задач вместо stream или partial_images. input_fidelity, response_format и prompt_rewriter не доступны в этом контракте.

Размер изображения

При генерации PNG, JPEG и референсного изображения для SVG каждый размер должен делиться на 16 и не превышать 3840 пикселей. Общее число пикселей — 655 360–8 294 400, соотношение сторон — от 1:3 до 3:1. Примеры: 1024x1024, 1536x1024, 2160x3840, 2880x2880.

Размеры GIF должны быть положительными числами, кратными 16, либо используйте auto. Для GIF действует отдельный общий лимит пикселей, который делят число кадров, размеры кадра и n; OpenAI не опубликовала его числовое значение. Для GIF 512x512 правило минимального числа пикселей статичных изображений не применяется.

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

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

GIF можно создать по промпту или запросить по референсным изображениям. Не сочетайте его с маской или сжатием. Доступность предварительной версии может зависеть от доступа к выбранной модели.

Расхождение документации, проверено 5 ноября 2026 года: руководство OpenAI по генерации изображений указывает 2–64 кадра и 20–2000 мс и сообщает, что конечная точка редактирования не возвращает GIF. Справочник Images API указывает 2–16 кадров без максимальной длительности и перечисляет вывод GIF при редактировании. Запросы к исходному API 5 ноября 2026 года соответствовали справочнику: 17 кадров были отклонены, а кадр длительностью 3 000 мс принят. Этот API следует справочнику.

SVG

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

SVG доступен только при генерации и требует n: 1. Не передавайте изображения, маску, нарисованные пометки или сжатие. Файл — статичный XML в UTF-8 с векторными фигурами; скрипты, внешние ресурсы и встроенные растровые изображения не поддерживаются.

Если доступен выбор модели, пишущей SVG-код, добавьте svg: {"model":"YOUR_AUTHOR_MODEL_ID"}. Явно переданный объект svg требует непустого model. Также можно задать svg.reasoning.effort равным none, minimal, low, medium, high, xhigh или max; поддерживаемые значения зависят от выбранной модели. Опустите reasoning, чтобы использовать её значение по умолчанию. OpenAI не публикует список разрешённых моделей для написания SVG-кода или универсальную модель по умолчанию. Если выбор модели недоступен, опустите весь объект svg.

Готовый результат может содержать svg_usage с model, input_tokens, output_tokens, reasoning_tokens и total_tokens. Эти данные отделены от usage изображения и не являются дополнительным числом токенов изображения.

Референсные изображения, маска и нарисованные пометки

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

Референсные изображения поддерживают PNG, JPEG и WebP, до 50 МБ каждое. Маска и нарисованные пометки должны быть в PNG и совпадать с размерами первого референсного изображения после учёта ориентации. Нарисованные пометки должны содержать прозрачные пиксели; и они, и первое референсное изображение могут содержать не более 16 777 216 пикселей, а файл пометок может занимать не более 50 МБ. Маску и нарисованные пометки нельзя использовать одновременно.

Поля ответа

Готовый вывод изображения содержит created, data: [{url}] и, если сообщаются, size, quality, background, output_format, usage, svg_usage и safety_identifier. usage может отдельно указывать текстовые и графические входные и выходные токены, а также вход из кэша. Публичный вывод не содержит байтов изображения в base64 или полей стоимости.

Схема OpenAPI · Справочник генерации OpenAI · Справочник редактирования OpenAI · Руководство OpenAI по изображениям