Embed Images

Embed Images endpoint генерирует изображение и возвращает сырые байты. Его можно использовать напрямую в HTML <img> или Markdown image syntax.

GET https://api.rout.my/embed/image:{model}

Запрос

https://api.rout.my/embed/image:image-model-alias?key=sk_your_key_here&prompt=a+blue+glass+cube

Query parameters

Parameter	Тип	Обязательное	Примечания
key	string	Да	rout.my API key. Route также работает через compatible auth adapters.
prompt	string	Да	URL-encoded image prompt. Пробелы можно писать как + или %20.
references	string	Нет	URL референс-изображений через запятую.

Model path

{model} — короткое имя модели в path:

/embed/image:image-model-alias

Этот endpoint намеренно использует whitelist image aliases. Если alias не включен для endpoint, API вернет 400.

HTML

<img
  src="https://api.rout.my/embed/image:image-model-alias?key=sk_your_key_here&prompt=a+blue+glass+cube"
  alt="Generated blue glass cube"
/>

Markdown

![Generated image](https://api.rout.my/embed/image:image-model-alias?key=sk_your_key_here&prompt=a+blue+glass+cube)

References

https://api.rout.my/embed/image:image-model-alias?key=sk_your_key_here&prompt=same+object+in+a+studio&references=https://example.com/ref1.png,https://example.com/ref2.png

Ответ

При успехе тело ответа — само изображение:

Header	Значение
Content-Type	Image MIME type, например image/png.
Content-Length	Размер изображения в байтах.
X-Cache	HIT, если ответ из cache; MISS, если генерация новая.
Cache-Control	Long-lived browser cache header для generated image bytes.

При ошибке endpoint возвращает стандартный JSON error object.

Cache behavior

Generated images кэшируются по model, normalized prompt и sorted reference URLs. Cache hit возвращает сохраненное изображение без новой генерации и без списания квоты.

Security note

Этот route кладет key в URL query parameter, потому что image tags не умеют отправлять custom headers. Не используйте приватный key в публичных страницах, если каждый viewer не должен иметь право тратить этот key.