OrlimeGateway
МоделиДокументацияЗащита данныхКонтакты
Войти
Документация API

Начало работы

Быстрый стартАвторизация и заголовки

Работа с API

Потоковые ответыВызов инструментовРассуждения моделиПродолжение диалоговТокены и стоимостьОшибки и повтор запросов

Текст и данные

Список моделейGETChat CompletionsPOSTResponsesPOSTEmbeddingsPOSTРанжированиеPOSTКлассификацияPOST

Изображения, аудио и видео

Генерация изображенийPOSTСинтез речиPOSTТранскрибацияPOSTСоздание видеоPOSTСтатус видеоGETСкачивание видеоGET
Базовый адресgateway.orlime.ru/v1Открыть каталог моделей

ORLIME GATEWAY / API REFERENCE

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

Создайте изображение по описанию и получите его содержимое в 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
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 знаками после запятой. Отсутствие поля не означает бесплатный запрос.
JSON
{
  "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 для поиска запроса. Формат и справочник ошибок

Предыдущий разделКлассификацияСледующий раздел Синтез речи
© 2026 Orlime Gateway
ДокументацияКонтактыTelegramЗащита данныхПолитика конфиденциальностиСогласие на обработку персональных данныхПубличная офертаФайлы cookie