Workflow генерации изображений для ecommerce-каталога через API
Product imagery — сначала задача сохранения identity, затем prompt writing. Зафиксируйте свойства товара, разрешите только названные изменения сцены, валидируйте каждый output и оптимизируйте цену после надёжного acceptance gate.
·
Выберите GPT Image для своего каталога
GPT Image 2, GPT Image 2.5 Flare и GPT Image 2.5 Sunburst используют одни маршруты OpenAI Images, ключ и предоплаченный баланс. Flare подходит для быстрой повседневной работы, Sunburst — для более точного редактирования. Сравнивайте модели по результатам, которые прошли вашу проверку. У всех трёх одинаковые опубликованные ставки за токены.
POST /v1/images/edits принимает от одного до пяти файлов PNG, JPEG или WebP размером до 50 МБ каждый в поле image или image[]. ID моделей те же, что для генерации. Поле mask в multipart игнорируется; для редактирования области используйте инструмент image_generation в Responses. Проверяйте геометрию, надписи и сохранение товара перед приёмкой.
Читайте также: Редактируйте изображения через GPT Image 2, Flare и Sunburst
Генерация и редактирование с одним ключом
Отправьте Bearer-ключ в POST /v1/images/generations на router.apitoken.sale. Выберите gpt-image-2, gpt-image-2.5-flare или gpt-image-2.5-sunburst. По умолчанию ответ содержит PNG в data[0].b64_json; декодируйте, проверьте и сохраните его.
curl https://router.apitoken.sale/v1/images/generations \
-H "Authorization: Bearer $APITOKEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2.5-flare","prompt":"A studio photo of a ceramic mug","n":1,"quality":"low","size":"auto"}'POST /v1/images/edits принимает от одного до пяти файлов PNG, JPEG или WebP размером до 50 МБ каждый в поле image или image[]. ID моделей те же, что для генерации. Поле mask в multipart игнорируется; для редактирования области используйте инструмент image_generation в Responses. Проверяйте геометрию, надписи и сохранение товара перед приёмкой.
Параметр size задаёт пропорции, а не точное число пикселей. Повышенное значение quality не гарантирует более высокий нативный уровень качества. Маршруты Images возвращают base64; jpeg/webp получаются локальной конвертацией нативного PNG. Перед использованием параметров прочитайте руководство модели.
Production workflow, защищающий товар
- 01Нормализуйте исходную фотосъёмку и присвойте каждому входному файлу immutable SKU/asset version.
- 02Запишите brief как allowed changes плюс protected traits: silhouette, color, logo, labels и комплектные accessories.
- 03Сгенерируйте один bounded candidate и проверьте product identity, отрисованный текст, artifacts, composition и policy compliance.
- 04Сохраните original, output, prompt version, model, request ID, terminal usage и reviewer verdict как одну durable запись.
- 05Публикуйте только оптимизированную web derivative; base64 payload из API нельзя отдавать на витрину напрямую.
PRODUCT: SKU-1042, matte black bottle, silver cap, logo unchanged ALLOWED: replace the background with a warm kitchen scene PROTECTED: silhouette, cap shape, logo spelling, label colors OUTPUT: one centered catalog hero image; no added text or accessories
Prompt — это инструкция, а не гарантия. Только validation по protected traits не даёт перегенерированному фону незаметно превратиться в другой товар.
Бюджет по измеренному расходу токенов
| Расход за 1 млн токенов | Официально | Обычный B2C · скидка 50% |
|---|---|---|
| Входной текст | $5 | $2.50 |
| Кешированный текст | $1.25 | $0.625 |
| Входные изображения | $8 | $4 |
| Кешированные изображения | $2 | $1 |
| Выходные изображения | $30 | $15 |
Например, редактирование с 900 свежими текстовыми входными токенами, 1 200 входными токенами изображения и 4 000 выходными токенами изображения стоит $0.1341 официально, или $0.06705 для обычного B2C. Число токенов в примере не гарантируется для каждой картинки. Для своих расчётов используйте итоговый usage и списание по соответствующему запросу.
Для каталога или пакетной обработки разделите все списания на число принятых изображений. Включайте оплаченные результаты, которые не прошли проверку. У GPT Image нет бесплатного countTokens: измерьте небольшую оплачиваемую выборку и задайте лимит расхода до запуска очереди.
Публикуйте изображения, полезные для SEO витрины
- Считайте settled cost на принятый SKU image, а не request count: retries и rejects — часть acquisition cost.
- Проверяйте реальные размеры результата перед подготовкой адаптивных изображений для витрины.
- Используйте descriptive filenames и правдивый alt text про реальный товар и сцену; не набивайте alt названиями моделей или списками ключевых слов.
- Кодируйте responsive WebP/AVIF derivatives, храните lossless master и публикуйте явные width/height против layout shift.
- Держите provenance и review evidence вне public metadata, если там internal IDs или prompts.
Частые вопросы
Можно ли здесь делать transparent cutouts через GPT Image 2?
Да. Передайте background=transparent на POST /v1/images/generations или /v1/images/edits. Это запрос PNG с настоящим альфа-каналом; проверьте файл — отсутствие альфы всё равно HTTP 200. size по-прежнему пресет пропорции, а не фиксация пикселей.
Как не дать модели изменить сам товар?
Опишите в brief protected traits — silhouette, colors, logo spelling, label text, — дайте чистые references, меняйте по одному названному элементу за раз и отклоняйте любой кандидат, не прошедший product-identity validation. Prompt сужает пространство поиска; каталог защищает только acceptance gate.
Покрывает ли скидка 50% расходы на CDN и review?
Нет. Она применяется к exact official model usage обычных B2C-аккаунтов — запросам на генерацию и edits. Storage, WebP/AVIF transformation, CDN delivery, human review и rejected assets — отдельные application costs, которые остаются в вашем business case.
Отличаются ли ставки GPT Image 2, Flare и Sunburst?
У всех трёх одинаковые ставки: $5 за текстовый вход, $8 за вход изображений и $30 за выход изображений на 1 млн токенов до обычной B2C-скидки 50%. Сравнивайте реальный расход и принятые результаты.
Создайте аккаунт, пополните баланс и выпустите API-ключ для поддерживаемых моделей Claude, GPT и Gemini.