Skip to main content
Используйте /v1/images/generations для генерации изображения из текстового запроса и /v1/images/edits для редактирования входного изображения. Оба эндпоинта используют формат запросов, совместимый с OpenAI Images. Доступные операции зависят от модели и канала, предоставленных вашим сервисом Flatkey.
Модели Gemini для изображений используют нативный эндпоинт Gemini generateContent и не могут вызываться через эти эндпоинты OpenAI Images. См. руководство по моделям Gemini для изображений.

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

Эндпоинт

Заголовки

Параметры тела JSON

string
обязательно
Идентификатор модели изображений, предоставленной вашим сервисом Flatkey, например "gpt-image-2".
string
обязательно
Текстовое описание изображения для генерации.
string
Размеры выходного изображения, например "1024x1024". Поддерживаемые значения зависят от модели.
string
Качество вывода: "low", "medium" или "high". Если не указано, используется значение по умолчанию вышестоящего сервиса. Более высокое качество увеличивает задержку и потребление ресурсов.
string
Обработка фона, например "transparent" или "opaque", если поддерживается моделью.
string
Формат вывода, например "png", "jpeg" или "webp", если поддерживается моделью.
integer
Уровень сжатия вывода, если поддерживается моделью.
string
Уровень модерации контента, если поддерживается моделью.
string
Результаты gpt-image-2 возвращаются в data[].b64_json. Размещённые URL изображений не предоставляются, а response_format: "url" не поддерживается.
integer
Запрошенное количество изображений. gpt-image-2 в настоящее время возвращает одно изображение на запрос, поскольку его вышестоящий инструмент не принимает n. Отправляйте несколько запросов, если вам нужно несколько изображений.
boolean
Установите true для получения ответа в формате SSE. Опустите для синхронного ответа.

Примеры запросов

Редактирование изображения

/v1/images/edits принимает входное изображение и инструкции по редактированию в формате multipart/form-data.

Эндпоинт

Заголовки

Поля формы

Пример запроса

Поле mask необязательно. Опустите его, чтобы редактировать всё изображение на основе запроса. Не задавайте заголовок Content-Type вручную; curl определяет правильный разделитель multipart из полей -F.
Если предоставленная маска повреждена, нечитаема или превышает лимит сервиса, запрос завершится ошибкой, а не перейдёт к редактированию всего изображения.

Ответ

Синхронные запросы генерации и редактирования возвращают одинаковую структуру ответа. Flatkey возвращает изображение в виде данных base64; размещённый URL изображения для gpt-image-2 не предоставляется.

Поля ответа

integer
Unix-временная метка момента завершения запроса.
array
Массив объектов изображений.
При редактировании входное изображение также учитывается в потреблении ресурсов модели, поэтому редактирование обычно потребляет больше ресурсов, чем генерация изображения только из текста.

Стриминг

Установите stream в true в теле JSON запроса генерации или добавьте -F "stream=true" к запросу редактирования, чтобы получить вывод в формате text/event-stream. Финальное событие содержит результат изображения, после которого следует data: [DONE]. Поддержка стриминга может зависеть от выбранной модели и канала. Для синхронных запросов высокого качества настройте таймаут клиента не менее 150 секунд.