1. Отримання API Key
Відкрийте список застосунків Ace Data Cloud, перейдіть до доступного застосунку та скопіюйте API Key.
2. Надсилання першого запиту
data[].url. Нижче наведено фактичний результат 1024×1536, отриманий через Ace Data Cloud 8 вересня 2026 року (завдання d56455e2-e7f7-4bcd-b935-475b0a1e0948, trace eb938601-8192-407f-b539-1e0554b697ec):
3. Поширені параметри
Поширені розміри:
size: "auto" вибирає формат кадру відповідно до пропорцій, пікселів і наміру компонування в підказці; якщо потрібні точні пікселі, вкажіть розмір безпосередньо.
Моделі та способи тарифікації
Ціна на сторінці для каналів офіційного API є оцінкою перед запитом; остаточна сума визначається фактичним використанням Token у відповіді та записами про використання.
4. Генерація кількох зображень
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 текстового вводу й виводу зображень у відповіді. Ціна на сторінці є оцінкою перед запитом, остаточна сума визначається записами про використання.
5. Асинхронний зворотний виклик
Після додаванняcallback_url до тіла запиту інтерфейс спочатку поверне {"task_id": "..."}, а після завершення надішле остаточний результат методом POST на цей URL; синхронні запити, як і раніше, повертають created і data:
task_id для дедуплікації та перевіряти джерело запиту й формат даних.
6. Усунення помилок
Відповідь із помилкою міститиме
error.code, error.message і trace_id. Під час повідомлення про проблему надайте trace_id, не надавайте API Key.
Повний перелік полів і актуальні значення дивіться на сторінці OpenAI Images Generations API. Для редагування зображень дивіться редагування зображень GPT Image 2 / 2.5.
