Перейти до основного вмісту

1. Отримання API Key

Відкрийте список застосунків Ace Data Cloud, перейдіть до доступного застосунку та скопіюйте API Key. Отримання Ace Data Cloud API Key

2. Редагування за допомогою URL зображення

Оригінальне зображення: Оригінальне зображення для редагування GPT Image 2
Успішна відповідь:
Це результат редагування, фактично виконаного через Ace Data Cloud 8 вересня 2026 року: чашка стала помаранчевою, фон — темно-синім, при цьому збережено оригінальну композицію та розмір 1024×1536: Результат редагування GPT Image 2 з помаранчевою чашкою

3. Завантаження локального зображення

Використовуйте multipart/form-data:
image можна передавати повторно; серія GPT Image підтримує до 16 референсних зображень. image у JSON-запиті може бути одним URL або масивом URL; локальні файли завантажуються через multipart.

Моделі та спосіб тарифікації

Ціна на сторінці для каналу офіційного API є оцінкою до запиту; остаточна сума визначається фактичним використанням Token у відповіді та записами про використання.

4. Локальне редагування за допомогою маски

Офіційний інтерфейс Images Edit використовує mask для визначення області, яку дозволено змінювати. Моделі Ace Data Cloud :official дотримуються того самого multipart-контракту:
  • mask має бути PNG з Alpha-каналом і розміром не більше 4 МБ;
  • розмір маски має повністю збігатися з першою image;
  • прозорі пікселі з Alpha 0 означають, що редагування дозволене, непрозорі пікселі означають, що їх слід зберегти;
  • RGB-зображення, що мають лише чорно-білий колір, але не мають каналу прозорості, не можуть бути дійсною маскою;
  • промпт має описувати очікуване повне зображення, водночас чітко зазначаючи локальні зміни та вміст, який має залишитися незмінним.
Нижче спочатку створюється маска з оригінального зображення. У прикладі центральний прямокутник робиться прозорим, що дозволяє моделі змінювати лише цю область:
Потім завантажте оригінальне зображення та маску разом:
Також можна продовжувати використовувати спосіб виклику images.edit офіційного Python SDK OpenAI, потрібно лише вказати Ace Data Cloud у base_url:
Під час використання mask оригінальне зображення та маску потрібно завантажувати в одному multipart-запиті окремо через image=@input.png і mask=@mask.png. Не передавайте разом URL оригінального зображення та локальний файл маски; запити на редагування лише з URL не підтримують додавання локального файлу mask. Маска обмежує область редагування, але модель генерації все одно може природно змішувати краї; якщо потрібні суворі межі, слід використовувати чіткі Alpha-краї та повторно зазначити в промпті, який вміст має залишитися незмінним. Наведений вище спосіб виклику відповідає прикладам масок у OpenAI Image Edit API та офіційному Cookbook GPT Image.

5. Поширені параметри

Правила розмірів узгоджуються з інтерфейсом генерації: ширина й висота повинні бути кратними 16, довша сторона не має перевищувати 3840, загальна кількість пікселів становить 655,360–8,294,400, а співвідношення сторін не перевищує 3:1. Якщо size пропущено або використовується auto, модель вибере формат кадру на основі підказки та першого референсного зображення. За gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst і gpt-image-2:reverse стягується плата за кількістю успішних зображень; gpt-image-2:official, gpt-image-2.5-flare:official і gpt-image-2.5-sunburst:official оплачуються на основі фактичних Token текстового введення, введення референсних зображень і виведення зображень, остаточні дані визначаються записами про використання.

6. Асинхронний зворотний виклик і налагодження

До довготривалих запитів можна додати:
Асинхронна відповідь 200 має вигляд {"task_id": "..."}; після завершення надсилається зворотний виклик із фінальним результатом. Синхронні запити натомість повертають created і data. Відповідь про помилку міститиме trace_id. Під час повідомлення про проблему надайте цей ID, не надавайте API Key. Повний перелік полів і актуальні переліки значень наведено на сторінці OpenAI Images Edits API. Для генерації зображень лише з тексту дивіться Генерація зображень GPT Image 2 / 2.5.