1. Отримання API Key
Відкрийте список застосунків Ace Data Cloud, перейдіть до доступного застосунку та скопіюйте API Key.
2. Редагування за допомогою URL зображення
Оригінальне зображення:
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. Асинхронний зворотний виклик і налагодження
До довготривалих запитів можна додати:{"task_id": "..."}; після завершення надсилається зворотний виклик із фінальним результатом. Синхронні запити натомість повертають created і data.
Відповідь про помилку міститиме
trace_id. Під час повідомлення про проблему надайте цей ID, не надавайте API Key.
Повний перелік полів і актуальні переліки значень наведено на сторінці OpenAI Images Edits API. Для генерації зображень лише з тексту дивіться Генерація зображень GPT Image 2 / 2.5.
