Руководства

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

Шаблон — готовый тренд: сцена, движение и звук уже продуманы, нужны только ваши фото.

Выберите шаблон

Каталог есть в консоли и в API. Он пополняется, поэтому держите id шаблонов в настройках сервиса, а не в коде.

curl https://api.hawklance.ai/v1/templates?limit=20 \
  -H "Authorization: Bearer $HAWKLANCE_API_KEY"

Прочитайте поля

У каждого шаблона свои поля inputs. Показывайте их в своей форме: в title и description уже написано, какое фото нужно.

type	Что передать	Пример
`images`	Массив id фото, от min_count до max_count	`["file_…"]`
`audio`	Массив id аудиофайлов	`["file_…"]`
`video`	Массив из одного id видео	`["file_…"]`
`text`	Строка, до max_length символов	`"С днём рождения"`
`choice`	Один из options	`"Зима"`

Создайте видео

Длина у шаблона своя (duration_seconds), передавать её нельзя. Формат — один из aspect_ratios, по умолчанию первый.

curl -X POST https://api.hawklance.ai/v1/videos \
  -H "Authorization: Bearer $HAWKLANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "novyy-obraz",
    "inputs": {
      "person": [
        "file_..."
      ],
      "new_look": [
        "file_..."
      ]
    },
    "quality": "720p",
    "metadata": {
      "order_id": "4815"
    }
  }'

Какие фото подходят

Лицо хорошо видно, один человек в кадре, если шаблон не просит другого.
JPG, PNG, WebP, HEIC или AVIF, до 25 МБ. Большие фото мы сами уменьшим до 2048 пикселей.
Человек на фото должен быть вашим клиентом или дать согласие: это требование правил использования.