Elysium AI
Разделы wikiИзображение одной ссылкой
WikiAPIИзображение одной ссылкой
GET

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

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

Пошаговое объяснение без лишних деталей

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

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

bash1 строк
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 может сохраниться в истории браузера, аналитике и логах.

html4 строк
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-кэше.