Введение
Возможности эндпоинта
Восстанавливает одно видео в одном из двух режимов: decompress удаляет макроблоки, ореолы на границах, полосы и растекание цвета; deblur повышает чёткость расфокусированного видео. Кадрирование, движение, длина и звук сохраняются.
Основные входные данные
video_url — клип до 120 секунд. restore_mode выбирает обработку, resolution — размер результата, не выше исходного. prompt и seed необязательны.
Результат
Один MP4 с исходными пропорциями, частотой кадров и звуковой дорожкой.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
| Эндпоинт | Редактирование видео |
| Вход | Одно видео до 120 секунд |
| Режимы | decompress (дефекты кодирования) или deblur (расфокусировка) |
| Выход | MP4 в 480p, 720p или 1080p, не выше исходного; звук сохранён |
| Необязательно | Описание сцены и seed |
| Оплата | Посекундно по исходнику и разрешению, минимум 3 секунды |
Ключевые возможности и особенности
Блоки удалены, лица восстановлены
Мы сжали 4-секундный клип из теплицы до 116 kbps, разбив лицо женщины на блоки. decompress вернул чистый клип 854×480 с чёткими кудрями, улыбкой и орхидеями при прежних длине и частоте кадров.
Чёткость возвращена общему плану двоих
Размытая под промах фокуса беседа в винном погребе вернулась с чёткими лицами, волосами и деревянными бочками. Положение и движения обоих людей сохранились.
Сначала восстановите, затем увеличьте
Восстановление работает в исходном или меньшем размере. Для увеличения отправьте результат в Video Upscaler: увеличение клипа с блоками лишь увеличит сами блоки.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Клип до 120 секунд: загрузка MP4 или WebM или прямая ссылка. Более длинные отклоняются при отправке без оплаты. Не менее 1 символов |
restore_mode | Нет | decompress (по умолчанию) удаляет макроблоки, ореолы на границах, полосы и растекание цвета при низком битрейте. |
prompt | Нет | Необязательно. Краткое описание видео, например "a man and a woman talking in a wine cellar", помогает сохранить нужные детали. Не более 1000 символов |
resolution | Нет | Выходное разрешение: 480p, 720p (по умолчанию) или 1080p. Пропорции сохраняются, размер не выше исходного. |
seed | Нет | Необязательное целое число для повторяемого результата; оставьте пустым для случайного seed. На цену не влияет. |
Стоимость
Оплата за секунду исходного клипа по выбранному выходному разрешению, с округлением вверх до секунды и минимумом 3 секунды. Клипы длиннее 120 секунд отклоняются. Режим, prompt и seed на цену не влияют. Неудачные запросы бесплатны.
| Спецификация | Стоимость |
|---|---|
| $0.024 / секунду |
| $0.048 / секунду |
| $0.12 / секунду |
Сценарии использования
Спасение многократно пересланных клипов
После нескольких приложений и повторных загрузок в видео появляются блоки и смазывание. decompress очищает лица, волосы и текстуры.
Спасение расфокусированного дубля
Если автофокус искал резкость или объект вышел из плоскости фокуса, deblur может вернуть пригодный дубль без пересъёмки.
Перед увеличением
Сначала восстановите исходный размер, затем отправьте чистый клип в Video Upscaler, если нужны 1080p или 4K.
Руководство по промптам и практические советы
Выберите режим по типу повреждения
Используйте decompress для макроблоков, полос и растекания цвета от сильного сжатия. deblur подходит для промаха фокуса, но не исправляет размытие от движения.
Задайте выходное разрешение
Выберите 480p, 720p или 1080p. Пропорции сохраняются, размер не превышает исходный, поэтому выбирайте разрешение не выше высоты клипа. Цена зависит от выбранного разрешения.
Опишите сцену, если важны детали
Необязательный prompt, например "a woman with curly hair in a greenhouse full of orchids", помогает сохранить нужные детали. Добавьте seed для повторения результата.
Введение
Video Restorer очищает повреждённое видео, не меняя происходящего. Выберите decompress для низкого битрейта и повторных загрузок, deblur — для промаха фокуса. Объекты, кадрирование и движение сохраняются.
Запрос
{
"video_url": "https://example.com/clip.mp4",
"restore_mode": "decompress",
"resolution": "720p",
"prompt": "a woman with curly hair in a greenhouse full of orchids"
}
Обязательно только video_url. По умолчанию restore_mode — decompress, resolution — 720p. Пропорции сохраняются, результат не превышает исходник: клип 480p вернётся в 480p даже при более высоком запросе.
Результаты тестирования
Мы сжали 4-секундный клип из теплицы 854×480 до 116 kbps, разбив лицо женщины на блоки. В режиме decompress при 480p он вернулся примерно через 55 секунд с чистыми лицом, кудрями и орхидеями, сохранив 4 секунды, 24 fps и стереозвук. Клип винного погреба длиной 4 секунды, размытый под промах фокуса, вернулся в режиме deblur примерно через 72 секунды с чёткими лицами и бочками.
Порядок работы
Вызов асинхронный: создайте задачу, опрашивайте до завершения, скачайте MP4 из хранилища SpicyAPI. Оплата посекундная по исходной длине и выбранному разрешению; неудачные запросы бесплатны.
Советы
- Выбирайте
resolutionне выше исходной высоты: более высокое значение увеличит цену, но не число пикселей. deblurисправляет расфокусировку. Размытие движения и тряска камеры не поддерживаются.- Для увеличения восстановленного клипа затем используйте Video Upscaler (
/models/video-upscaler-v1).
Быстрый старт 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/video-restorer-v1/video-edit",
"input": {
"resolution": "720p",
"restore_mode": "decompress",
"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.


