REST API генерации изображений и видео
Как подключить AI генерацию к сайту, Telegram-боту, CRM или внутреннему сервису через API Hayal AI Technology.
REST API Hayal AI Technology позволяет запускать генерацию изображений и видео, получать список доступных моделей, проверять баланс и историю заданий от имени аккаунта — без ручной работы через сайт.
Для каких задач используют API
- Личные кабинеты и внутренние инструменты компании.
- Telegram-боты — подробный сценарий разобран в статье «AI-генерация изображений в Telegram-боте».
- CRM и другие сервисы, где генерация — часть более крупного продукта.
- Автоматизация типовых задач: пакетная генерация карточек товаров, баннеров, аватаров.
Как начать работу с API
Ключ API создаётся в профиле аккаунта. Через API можно запускать генерацию, получать статус и результат задания, а также проверять текущий баланс — это даёт возможность полностью вести учёт расходов на генерацию на своей стороне, без дублирования логики баланса.
Пример запроса
Пример PHP-запроса к API и полное описание параметров есть на странице инструкций сервиса — там же указаны актуальные адреса эндпоинтов и формат ответа.
На что обратить внимание при интеграции
- Проверяйте баланс перед запуском задания, чтобы не получать отказ на середине сценария.
- Обрабатывайте статус задания асинхронно — генерация изображений и особенно видео занимает время.
- Храните ключ API так же аккуратно, как любой другой секрет доступа к аккаунту.
Где получить ключ API?
В профиле аккаунта на сайте — создать и хранить ключ можно там же.
Можно ли через API узнать баланс аккаунта?
Да, API позволяет проверять баланс и историю заданий от имени аккаунта, это же используется для учёта расходов в собственных сервисах и ботах.
Есть ли готовый пример запроса?
Да, пример PHP-запроса и полное описание параметров есть на странице инструкций сервиса.