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

LLMSTORE предоставляет специальный API изображений для создания изображений из текстовых подсказок (и дополнительных эталонных изображений). API охватывает обнаружение моделей, возможности каждой эндпоинта и генерацию. Вы можете просмотреть доступные модели и цены на странице модели, отфильтрованной по выходным изображениям..

Современная витрина соседнего магазина в синий час, освещенная тепло-белой курсивной неоновой вывеской с надписью «LLMSTORE», растения и велосипед у входа, а свет отражается от мокрого тротуара. — Generated with openai/gpt-image-2 — 16:9, high quality

Prompt and parameters

Редакционная архитектурная фотография современной витрины местного магазина в синий час, тепло светящейся на фоне сумерек. Над входом тепло-белая неоновая вывеска, написанная плавным рукописным шрифтом, гласит ровно «LLMSTORE», единственный текст в сцене. Большие окна открывают уютный, обжитой интерьер: деревянные полки с книгами и керамикой, пышные висячие растения и мягкое подвесное освещение. У входа стоят горшечные растения и велосипед, а по мокрому тротуару льется нежными отблесками золотой свет. Прямая композиция, реалистичные материалы, тихая улица без людей.

Модель: openai/gpt-image-2
Параметры: quality: "high", aspect_ratio: "16:9", n: 1
Вывод: 1536×864 PNG
Время генерации: 94 с.
Стоимость: 0,13 доллара США.

Попробуйте эту подсказку на игровой площадке изображений →

Открытие модели

Через API моделей изображений

Эндпоинт выделенных моделей изображений перечисляет все доступные модели изображений с их возможностями:

curl "https://api.llmstore.ru/v1/images/models"

Каждая запись в Массив data включает в себя:

{
  "data": [
    {
      "id": "bytedance-seed/seedream-4.5",
      "name": "Seedream 4.5",
      "description": "A text-to-image model.",
      "created": 1692901234,
      "architecture": {
        "input_modalities": ["text", "image"],
        "output_modalities": ["image"]
      },
      "supported_parameters": {
        "resolution": { "type": "enum", "values": ["1K", "2K", "4K"] },
        "seed": { "type": "boolean" }
      },
      "supports_streaming": false,
      "endpoints": "/v1/images/models/bytedance-seed/seedream-4.5/endpoints"
    }
  ]
}

Поле	Описание
`id`	Слаг модели для использования в запросах генерации
`architecture`	Модальности ввода и вывода, которые принимает модель
`supported_parameters`	Объединение возможностей всех эндпоинтов. Каждый ключ представляет собой имя поля запроса; значение представляет собой дескриптор возможности
`supports_streaming`	Поддерживает ли какая-либо эндпоинт собственную потоковую передачу SSE (`stream: true`)
`endpoints`	URL-адрес полных записей по каждой эндпоинту для этой модели

Записи для каждой эндпоинта

Каждая модель может обслуживаться несколькими поставщиками. Чтобы увидеть окончательные возможности, цены и варианты транзитной передачи для каждой эндпоинта:

curl "https://api.llmstore.ru/v1/images/models/bytedance-seed/seedream-4.5/endpoints"

{
  "id": "bytedance-seed/seedream-4.5",
  "endpoints": [
    {
      "provider_name": "Bytedance",
      "provider_slug": "bytedance",
      "provider_tag": "bytedance",
      "supported_parameters": {
        "resolution": { "type": "enum", "values": ["1K", "2K", "4K"] },
        "seed": { "type": "boolean" }
      },
      "allowed_passthrough_parameters": [],
      "supports_streaming": false,
      "pricing": [
        { "billable": "output_image", "unit": "image", "cost_usd": 0.05 }
      ]
    }
  ]
}

Поле	Описание
`provider_slug`	Использование в `provider.options[slug]` для передачи параметров, специфичных для провайдера
`provider_tag`	Используйте для закрепления запросов к конкретному поставщику. `null` когда маршрутизация на уровне провайдера недоступна
`supported_parameters`	Окончательный набор параметров, которые принимает эта эндпоинт (подмножество объединения уровня модели)
`allowed_passthrough_parameters`	Ключи, специфичные для поставщика, принимаются в соответствии с `provider.options[provider_slug]`
`supports_streaming`	Поддерживает ли эта эндпоинт потоковую передачу SSE
`pricing`	Строки оплачиваемых цен для этой эндпоинта. Каждая запись имеет `billable` (например. `output_image`, `input_image`, `input_reference`), `unit` (`image`, `megapixel`, или `token`), `cost_usd`и необязательно `variant` уровень (например. `2k`, `4k` для цен на уровне разрешения)

Дескрипторы возможностей Карта

Объект supported_parameters использует типизированные дескрипторы для описания того, что принимает каждое поле запроса:

Тип	Форма	Значение
`enum`	`{ type: "enum", values: ["1K", "2K", "4K"] }`	Дискретный список допустимых строковых значений
`range`	`{ type: "range", min: 0, max: 100 }`	Любое целое число в `[min, max]` действителен
`boolean`	`{ type: "boolean" }`	Поддерживается (присутствует) или не поддерживается (отсутствует)

Отсутствие ключа означает, что параметр не поддерживается этой эндпоинтом.

Через API моделей

Вы также можете обнаружить модели изображений через общий Models API:

curl "https://api.llmstore.ru/v1/models?output_modalities=image"

На странице моделей

Посетите страницу Модели и фильтруйте по модальности вывода, чтобы найти модели с возможностью создания изображений.

Использование API

Отправить POST просьба /v1/images с моделью и подсказкой:

Формат ответа

Изображения возвращаются в виде байтов в кодировке Base64. Поле usage сообщает о количестве токенов и их стоимости, если они доступны. Поле Объект media_type присутствует всякий раз, когда формат можно идентифицировать (включая image/png) и опускается только тогда, когда его невозможно определить:

{
  "created": 1748372400,
  "data": [
    {
      "b64_json": "<base64-encoded-image>",
      "media_type": "image/png"
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 4175,
    "total_tokens": 4175,
    "cost": 0.04
  }
}

Для выходных данных, отличных от PNG (например, JPEG, WebP или SVG из векторных моделей Recraft), media_type отражает фактический формат: Объект

{
  "created": 1748372400,
  "data": [
    {
      "b64_json": "<base64-encoded-image>",
      "media_type": "image/svg+xml"
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 4175,
    "total_tokens": 4175,
    "cost": 0.04
  }
}

Параметры конфигурации изображения

Разрешение и соотношение сторон

Управляйте выходными размерами с помощью resolution, aspect_ratio, или удобство size сокращение:

{
  "model": "bytedance-seed/seedream-4.5",
  "prompt": "a landscape photo",
  "resolution": "2K",
  "aspect_ratio": "16:9"
}

resolution — нормализованный уровень (512, 1K, 2K, 4K). Конкретные размеры пикселей определяются для каждого поставщика.
aspect_ratio — нормированный коэффициент. Пройти auto , чтобы позволить провайдеру выбирать. Общие ценности включают в себя 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4и расширенные соотношения, например 1:2, 2:1, 1:4, 4:1, 1:8, 8:1, 9:21, 21:9. Поставщики ограничиваются поддерживаемым набором — проверьте модель supported_parameters для принятых значений.
size — удобное сокращение. Пройди уровень("2K") или явные пиксели ("2048x2048") и нормализуется для провайдера. Размер уровня эквивалентен настройке resolution и сочетается с aspect_ratio. Явный размер пикселя является авторитетным — несовпадение resolution или Сообщения aspect_ratio рядом с ним отклоняется с оценкой 400.

Проверьте модель supported_parameters , чтобы узнать, какие значения принимает каждая эндпоинт.

Качество и формат вывода

{
  "model": "openai/gpt-image-1",
  "prompt": "a product photo",
  "quality": "high",
  "output_format": "png",
  "background": "transparent"
}

quality — auto, low, medium, или high. Провайдеры, не имеющие ручки качества, игнорируют это.
output_format — png, jpeg, webp, или svg (только модели векторизации; разметка SVG закодирована в формате Base64 в b64_json).
background — auto, transparent, или opaque. transparent требует формата с поддержкой альфа-канала (png или webp).
output_compression — 0–100 для webp/jpeg. Игнорируется для PNG.

Несколько изображений

Запросите до 10 изображений за один звонок с помощью n:

{
  "model": "openai/gpt-image-1",
  "prompt": "a cute cat",
  "n": 4
}

Не все провайдеры поддерживают n > 1. Проверьте модель supported_parameters о наличии.

Изображение к изображению (эталонные изображения)

Передайте эталонные изображения для управления генерацией через input_references:

{
  "model": "openai/gpt-image-1",
  "prompt": "make this scene look like a watercolor painting",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/photo.jpg"
      }
    }
  ]
}

Справочные изображения могут быть URL-адресами HTTP(S) или URL-адресами данных в формате Base64. Количество принимаемых ссылок зависит от поставщика.

Маршрутизация провайдера

Если модель имеет несколько поставщиков, используйте provider , чтобы выбрать, какие эндпоинты могут обслуживать запрос:

{
  "model": "google/gemini-2.5-flash-image",
  "prompt": "a red panda astronaut floating in space",
  "provider": {
    "only": ["google-ai-studio"],
    "allow_fallbacks": false
  }
}

Image API поддерживает следующие поля маршрутизации:

only — разрешить только пули перечисленных провайдеров.
order — попробуйте провайдеров в указанном порядке.
ignore — исключить перечисленные слаги провайдера.
sort — отсортировать подходящие эндпоинты по price, throughput, или latency.
allow_fallbacks — когда false, остановитесь после основного поставщика вместо того, чтобы пробовать другого подходящего поставщика.

Использовать provider_tag из записей для каждой эндпоинта в качестве пула базового провайдера. См. Маршрутизация поставщика для поведения маршрутизации, общего для API LLMSTORE.

Опции, зависящие от поставщика

Передача параметров, специфичных для провайдера, через provider.options, с ключом провайдера из API эндпоинтов: Поле

{
  "model": "black-forest-labs/flux.2-pro",
  "prompt": "a dramatic portrait",
  "provider": {
    "options": {
      "black-forest-labs": {
        "steps": 40,
        "guidance": 3
      }
    }
  }
}

Объект allowed_passthrough_parameters в каждой записи эндпоинта перечисляет, какие ключи принимаются.

Генерация потокового изображения

Модели, поддерживающие встроенную потоковую передачу SSE (supports_streaming: true в API обнаружения) может возвращать частичные изображения по мере их создания:

{
  "model": "openai/gpt-image-1",
  "prompt": "a detailed landscape",
  "stream": true
}

Ответ представляет собой поток SSE с тремя типами событий: Частичное изображение — генерируется, когда становится доступен каждый частичный рендеринг:

data: {"type":"image_generation.partial_image","partial_image_index":0,"b64_json":"<base64>"}

Completed — выдается, когда финальное изображение готово. Поле media_type присутствует всякий раз, когда формат можно идентифицировать:

data: {"type":"image_generation.completed","b64_json":"<base64>","media_type":"image/png","created":1748372400,"usage":{"prompt_tokens":16,"completion_tokens":272,"total_tokens":288,"cost":0.011}}

Для выходных данных, отличных от PNG (например, SVG из векторных моделей Recraft), media_type отражает фактический формат: Объект

data: {"type":"image_generation.completed","b64_json":"<base64>","media_type":"image/svg+xml","created":1748372400,"usage":{"prompt_tokens":16,"completion_tokens":272,"total_tokens":288,"cost":0.011}}

Объект usage в завершенном событии включает в себя cost (USD), что соответствует форме буферизованного ответа. Error — выдается, если генерация не удалась в середине потока:

data: {"type":"error","error":{"message":"Generation failed","code":"server_error"}}

Поток завершается data: [DONE].

Выставление счетов и отмена

Оплата за создание изображений осуществляется по принципу все или ничего. Генерация либо завершена и оплачивается полностью, либо завершается сбоем и не оплачивается — частичной или дробной оплаты изображения не существует. Это отличается от завершения чата, где отмененный поток по-прежнему выставляет счет за токены, созданные до отмены.

Завершенные поколения оплачиваются за полный вывод изображения на основе цен эндпоинта.
Неудачные или отмененные поколения не оплачиваются. Если генерация не завершается, запрос возвращает 502 Bad Gateway , а не частичный результат, и заряд не фиксируется.

Если клиент отключается в середине поколения, вышестоящий провайдер все равно может завершить рендеринг изображения и взимать за него плату с LLMSTORE. В любом случае, клиент всегда наблюдает только один из двух результатов: полностью выставленный счет или ошибку. LLMSTORE не пытается выставлять пользователю счета за работу, которую он не получил. Для запросов на потоковую передачу любые изображения частичного предварительного просмотра, доставленные до окончания трансляции, не не влекут за собой частичную оплату. Выставление счетов исключает завершение окончательного образа, поэтому поток, который завершается раньше (отключение клиента или ошибка в середине потока), оплачивается точно так же, как неудачное создание: вовсе нет.

Параметры запроса

Параметр	Тип	Требуется	Описание
`model`	строка	Да	Слизняк модели (например. `bytedance-seed/seedream-4.5`)
`prompt`	строка	Да	Текстовое описание желаемого изображения
`n`	целое число	Нет	Количество изображений для создания (1–10)
`resolution`	строка	Нет	Уровень разрешения (`512`, `1K`, `2K`, `4K`)
`aspect_ratio`	строка	Нет	Соотношение сторон (`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `1:4`, `4:1`и т. д.)
`size`	строка	Нет	Сокращенное обозначение удобства — уровень или явные пиксели (`"2048x2048"`)
`quality`	строка	Нет	`auto`, `low`, `medium`, или `high`
`output_format`	строка	Нет	`png`, `jpeg`, `webp`, или `svg`
`background`	строка	Нет	`auto`, `transparent`, или `opaque`
`output_compression`	целое число	Нет	Уровень сжатия (0–100) для webp/jpeg
`seed`	целое число	Нет	Начальное значение для детерминированной генерации (где поддерживается)
`stream`	логическое	Нет	Потоковая передача частичных изображений через SSE
`input_references`	массив	Нет	Эталонные изображения для преобразования изображений в изображения
`provider.only`	строка[]	Нет	Разрешить только эти пулы провайдера
`provider.order`	строка[]	Нет	Попробуйте пулы провайдеров в этом порядке
`provider.ignore`	строка[]	Нет	Исключить эти URL-адреса поставщиков
`provider.sort`	строка или объект	Нет	Сортировка подходящих эндпоинтов по цене, пропускной способности или задержке
`provider.allow_fallbacks`	логическое	Нет	Разрешить использование другого подходящего поставщика в случае сбоя основного
`provider.options`	объект	Нет	Параметры, специфичные для поставщика, определяемые слагом поставщика

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

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

Аутентификация

Мультимодальность

Модели и роутинг

Варианты моделей

Возможности

Плагины

Администрирование

Приватность

Лучшие практики

SDK и интеграции

Открытие модели

Через API моделей изображений

Записи для каждой эндпоинта

Дескрипторы возможностей Карта

Через API моделей

На странице моделей

Использование API

Формат ответа

Параметры конфигурации изображения

Разрешение и соотношение сторон

Качество и формат вывода

Несколько изображений

Изображение к изображению (эталонные изображения)

Маршрутизация провайдера

Опции, зависящие от поставщика

Генерация потокового изображения

Выставление счетов и отмена

Параметры запроса

​Открытие модели

​Через API моделей изображений

​Записи для каждой эндпоинта

​Дескрипторы возможностей Карта

​Через API моделей

​На странице моделей

​Использование API

​Формат ответа

​Параметры конфигурации изображения

​Разрешение и соотношение сторон

​Качество и формат вывода

​Несколько изображений

​Изображение к изображению (эталонные изображения)

​Маршрутизация провайдера

​Опции, зависящие от поставщика

​Генерация потокового изображения

​Выставление счетов и отмена

​Параметры запроса

Открытие модели

Через API моделей изображений

Записи для каждой эндпоинта

Дескрипторы возможностей Карта

Через API моделей

На странице моделей

Использование API

Формат ответа

Параметры конфигурации изображения

Разрешение и соотношение сторон

Качество и формат вывода

Несколько изображений

Изображение к изображению (эталонные изображения)

Маршрутизация провайдера

Опции, зависящие от поставщика

Генерация потокового изображения

Выставление счетов и отмена

Параметры запроса