GETAPI/Документация/Генерация и редактирование изображений

Генерация и редактирование изображений

Запрос изображения, входные файлы и обработка результата

Создание изображения

POST https://api.getapi.ru/v1/images/generations

Выберите модель генерации изображений с поддержкой этого метода. Наличие мультимодальной модели в каталоге само по себе не означает поддержку Images API

Поле	Тип	Обязательное	Описание
`model`	string	Да	ID модели
`prompt`	string	Да	Описание изображения
`size`	string	Нет	Размер из набора, поддерживаемого моделью
`quality`	string	Нет	Уровень качества, если поддерживается
`n`	integer	Нет	Число изображений в пределах лимита модели
`response_format`	string	Нет	Формат результата, если модель позволяет его выбрать

Пример использует gpt-image-1. Проверьте доступность модели и метода для вашего ключа

bash

curl --fail-with-body https://api.getapi.ru/v1/images/generations \
  -H "Authorization: Bearer $GETAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "Керамическая чашка на деревянном столе, мягкий дневной свет",
    "size": "1024x1024",
    "n": 1
  }'

Результат

Элементы массива data могут содержать b64_json с байтами изображения в base64 либо url для загрузки. Не требуйте наличия обоих полей

При base64 декодируйте данные и сохраните файл в фактическом формате ответа. URL может иметь ограниченный срок действия, загрузите нужное изображение в своё хранилище

Не принимайте произвольный URL из ответа за разрешение передать на него API-ключ. Авторизацию GetAPI отправляйте только на адрес сервиса

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

POST https://api.getapi.ru/v1/images/edits

Запрос отправляется как multipart/form-data. Подготовьте файл photo.png и выберите модель с поддержкой редактирования

bash

curl --fail-with-body https://api.getapi.ru/v1/images/edits \
  -H "Authorization: Bearer $GETAPI_API_KEY" \
  -F "model=gpt-image-1" \
  -F "image=@photo.png" \
  -F "prompt=Замени фон на светлую стену"

Не задавайте Content-Type вручную при использовании -F, curl добавит границу multipart

Ограничения

Допустимые размеры, форматы файлов, маски, прозрачность и число результатов задаёт модель. Значения одной модели нельзя переносить на другую без проверки

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

Для анализа существующего изображения используйте изображения на вход

← Совместимость с API OpenAI

Синтез речи →