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

Модель рисует картинку по текстовому описанию. Для этого есть два эндпоинта: /v1/images/generations создаёт изображение с нуля, /v1/images/edits переделывает уже существующее по описанию.

Генерация

Обязательных полей два: model и prompt с описанием того, что нужно нарисовать. Дополнительно задаются размер, качество и число вариантов.

curlpythonnode.js
curl "https://api.proxyapi.ru/v1/images/generations" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    -d '{
        "model": "openai/gpt-image-1-mini",
        "prompt": "Деревянный маяк на скале, шторм, вечерний свет",
        "size": "1024x1024"
    }'

Поле n задаёт число вариантов в одном запросе. Каждый оплачивается отдельно.

Редактирование

/v1/images/edits принимает исходное изображение вместе с описанием изменений. Запрос отправляется не в JSON, а как форма с вложенным файлом.

curlpythonnode.js
curl "https://api.proxyapi.ru/v1/images/edits" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    -F "model=openai/gpt-image-1" \
    -F "image=@lighthouse.png" \
    -F "prompt=Сделать утро вместо вечера, добавить чаек"

Часть моделей принимает несколько исходных изображений — тогда они служат образцами стиля или объектов, которые нужно перенести на результат.

Чего здесь нет

• Потоковой генерации. Промежуточные кадры не отдаются, ответ приходит целиком, когда картинка готова.
• Некоторых параметров OpenAI у моделей других вендоров. Настройки вроде moderation, style и input_fidelity поддерживаются не везде, и запрос с ними вернёт ошибку 400.

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

Стоимость

Считается по-разному в зависимости от модели: у одних цена складывается из токенов описания и токенов самого изображения, у других это фиксированная сумма за картинку, зависящая от размера и качества. Что именно и по какой цене — видно в каталоге моделей.

Что дальше

• Распознавание изображений — обратная задача: показать модели картинку.
• Модели — какие модели доступны.