Генерация изображений GPT-Image-2

• Модель: gpt-image-2
• Эндпоинт: POST https://apimaster.ai/v1/images/generations
• Режим: Асинхронный — возвращает task_id, затем опрашивайте задачу
• Возможности: Текст-в-изображение; изображение-в-изображение с до 16 референсными изображениями (смесь URL и base64)

Аутентификация

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Параметры тела запроса

Поле	Тип	Обязательно	Примечания
model	string	да	gpt-image-2
prompt	string	да	Описание сцены; применяется модерация безопасности
n	integer	нет	Только 1 (число, без кавычек)
size	string	нет	Соотношение сторон, по умолчанию 1:1
resolution	string	нет	1k / 2k / 4k, по умолчанию 1k
image_urls	array	нет	Референсные изображения → изображение-в-изображение
official_fallback	boolean	нет	Откат на официальный канал, по умолчанию false

Значения size

auto, 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21, или строки пикселей, например 3840x2160.

Разрешение (примеры пикселей)

size	1k	2k	4k
1:1	1024×1024	2048×2048	2880×2880
16:9	1536×864	2048×1152	3840×2160

Все 15 соотношений поддерживают 4K.

image_urls

• Максимум 16 изображений
• Публичные URL и base64 data URI могут быть смешаны
• Опустите size, чтобы следовать разрешению входных данных; укажите size, чтобы принудительно задать соотношение сторон выходного изображения

Примеры

Минимальный текст-в-изображение

{
  "model": "gpt-image-2",
  "prompt": "An orange cat on a windowsill at sunset, watercolor"
}

16:9 @ 2K

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a corgi astronaut on the moon, cinematic",
    "size": "16:9",
    "resolution": "2k"
  }'

Ответ на отправку

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA" }]
}

HTTP	Значение
400	Неверные параметры
401	Неверный ключ API
402	Недостаточно средств
429	Превышен лимит запросов

Опрос результата задачи

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

URL изображения: data.result.images[0].url[0]

status	Значение
submitted	В очереди
processing	Выполняется
completed	Готово
failed	См. ошибку

Опрашивайте через 10–20 с, каждые 3–5 с. Пакетный запрос: POST https://apimaster.ai/v1/tasks/batch с {"task_ids":[...]}.

Примечания

• Только асинхронный режим — в ответе на создание нет синхронного URL изображения.
• Предпочитайте параметр size для соотношения сторон; избегайте повторения соотношения в prompt.
• Тарификация по уровню разрешения; смотрите консоль вашего аккаунта.

Сравните с официальным каналом.