/v1/images/generations для генерации изображения из текстового запроса и /v1/images/edits для редактирования входного изображения. Оба эндпоинта используют формат запросов, совместимый с OpenAI Images. Доступные операции зависят от модели и канала, предоставленных вашим сервисом Flatkey.
Генерация изображения
Эндпоинт
Заголовки
Параметры тела 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 секунд.