Введение
Что делает этот эндпоинт
Он принимает один видеоклип и возвращает тот же клип на более высоком уровне разрешения. Длительность, пропорции, движение, склейки и звуковая дорожка остаются как при отправке, промпта нет.
Важные входные данные
video_url — клип длиной от 3 до 60 секунд в виде прямой ссылки на файл. resolution выбирает уровень вывода: 720p, 1080p (по умолчанию), 2k или 4k. Уровень — это бюджет пикселей, поэтому клип 832×480 на 1080p возвращается в 1896×1094.
Что вы получите
Один MP4 на запрос той же длительности, что и исходник; после завершения задачи он отдаётся из хранилища платформы.
| Характеристика | Значение |
|---|---|
| Ввод | Видео |
| Вывод | Видео |
| Эндпоинт | Upscale |
| Вход | Одна ссылка на видео, от 3 до 60 секунд |
| Выход | Один MP4, та же длительность, пропорции и звук |
| Уровни | 720p, 1080p, 2K, 4K |
| Оплата | За секунду исходного клипа, с округлением вверх, минимум 3 секунды |
| Настройки | Без промпта — только resolution |
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
video_url | Да | Клип для апскейла длиной от 3 до 60 секунд. Не менее 1 символов |
resolution | Нет | 720p, 1080p (по умолчанию), 2k или 4k — бюджет пикселей с сохранением пропорций клипа, поэтому клип 832×480 в 1080p возвращается в 1896×1094. |
Стоимость
Оплата за секунду исходного клипа с округлением вверх до целой секунды и минимумом 3 секунды; ставку за секунду определяет уровень вывода. Оценка перед отправкой рассчитывается по длине загруженного клипа плюс одна секунда, а для ссылки на видео — по максимуму в 60 секунд; разница освобождается при списании.
| Спецификация | Стоимость |
|---|---|
| $0.006 / секунду |
| $0.006 / секунду |
| $0.012 / секунду |
| $0.024 / секунду |
Сценарии использования
Черновики в 480p — в качество для сдачи
Генерируйте дёшево в 480p или 720p, оставляйте удачный дубль и апскейлите только его, вместо того чтобы платить за каждую попытку в высоком разрешении.
Ролики для соцсетей и рекламы
Доведите короткие клипы до разрешения, которого ждут лента, посадочная страница или рекламное место, сохранив звуковую дорожку.
Старые записи на больших экранах
Дайте небольшим архивным клипам или записям экрана более чистую и крупную картинку для презентаций и больших дисплеев.
Руководство по промптам и практические советы
Сначала монтаж, потом апскейл
Апскейлите финальную версию. Иначе каждому следующему шагу придётся обрабатывать в несколько раз больше пикселей.
Отправьте
video_urlи resolutionvideo_url— клип длиной от 3 до 60 секунд; resolution выбирает 720p, 1080p (по умолчанию), 2k или 4k. Больше настраивать нечего.Опросите задачу и скачайте
Вызов асинхронный: создайте задачу, опрашивайте её до завершения и заберите MP4 из хранилища платформы. Клип в 5 секунд в 4K весит около 19 МБ.
Введение
Video Upscaler принимает готовый клип и возвращает его на более высоком уровне разрешения. Это проход повышения разрешения, а не редактор: кадрирование, движение, склейки, тайминг и исходная звуковая дорожка остаются как при отправке. Промпта нет.
Запрос
{
"video_url": "https://example.com/clip.mp4",
"resolution": "1080p"
}
Обязателен только video_url. По умолчанию resolution равен 1080p; другие уровни — 720p, 2k и 4k.
Длина клипа и оплата
Клип должен длиться от 3 до 60 секунд. Если длина известна при приёме, клип вне этого диапазона сразу отклоняется; иначе она проверяется перед началом обработки, и задача завершается ошибкой с полным возвратом. Оплата — за секунду исходного клипа с округлением вверх до целой секунды и минимумом 3 секунды, по ставке выбранного уровня. Оценка перед отправкой рассчитывается по длине загруженного клипа плюс одна секунда, а для ссылки на видео — по максимуму в 60 секунд; неиспользованная часть резерва освобождается при списании.
Что возвращается
Уровень — это бюджет пикселей, а пропорции сохраняются. Клип 832×480 вернулся в 1896×1094 на 1080p примерно после 33 секунд обработки и в 3792×2188 на 4k примерно после 103 секунд; 5-секундный MP4 в 4k весит около 19 МБ. Клип 854×480 с дорожкой AAC вернулся в 1922×1080 с той же дорожкой. Во всех тестах длительность совпала с исходником с точностью до кадра.
Ход задачи
Вызов асинхронный. Создайте задачу, опрашивайте её до конечного состояния, затем скачайте MP4 из хранилища платформы.
Советы
- Апскейлите финальный монтаж, после всех правок.
- Выбирайте уровень выше текущего разрешения клипа.
- Используйте прямую ссылку на видеофайл. Веб-страница, которая воспроизводит видео, отдаёт HTML, длину прочитать не удаётся, и вызов завершается ошибкой с возвратом средств; надёжнее всего загрузить файл.
- Начинайте с самого чистого исходника: блоки сжатия и шум тоже увеличиваются.
Быстрый старт 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-upscaler-v1/upscale",
"input": {
"resolution": "1080p",
"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.
