API

Изображение одной ссылкой

GET-маршрут, который генерирует изображение и возвращает готовые бинарные данные для img или Markdown.

Генерация бинарного ответа

Модель указывается после image:, а prompt и параметры — в query string. Сервер возвращает image/png, image/jpeg или другой фактический MIME-тип, а не JSON.

1curl --get "https://elysiumai.garden/embed/image:google/gemini-3.1-flash-image-preview"   -H "Authorization: Bearer $ELYSIUM_API_KEY"   --data-urlencode "prompt=Стеклянный павильон в туманном лесу"   --data-urlencode "aspect_ratio=16:9"   --data-urlencode "image_size=2K"   --output result.png

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

Тег img не умеет отправлять Authorization, поэтому для прямого встраивания допускается ?key=. Используйте отдельный ключ с небольшим бюджетом и не размещайте его на публичной странице: URL может сохраниться в истории браузера, аналитике и логах.

1<img2  src="https://elysiumai.garden/embed/image:google/gemini-3.1-flash-image-preview?prompt=Marble%20garden&aspect_ratio=16:9&key=sk-..."3  alt="Сгенерированный сад"4/>

Поддерживаемые параметры

Параметр	Назначение
prompt	Описание создаваемого изображения; обязательно
aspect_ratio	Соотношение сторон, например 1:1 или 16:9
image_size	Разрешение вроде 1K или 2K, если модель поддерживает
key	API-ключ для клиентов, которые не могут отправить заголовок

Параметр references здесь намеренно не поддерживается. Для правки исходного изображения используйте POST /v1/images/edits или Gemini Image через Chat Completions.

Стоимость и хранение

Каждый GET запускает новую генерацию и тарифицируется как обычный запрос выбранной image-модели. Ответ помечен private, no-store: Elysium AI не реализует smart cache и не обещает повторно вернуть прежнюю картинку по тому же URL.

Если результат нужен повторно, сохраните бинарные данные в собственное хранилище и показывайте уже сохранённый URL.

Термины на этой странице

Термин	Что означает
Base URL	Базовый адрес API, к которому клиент добавляет нужный маршрут.
API-ключ	Секрет для авторизации и списания запросов с вашего баланса.
Model ID	Точное системное имя модели из каталога Elysium AI.
Бинарный ответ	Файл изображения в теле HTTP-ответа вместо JSON.
MIME-тип	Значение Content-Type, описывающее формат файла, например image/png.
Query string	Параметры после знака ? в URL, например prompt и aspect_ratio.
no-store	Указание клиенту и прокси не сохранять ответ в HTTP-кэше.