Ръководство за 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; и контролите — сложност, 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, запазва формата на заявката. Променя се низът на модела и то само ако искате да използвате новия модел. Основната причина за преминаване още в първия ден е твърдението за скорост — семейството е с 50% по-бързо според страницата на модела в AIHubMix.

Подводни камъни при миграция

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.

Ако кодът ви използва Responses за достъп до 2.5, добавете тест за базова функционалност, преди да смените 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), поддържа се само при генериране и също не поддържа поточно предаване, частични изображения, персонализирана стойност за 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 ще бъдат спрени на December 1, 2026, като за заместител е посочен 2.5. Ако генерирате предимно с високо качество при 1024x1024, преминаването няма да е евтино: според таблицата на OpenAI 1.5 генерирането с високо качество струва $0.133, а оценката на AIHubMix за 2.6 е $0.211 — с около 59% повече. Цената за medium се увеличава от $0.034 на $0.053, а за low намалява от $0.009 на $0.006. При 1536x1024 високото качество на 1.5 струва $0.200, така че 2.6 с цена $0.165 е по-евтин при този размер.

Пуснете същия микс и на 2.5, преди да приемете, че 2.6 е по-изгоден: тарифите за токени са еднакви, така че разликата между двата модела от серията 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 приема само стойностите png, jpeg и webp за output_format. Тя не включва 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 Грешка в параметър, често препратена от доставчика Проверете промпта, размера и n
401 Липсващ или невалиден ключ Проверете заглавката Authorization
402 Недостатъчна квота Добавете кредити
403 Достъпът е отказан Проверете акаунта, разрешенията на ключа и ограниченията за IP адреси
429 Достигнато е ограничението на скоростта Изчакайте и опитайте отново
503 Няма канал, който да обработи заявката Проверете ID на модела и опитайте отново по-късно

Телата на грешките от AIHubMix съдържат tid — ID за проследяване. Запазете го за екипа по поддръжката и не повтаряйте непроменена заявка, получила отговор 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, където искате да използвате новия модел; оставете пакетните задачи на 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, предвидете спирането му на December 1 и проверете отново цената за високо качество.

Често задавани въпроси

Трябва ли да сменя крайната точка за GPT Image 2.6?
В API на OpenAI — не. Използва v1/images/generations и v1/images/edits, както и 2.5; променя се само идентификаторът на модела. В AIHubMix използвайте /ai/v1/images/generations, както е описано по-горе.

По-евтин ли е GPT Image 2.6 от 2.5?
Не. Цените за токените са еднакви: $5 за милион входни текстови токени, $8 за милион входни токени за изображения и $30 за милион изходни токени за изображения.

Защо не мога да използвам Batch с GPT Image 2.6?
Страниците на моделите 2.6 в OpenAI посочват, че Batch не се поддържа, а таблицата с цените за Batch включва 2.5, но не и 2.6. Batch е най-ясният пример за работен процес, при който 2.5 остава по-добрият избор.

Как да задам качеството в AIHubMix?
За 2.6 го задайте в extra.quality при /ai/v1/images/generations. Съвместимата с 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?
Поддръжката му се прекратява на December 1, 2026. OpenAI посочва 2.5 като заместител, но при 1024x1024 и високо качество 2.6 струва повече за изображение от 1.5; при 1536x1024 струва по-малко.

Продължете с поредицата за GPT Image 2.6

Статията за сравнение разглежда таблиците с цените, твърдението за скоростта и случаите, в които 2.5 все още е по-добър избор; започнете оттам, ако още не сте решили дали да преминете.
GPT Image 2.6 срещу 2.5: струва ли си надграждането?

Източници

Един шлюз към множество AI доставчици. Създаден за продукционна среда.

Посетете AIHubMix