Посібник з API GPT Image 2.6: чернетки, фінальні зображення та підводні камені міграції

AIHubMix8 хв читання
Посібник з API GPT Image 2.6: чернетки, фінальні зображення та підводні камені міграції

Щоб перенести базовий виклик для зображень із GPT Image 2.5 на 2.6, потрібно змінити ID моделі. Ендпоінти, тарифи за токени та три рекомендовані розміри залишаються незмінними. Уваги потребують три моменти: Batch, який є в 2.5, але відсутній у 2.6; інструмент генерації зображень у Responses, який у матеріалах OpenAI для версій 2.5 і 2.6 описано по-різному; а також параметри — complexity, SVG, GIF і розмітка, — які описані для 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 є суперечність. У вересневому журналі змін інструмент генерації зображень через Responses API згадується поряд з Image API, але на сторінці моделі 2.5 зазначено, що Responses не підтримується. Щодо 2.6 усе зрозуміліше: на сторінці моделі вказано, що Responses не підтримується, а в листопадовому журналі змін наведено лише v1/images/generations і v1/images/edits.

Якщо ваш код звертається до 2.5 через Responses, перед зміною ID моделі додайте тест працездатності. Помилка буде явною, але лише якщо її перевірити; конвеєр, який непомітно переходить на іншу модель, гірший за помилку 400.

Нові параметри доступні лише в Image API

Посібник із генерації зображень відносить complexity, редагування з підказками на основі розмітки, вивід SVG і анімованих GIF до Image API. Жодна з цих можливостей недоступна через інструмент генерації зображень у 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 не узгодять.

Для 1024x1024 у високій якості перехід із 1.5 обійдеться дорожче

Підтримку 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 для нових інтеграцій: ендпоінти /v1, сумісні з OpenAI, можуть іще не підтримувати найновіші моделі, а в списку моделей у застарілій довідці із зображень є 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.
  • Використовуйте лише значення якості low, medium, high або auto, а для розмірів — три рекомендовані значення, доки документацію для 2.6 не узгодять.
  • На /ai/v1 від AIHubMix указуйте якість у extra; для 2.6 використовуйте /ai/v1 — шлях, який AIHubMix рекомендує для нових інтеграцій.
  • Завантажуйте вихідні зображення за URL протягом 30 хвилин, додаючи заголовок Bearer.
  • Не припускайте, що complexity, markup, SVG чи GIF підтримуються через AIHubMix, доки вони не з’являться в схемі.
  • Якщо ви використовуєте 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