Генерация изображений
Создайте изображение по описанию и получите его содержимое в base64.
POST
/v1/images/generationsЗаголовки
AuthorizationBearer <API_KEY>Обязательно- Ключ компании из раздела «API-ключи». Храните на сервере или в переменной окружения. Не вставляйте секретный ключ в браузерный код.
Content-Typeapplication/jsonДля JSON-тела- Кодировка UTF-8. Для файлов используйте multipart/form-data; curl и SDK сами добавят boundary. Для GET и DELETE без тела не нужен.
Acceptapplication/json | text/event-streamНеобязательно- Ожидаемый формат ответа. Для включения SSE нужно также передать stream: true в JSON. Синтез речи и скачивание видео возвращают бинарные данные.
Адрес метода: https://gateway.orlime.ru/v1/images/generations
Входные параметры
modelstringОбязательно- Публичный ID из GET /v1/models. Возможности и допустимые параметры смотрите в карточке модели.
promptstringОбязательно- Описание желаемого изображения.
nintegerНеобязательно- Количество изображений; Gemini поддерживает одно изображение за запрос.
sizestringНеобязательно- WIDTHxHEIGHT, например 1024x1024. Допустимые размеры зависят от модели.
qualitystringПри поддержке модели- Например auto, low, medium, high для GPT Image. Влияет на стоимость.
output_formatstringПри поддержке модели- png, jpeg или webp.
output_compressioninteger 0–100Для JPEG / WebP- Качество сжатия, если поддерживается.
response_formatstring | objectНеобязательно- b64_json. GPT Image может не принимать это поле — укажите output_format. Для Gemini доступен объект {type:"image",mime_type,aspect_ratio,image_size}.
mime_type / aspect_ratio / image_sizestringПри поддержке моделью- Например image/jpeg, 16:9, 2K. Можно указать в response_format или на верхнем уровне. Дублированные настройки должны совпадать. Разрешения и пропорции смотрите в карточке модели.
Пример запроса
curl --fail-with-body https://gateway.orlime.ru/v1/images/generations \
-H "Authorization: Bearer $ORLIME_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-image-1-mini",
"prompt": "Кот-программист за ноутбуком, минималистичная иллюстрация",
"size": "1024x1024",
"n": 1,
"quality": "low",
"output_format": "png"
}'Ответ
createdintegerЕсли доступно- Unix-время создания.
dataarrayВсегда- Сгенерированные изображения.
data[].b64_jsonstringВсегда у изображения- Base64 файла без префикса data URL. Декодируйте в байты.
data[].mime_type / media_typestringЕсли доступно- image/png, image/jpeg или image/webp.
data[].revised_promptstringЕсли доступно- Уточнённое моделью описание.
background / output_format / quality / sizestringЕсли доступны- Фактические параметры результата.
usageobjectЕсли доступно- Токены, детали токенов изображений или количество изображений.
usage.cost_rubstringЕсли расчёт завершён- Сумма фактического списания в рублях за весь запрос. Десятичная строка с 12 знаками после запятой. Отсутствие поля не означает бесплатный запрос.
{
"created": 1795161600,
"data": [
{
"b64_json": "BASE64_IMAGE_DATA",
"mime_type": "image/png"
}
],
"usage": {
"images": 1,
"cost_rub": "2.450000000000"
}
}Заголовки ответа
x-request-idstringОтвет Gateway- ID операции для поиска в журнале и обращения в поддержку. В Chat Completions и Responses совпадает с верхнеуровневым id ответа.
Content-TypestringОтвет Gateway- application/json, text/event-stream или MIME-тип аудио/видео. Ошибки файловых методов могут возвращаться как JSON.
Retry-AfterintegerЕсли возвращён- Число секунд до рекомендуемого повтора. Отсутствие заголовка не означает, что запрос следует немедленно повторять.
Особенности
- Изображения возвращаются в data[].b64_json. Потоковый ответ не поддерживается.
- Некоторые модели оплачиваются по токенам, другие — по изображению и выбранным параметрам. Итог находится в usage.cost_rub.
Ошибки
Ошибки возвращаются в объекте error с полями message, type, code и param. Сохраните x-request-id для поиска запроса. Формат и справочник ошибок
