Перейти к основному содержанию

1. Получение API Key

Откройте список приложений Ace Data Cloud, перейдите в доступное приложение и скопируйте API Key. Получение API Key Ace Data Cloud

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.