Генерация изображений через API

В публичном каталоге apiprovider.pro для изображений доступны gpt-image-2 и gpt-image-2-edit. Подтверждённый API-маршрут — POST /images/generations. Не используйте параметры, форматы ответа или цены из сторонних примеров без сверки с актуальной документацией.

Путь от регистрации до модели

1. Зарегистрируйтесь.
2. Пополните баланс и дождитесь зачисления.
3. Создайте ключ в разделе API-ключей.
4. Для создания нового изображения выберите gpt-image-2; для редактирования — gpt-image-2-edit.
5. Перед запросом проверьте модель, схему операции и актуальный тариф в документации и на странице цен.

Подробнее о выпуске ключа: как получить GPT API-ключ. Требования к его хранению: безопасность API-ключа.

Подтверждённые параметры подключения

Параметр	Значение
Модели	gpt-image-2, gpt-image-2-edit
Endpoint	POST /images/generations
Base URL	https://api.apiprovider.pro/v1
RU Base URL	https://api.ru.apiprovider.pro/v1
Авторизация	Authorization: Bearer YOUR_API_KEY

Полные адреса:

https://api.apiprovider.pro/v1/images/generations
https://api.ru.apiprovider.pro/v1/images/generations

Пример генерации

Для создания изображения передайте model ID, текстовый prompt, поддерживаемые size и quality, а также n: 1:

curl https://api.apiprovider.pro/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIPROVIDER_API_KEY" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Минималистичная иллюстрация потока данных API, тёмный фон",
    "size": "16:9",
    "quality": "low",
    "n": 1
  }'

Сейчас поддерживается одно изображение за запрос. Допустимые значения size: 1024x1024, 1536x1024, 1024x1536, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21. Для quality доступны low, standard, auto, medium, high.

Пример редактирования

Редактирование использует тот же endpoint, но model ID gpt-image-2-edit и исходное изображение:

{
  "model": "gpt-image-2-edit",
  "prompt": "Замени фон на светлый студийный, сохрани главный объект",
  "image": "<base64-or-image-url>",
  "reference_mode": "edit",
  "size": "1024x1024",
  "quality": "standard",
  "n": 1
}

Исходники также принимаются в полях images, reference_image или reference_images. Для reference_mode доступны auto, edit и remix: режим edit требует ровно одно изображение, remix принимает от одного до шести. Ответ возвращает изображение как b64_json или data URL; перед массовым запуском повторно сверяйте контракт в документации.

Безопасный запуск

Начните с одного типа визуалов в development-окружении. Добавьте:

• лимит генераций на пользователя и задачу;
• очередь и ограничение параллелизма;
• технические статусы без API-ключа;
• проверку изображения человеком перед публикацией;
• правила хранения исходников и результата;
• конечное число повторов для временных ошибок.

Не отправляйте лишние персональные или конфиденциальные данные. Не заменяйте автоматически брендовые материалы и не публикуйте результат наружу до проверки.

Контроль качества и стоимости

Для каждой операции фиксируйте цель, модель, версию задания, число попыток, время, актуальную стоимость и решение принять или отклонить результат. Цены здесь не зафиксированы, потому что они могут меняться; сверяйте их непосредственно перед запуском.

При ошибке последовательно проверьте ключ, Base URL с /v1, маршрут POST /images/generations, доступность model ID, соответствие тела актуальной документации и баланс. Для 429 и временных 5xx допустимы только ограниченные повторы с паузой. Не записывайте ключ и исходные персональные материалы в технические логи.

Для production используйте общий чек-лист эксплуатации GPT API.

Частые вопросы

Какие модели использовать?

gpt-image-2 — для создания изображений, gpt-image-2-edit — для редактирования в соответствии с актуальной схемой API.

Какой endpoint подтверждён?

POST /images/generations на основном или RU Base URL.

Можно ли использовать тот же ключ, что и для текста?

Да, доступные модели используют единый API-ключ и общий баланс. Для production-сервисов разумно разделять ключи по окружениям.

Где посмотреть формат запроса и ответа?

В актуальной API-документации. Не копируйте неподтверждённые параметры из сторонних инструкций.

Запустите одну тестовую генерацию

Создайте аккаунт, пополните баланс, выпустите ключ и проверьте выбранную image-модель по актуальной документации. После оценки результата и расходов подключайте ограниченный production workflow.