Введение
Что делает этот эндпоинт
Он принимает одно видео и возвращает копию, в которой до трёх лиц в каждом кадре, начиная с самого крупного, восстановлены и стали чётче. Результат устойчив от кадра к кадру. Движение, кадрирование, длительность и исходная звуковая дорожка сохраняются, разрешение не меняется. Промпта нет.
Важные входные данные
video_url — клип: загруженный файл MP4 или публичная ссылка длительностью от 3 секунд до 5 минут. Клипы вне этого диапазона отклоняются до списания оплаты. Выберите для Video Face Enhancer настоящее лицо, которое хорошо видно и достаточно крупно в исходнике; операция «покадровое восстановление лиц в Video Face Enhancer» лучше использует такие детали, чем далёкое или закрытое лицо.
Что вы получите
Одно видео на запрос в том разрешении, частоте кадров и длительности, которые вы отправили, со звуком; оно отдаётся из хранилища платформы после завершения задачи. Для большего числа пикселей используйте /models/video-upscaler-v1.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
| Эндпоинт | Редактирование видео |
| Вход | Один файл MP4 или ссылка, от 3 секунд до 5 минут |
| Выход | Одно видео в исходном разрешении, с той же длительностью и звуком |
| Лица | До трёх в каждом кадре, начиная с самого крупного |
| Настройки | Без промпта — сам клип и есть весь запрос |
| Оплата | За секунду входного клипа, минимум 3 секунды |
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Клип для восстановления: загруженный файл MP4 или публичная ссылка длительностью от 3 секунд до 5 минут. Клипы вне этого диапазона отклоняются до списания оплаты. Не менее 1 символов |
Стоимость
$0.012 / секунда результата
Оплата за каждую секунду входного клипа с округлением вверх до целой секунды и минимумом 3 секунды. Загруженный файл резервируется на собственную длительность, а ссылка — на максимум 5 минут до доставки; разница освобождается. Неудачные запросы не оплачиваются.
Сценарии использования
Клипы из подкастов и интервью
Записи говорящих людей, сильно сжатые перед загрузкой, теряют детали в первую очередь на лице. Пропустите их один раз, чтобы вернуть глаза, зубы и линию волос, пока комната, кадрирование и звук остаются прежними.
Старые или сильно сжатые записи
Клипы, которые сохраняли, пересылали и несколько раз перекодировали, выглядят мягкими и блочными вокруг лица. Восстанавливаются до трёх лиц в каждом кадре, поэтому клип с одним-двумя хорошо видимыми говорящими подходит лучше всего.
Записи, которые позже увеличите
Сначала приведите лица в порядок, а затем используйте Video Upscaler по адресу /models/video-upscaler-v1, если клипу для большого экрана нужны ещё и пиксели.
Руководство по промптам и практические советы
Проверьте клип
MP4 длительностью от 3 секунд до 5 минут с настоящими, достаточно крупными и хорошо видимыми лицами людей. Сначала обрежьте клип до нужного фрагмента.
Отправьте
video_urlvideo_url— это файл MP4, загруженный или по публичной ссылке. Это единственное поле: промпта нет и настраивать ничего не нужно.Опросите и сравните
Вызов асинхронный: создайте задачу, опрашивайте её до завершения и скачайте видео из хранилища платформы. Сравните с исходником в обычной скорости и на остановленном кадре, а также проверьте, что звук на месте.
Введение
Video Face Enhancer восстанавливает и делает чётче лица в каждом кадре клипа. Вы отправляете video_url; инструмент находит до трёх лиц в каждом кадре, начиная с самого крупного, и воссоздаёт детали, которые отняли сильное сжатие или размытие, при этом результат остаётся устойчивым от кадра к кадру. Движение, кадрирование, длительность и исходная звуковая дорожка сохраняются, а клип возвращается в том разрешении, которое вы отправили. Принимаются файлы MP4 длительностью от 3 секунд до 5 минут; промпта нет.
Основные функции и преимущества
Чёткие лица в каждом кадре
Восстановление проходит по всему клипу, а не по одному стоп-кадру. В нашем тесте мы взяли 5-секундный клип 640×360 с ведущей подкаста и испортили его сильным сжатием H.264. Он вернулся в 640×360 и 24 fps, по-прежнему 5,0 секунды, примерно через 21 секунду обработки. Глаза, зубы и линия волос стали чётче в каждом кадре и не мерцали, а ведущая оставалась узнаваемо тем же человеком.
Всё остальное остаётся как было
Аудио, движение, кадрирование и длительность сохраняются, а область вокруг лиц не трогается: комната за ведущей не изменилась. Инструмент не увеличивает видео. Если нужны ещё и дополнительные пиксели, используйте Video Upscaler (/models/video-upscaler-v1).
Оплата следует за длиной клипа
Оплата идёт за каждую секунду входного клипа с округлением вверх до целой секунды и минимумом 3 секунды. Клипы короче 3 секунд или длиннее 5 минут отклоняются до списания оплаты. Если клип загружен файлом, длительность которого известна, резерв равен этой длительности; для ссылки расчёт держит максимум 5 минут до доставки, а разница освобождается. Неудачные запросы не оплачиваются.
Сценарии использования
Клипы из подкастов и интервью
Записи говорящих людей, сильно сжатые перед загрузкой, теряют детали в первую очередь на лице. Пропустите клип один раз, чтобы вернуть глаза, зубы и линию волос, а комната, кадрирование и звук останутся прежними.
Старые и сильно сжатые записи
Клипы, которые сохраняли, пересылали и несколько раз перекодировали, выглядят мягкими и блочными вокруг лица. До трёх лиц в каждом кадре восстанавливаются, начиная с самого крупного, поэтому клип с одним-двумя хорошо видимыми говорящими подходит лучше всего.
Записи, которые вы позже увеличите
Сначала приведите лица в порядок, а затем используйте Video Upscaler (/models/video-upscaler-v1), если клипу для большого экрана нужны ещё и пиксели.
Руководство по промптам и практические советы
Промпта нет: выберите клип
Единственный вход — video_url: загруженный файл MP4 или публичная ссылка длительностью от 3 секунд до 5 минут. Обрежьте клип до нужного фрагмента перед отправкой, потому что оплата зависит от длины того, что вы отправляете.
Выбирайте лица, которые можно восстановить
Настоящие лица людей, достаточно крупные и хорошо видимые, улучшаются сильнее всего. У Video Face Enhancer меньше данных для восстановления на рисунках и аниме, а также при мелких, закрытых или сильно размытых лицах; это ограничивает операцию «покадровое восстановление лиц в Video Face Enhancer». Если в клипе одновременно видно больше трёх лиц, восстанавливаются три самых крупных, а остальные остаются как были.
Сверьте результат с исходником
Просмотрите результат в обычной скорости и на остановленном кадре, проверьте звук, длительность и частоту кадров, а не только лица. Версия для одного фото оставляла кожу немного глаже, чем на настоящем снимке, поэтому ищите такое же смягчение на лицах в движении. Фон не затрагивается, поэтому блоки сжатия там остаются. Исходный файл сохраняйте.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/face-enhancer-video-v1/video-edit",
"input": {
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
