Перейти к статье
ДокументацияПоддержка

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

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

Копировать и скачать
Все руководства (.md)

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

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

bash
1curl --get "https://elysiumai.net/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 может сохраниться в истории браузера, аналитике и логах.

html
1<img2  src="https://elysiumai.net/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, если модель поддерживает
keyAPI-ключ для клиентов, которые не могут отправить заголовок

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

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

Документация

Мастер подключенияНастроить IDE за минуту