GPT Image 2.6: руководство по API — черновики, финалы и нюансы миграции

AIHubMix8 мин чтения
GPT Image 2.6: руководство по API — черновики, финалы и нюансы миграции

Переход с GPT Image 2.5 на 2.6 для базового вызова генерации изображений сводится к смене ID модели. Эндпоинты не меняются, тарифы на токены остаются прежними, как и три рекомендуемых размера. Внимания требуют три момента: Batch, доступный в 2.5, но не в 2.6; инструмент генерации изображений в Responses, который в материалах OpenAI для 2.5 и 2.6 описан по-разному; а также параметры complexity, SVG, GIF и markup — они описаны для Image API OpenAI, но пока отсутствуют в опубликованной схеме параметров AIHubMix.

В этом руководстве мы проведём через AIHubMix типичную задачу: создадим постер размером 1536x1024 с заголовком и изображением товара. Сначала подготовим три недорогих черновика во Flare, выберем один и отрендерим финал в Sunburst, указав стоимость каждого этапа. По пути разберём проблемы миграции, которые проявляются незаметно, а не вызывают явную ошибку.

Что остаётся без изменений

Две модели 2.6 — gpt-image-2.6-sunburst и gpt-image-2.6-flare. Обе вызываются через v1/images/generations и v1/images/edits; у них нет обычного псевдонима gpt-image-2.6. Текст на входе стоит $5 за миллион токенов, изображения на входе — $8, а изображения на выходе — $30, как и у 2.5 и GPT Image 2.

Это значит, что конвейер на базе Image API сохранит прежнюю структуру запросов. Изменится строка модели — и то, только если вы захотите использовать новую модель. Согласно странице модели AIHubMix, главное основание для перехода уже сейчас — заявленное увеличение скорости семейства на 50%.

Нюансы миграции

Batch больше нет

Это единственное преимущество 2.5, которое не вызывает сомнений. На странице модели GPT Image 2.5 указано, что поддерживается v1/batch, а изображения на выходе в Batch стоят $15 за миллион токенов вместо $30. На странице модели GPT Image 2.6 указано, что Batch не поддерживается, а в таблице цен на Batch обе модели 2.6 отсутствуют.

Если вы запускаете ночные задания по генерации изображений, не переводите их на 2.6. Оставайтесь на 2.5 или разделите нагрузку: интерактивные черновики — на 2.6, пакетный рендеринг — на 2.5. В документации AIHubMix по изображениям нет эндпоинта Batch, поэтому это решение касается только прямых вызовов OpenAI.

Проверьте конвейеры на базе Responses

В материалах самой OpenAI есть расхождения по поводу 2.5. В сентябрьском журнале изменений наряду с Image API указан инструмент генерации изображений в Responses API, но на странице модели 2.5 сказано, что Responses не поддерживается. Для 2.6 картина яснее: на странице модели указано, что Responses не поддерживается, а в ноябрьском журнале изменений перечислены только v1/images/generations и v1/images/edits.

Если ваш код обращается к 2.5 через Responses, добавьте дымовой тест перед сменой ID модели. Здесь сбой будет явным, но только если вы его проверяете; конвейер, который незаметно переключается на другую модель, хуже, чем ошибка 400.

Новые параметры доступны только в Image API

В руководстве по генерации изображений для Image API описаны complexity, редактирование с разметкой, вывод в SVG и вывод анимированных GIF. Ни одна из этих функций недоступна через инструмент генерации изображений в Responses, а SVG и GIF можно только генерировать — они не работают с /v1/images/edits.

У каждой функции есть свои ограничения. Для SVG требуется n=1; потоковая передача, частичные изображения, output_compression и prompt_rewriter не поддерживаются. Для GIF используются frame_count (по умолчанию 9) и frame_duration_ms (по умолчанию 200); GIF можно только генерировать, также не поддерживаются потоковая передача, частичные изображения, пользовательский output_compression и prompt_rewriter. Для редактирования с разметкой нужно передать исходное изображение первым, а отдельным файлом — прозрачный PNG того же размера; ни одно из изображений не должно превышать 16,777,216 пикселей, а размер файла разметки ограничен 50 MB. Не сочетайте markup с mask или prompt_rewriter.

Для SVG также действует особое правило тарификации: за эталонное изображение вы платите по тарифу модели для изображений, а за токены, использованные для создания SVG, — по тарифу модели, которая его создаёт. Итоговая стоимость зависит от обоих тарифов, поэтому обычная оценка цены за изображение здесь неприменима.

В документации расходятся сведения о качестве и размере

Для 2.5 OpenAI указывает пять явных уровней качества помимо auto: low, medium, high, xhigh и max. Для 2.6 калькулятор стоимости в руководстве перечисляет те же пять уровней для обеих моделей, справочник API связывает xhigh и max только со снапшотами 2.5, а в таблице AIHubMix с ценами за изображение — источнике оценок стоимости ниже — указаны только low, medium, high и auto.

На данный момент безопасно использовать в 2.6 low, medium, high и auto. То же предостережение касается размеров: пользовательские значения WIDTHxHEIGHT описаны для GPT Image 2 и 2.5, а в руководстве по 2.6 рекомендуются 1024x1024, 1536x1024 и 1024x1536. Используйте три рекомендованных размера, пока документация по 2.6 не станет согласованной.

При переходе с 1.5 высокое качество в размере 1024x1024 обходится дороже

GPT Image 1.5 и 1-mini будут выведены из эксплуатации 1 декабря 2026 года; в качестве замены названа 2.5. Если вы в основном создаёте изображения размером 1024x1024 с высоким качеством, переход обойдётся недёшево: согласно таблице OpenAI, высокое качество в 1.5 стоит $0.133, а оценка AIHubMix для 2.6 составляет $0.211 — примерно на 59% дороже. Для среднего качества цена вырастет с $0.034 до $0.053, а для низкого, наоборот, снизится с $0.009 до $0.006. Для размера 1536x1024 высокое качество в 1.5 стоит $0.200, поэтому цена 2.6 — $0.165 — ниже.

Перед тем как сделать вывод о преимуществах 2.6, прогоните ту же нагрузку на 2.5: тарифы на токены идентичны, поэтому разница между двумя моделями 2.x заключается в расходе токенов, а не в ценах.

Вызов 2.6 через AIHubMix

AIHubMix предоставляет доступ к обеим моделям 2.6 по официальным тарифам. В документации AIHubMix по генерации изображений описан новый эндпоинт — POST https://aihubmix.com/ai/v1/images/generations. Он принимает параметры model, prompt, n, size, output_format, image, images, mask, async, extra и два поля вебхука.

Важно учитывать, где указывается качество. У /ai/v1/images/generations нет поля верхнего уровня quality; его нужно передавать внутри extra:

curl -s https://aihubmix.com/ai/v1/images/generations \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-flare",
    "prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline",
    "size": "1024x1024",
    "n": 3,
    "extra": { "quality": "low" }
  }'

В ответе будет один или несколько URL выходных изображений. Они действуют недолго — примерно 30 минут — и для их скачивания нужно передать тот же заголовок Authorization: Bearer $AIHUBMIX_API_KEY:

curl -s -H "Authorization: Bearer $AIHUBMIX_API_KEY" "<output-url>" -o draft-1.png

В документации AIHubMix рекомендуется использовать /ai/v1 для новых интеграций: OpenAI-совместимые эндпоинты /v1 могут пока не поддерживать самые новые модели, а в списке моделей в устаревшем справочнике по изображениям есть gpt-image-2, gpt-image-1.5, gpt-image-1-mini и модели DALL·E, но нет 2.6. В схеме для каждой модели действительно есть запись /v1/images/generations для 2.6, однако /ai/v1 — это путь, который AIHubMix указывает для 2.6 и который поддерживает асинхронные задачи и вебхуки.

Какие параметры отсутствуют в схеме

В опубликованной схеме AIHubMix для 2.6 в качестве значений output_format принимаются только png, jpeg и webp. В ней нет параметров complexity, markup, frame_count и frame_duration_ms, а также вывода в формате svg или gif. Схема доступна без аутентификации по адресу https://aihubmix.com/call/schema/models/gpt-image-2.6-flare/endpoints; прежде чем полагаться на любую из этих функций через шлюз, проверьте её.

Это пробел в схеме, а не подтверждённый сбой: функции описаны со стороны OpenAI, и шлюз может добавить их позднее. Пока они не появятся в схеме, планируйте задачи с SVG, GIF и разметкой как прямые вызовы OpenAI.

Каких ошибок ожидать

Статус Значение Что делать
400 Ошибка параметра, часто передаваемая от провайдера Проверьте prompt, size и n
401 Отсутствующий или недействительный ключ Проверьте заголовок Authorization
402 Недостаточно квоты Пополните баланс
403 Доступ запрещён Проверьте учётную запись, разрешения ключа и ограничения по IP
429 Превышено ограничение скорости Увеличьте интервал и повторите запрос
503 Нет доступного канала для обработки запроса Проверьте ID модели и повторите запрос позже

В телах ошибок AIHubMix содержится идентификатор трассировки tid. Сохраните его для обращения в поддержку и не повторяйте запрос 400 без изменений. Это правила для /ai/v1; в устаревших эндпоинтах /v1 вместо этого при недостаточной квоте возвращается 403 insufficient_user_quota.

Рабочий процесс: три черновика, один финал

Задача — создать постер с изображением товара и заголовком. Промпт остаётся неизменным; меняются только модель, размер и качество.

Шаг 1 — черновики во Flare. Один запрос с n=3 при размере 1024x1024 и низком качестве вернёт три варианта. При расчётной стоимости $0.006 за изображение этот этап обойдётся в $0.018.

Шаг 2 — выбрать один вариант. Это недорогая часть процесса, и именно здесь скорость модели приносит наибольшую пользу. Три черновика за один вызов — обычные расходы, а не излишество.

Шаг 3 — отрендерить финал в Sunburst. Выбранную композицию генерируем заново с тем же промптом, но в размере 1536x1024 и с высоким качеством. При расчётной стоимости $0.165 за изображение это самый дорогой этап: один финальный вариант стоит примерно в 28 раз дороже одного черновика и примерно в девять раз дороже этапа с тремя черновиками.

curl -s https://aihubmix.com/ai/v1/images/generations \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst",
    "prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline. Refined studio product photography, subtle shadow, no text",
    "size": "1536x1024",
    "n": 1,
    "extra": { "quality": "high" }
  }'

Шаг 4 — подсчитать итог. Расчётная стоимость трёх черновиков — $0.018, финального изображения — $0.165, всего $0.183 за четыре выходных изображения. Если финал создавать со средним качеством, он обойдётся в $0.041, а весь запуск — в $0.059. Токены входного текста при такой длине промпта добавляют долю цента; при редактировании добавятся токены входного изображения по тарифу $8 за миллион.

Из этих цифр видно, что разницы в стоимости между двумя моделями нет: те же четыре изображения на 2.5 обойдутся столько же, поскольку расчётная цена AIHubMix за изображение совпадает. 2.6 стоит использовать ради более быстрого цикла подготовки черновиков и возможности позже перенести задачи с SVG или GIF на OpenAI, а не ради экономии.

Список проверки перед миграцией

  • Замените gpt-image-2.5-sunburst и gpt-image-2.5-flare на ID моделей 2.6 там, где нужна новая модель; задания Batch оставьте на 2.5.
  • Проверьте, использует ли какой-либо конвейер инструмент генерации изображений в Responses; в документации 2.6 описан только Image API.
  • Пока документация по 2.6 не придёт к единому виду, используйте только значения качества low, medium, high и auto, а размеры выбирайте из трёх рекомендованных.
  • В /ai/v1 от AIHubMix указывайте качество в extra; для 2.6 используйте /ai/v1 — этот путь AIHubMix рекомендует для новых интеграций.
  • Загрузите файлы по URL результата в течение 30 минут, передав заголовок Bearer.
  • Не рассчитывайте, что через AIHubMix будут работать complexity, markup, SVG или GIF, пока они не появятся в схеме.
  • Если вы используете 1.5, учтите вывод из эксплуатации 1 декабря и заново проверьте стоимость высокого качества.

Часто задаваемые вопросы

Нужно ли менять эндпоинт для GPT Image 2.6?
Для API OpenAI — нет. Используются v1/images/generations и v1/images/edits, как и в 2.5; меняется только ID модели. В AIHubMix используйте /ai/v1/images/generations, как описано выше.

GPT Image 2.6 дешевле 2.5?
Нет. Стоимость токенов одинакова: $5 за миллион входных текстовых токенов, $8 за миллион входных токенов изображений и $30 за миллион выходных токенов изображений.

Почему нельзя использовать Batch с GPT Image 2.6?
На страницах моделей OpenAI для 2.6 указано, что Batch не поддерживается, а в таблице цен на Batch есть 2.5, но нет 2.6. Batch — самый очевидный сценарий, в котором 2.5 остаётся предпочтительным вариантом.

Как задать качество в AIHubMix?
Для 2.6 на /ai/v1/images/generations укажите его в extra.quality. В совместимом с OpenAI эндпоинте /v1/images/generations есть поле верхнего уровня quality, но для новых интеграций AIHubMix рекомендует /ai/v1; для 2.6 используйте /ai/v1.

Можно ли генерировать SVG или GIF через AIHubMix?
Согласно текущей схеме — нет: в ней перечислены png, jpeg и webp, но нет complexity, markup, количества кадров или вывода в SVG/GIF. Эти параметры описаны для Image API OpenAI; прежде чем полагаться на их поддержку через шлюз, проверьте схему.

Как долго действуют URL результатов AIHubMix?
Примерно 30 минут. Загрузите файлы, используя тот же Bearer-токен, и сохраните их у себя.

Что будет с GPT Image 1.5?
Его выведут из эксплуатации 1 декабря 2026 года. OpenAI называет заменой 2.5, но при разрешении 1024x1024 и высоком качестве 2.6 стоит дороже за изображение, чем 1.5; при разрешении 1536x1024 — дешевле.

Читайте дальше: серия GPT Image 2.6

В статье-сравнении рассматриваются таблицы цен, заявление о скорости и сценарии, в которых 2.5 всё ещё выигрывает. Начните с неё, если ещё не решили, стоит ли переходить.
GPT Image 2.6 и 2.5: стоит ли обновляться?

Источники

Один шлюз ко многим провайдерам ИИ. Создан для продакшена.

Перейти на AIHubMix