--- title: API генерации изображений для ecommerce-каталога description: "GPT Image для изображений товаров: генерация, редактирование по исходникам, проверка товара, бюджет обработки и SEO." url: https://apitoken.sale/ru/docs/learn/image-generation-api-for-ecommerce language: ru --- # 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. Проверяйте геометрию, надписи и сохранение товара перед приёмкой. ## Генерация и редактирование с одним ключом Отправьте 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, защищающий товар 1. Нормализуйте исходную фотосъёмку и присвойте каждому входному файлу immutable SKU/asset version. 2. Запишите brief как allowed changes плюс protected traits: silhouette, color, logo, labels и комплектные accessories. 3. Сгенерируйте один bounded candidate и проверьте product identity, отрисованный текст, artifacts, composition и policy compliance. 4. Сохраните original, output, prompt version, model, request ID, terminal usage и reviewer verdict как одну durable запись. 5. Публикуйте только оптимизированную 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%. Сравнивайте реальный расход и принятые результаты. --- Get a key: https://apitoken.sale/register More guides: https://apitoken.sale/ru/docs/learn