Hawklance API

Генерация видео через API

Загрузите фото, выберите шаблон или опишите сцену и получите ролик со звуком. Для сервисов, ботов и всех, кто встраивает видео в свой продукт.

Предварительная версия. Весь путь запроса работает: ключи, проверки, лимиты, списание и журнал. Сам рендер пока эмулируется: ролик «готовится» несколько секунд, а в ответе лежит пример из каталога и поле simulated: true. Формат API менять не планируем.

Быстрый старт

От ключа до готового видео за пять минут.

Видео по шаблону

Тренды из каталога: фото на входе, ролик на выходе.

Видео по описанию

Свой текст и до девяти фото.

Тестовый режим

Бесплатные ключи для разработки и автотестов.

Вебхуки

Событие, когда видео готово, вместо опроса.

Справочник API

Все запросы, поля и ответы.

Как это устроено

Генерация занимает минуты, поэтому API асинхронный. Вы создаёте видео и сразу получаете его идентификатор. Дальше спрашиваете статус или ждёте вебхук. Когда видео готово, в ответе появляется ссылка на MP4.

POST /v1/files            → file_…     фото для ролика
POST /v1/videos           → vid_…      статус queued
GET  /v1/videos/vid_…     → running    progress: 0.42
GET  /v1/videos/vid_…     → succeeded  output.url: https://…mp4

Базовый адрес

https://api.hawklance.ai/v1

Все запросы идут по HTTPS, тела запросов и ответов в JSON, кроме загрузки файлов. Полное описание в формате OpenAPI 3.1 лежит по адресу /v1/openapi.json: его понимают Postman, Insomnia и генераторы клиентов.

Что умеет модель

	Hawklance 4.8
Длина ролика	от 5 до 15 секунд
Качество	480p и 720p, 1080p скоро
Формат	9:16 и 16:9
Звук	есть
Фото на входе	до 9
Шаблоны	каталог трендов