Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
resolution | Нет | Размер результата. Больше — чётче и дороже. 720p · 1080p · 2k · 4k · По умолчанию: 1080p |
video_url | Да | Ролик, с которым работаем. |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за секунду | ≈ USD |
|---|---|---|
| resolution 1080p | 0,9 | 0,009 $ |
| resolution 720p | 0,9 | 0,009 $ |
| resolution 2K | 1,8 | 0,018 $ |
| resolution 4K | 3,6 | 0,036 $ |
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Video Upscaler в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model popnow/video-upscaler-v1/upscale и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/video-upscaler-v1/upscale",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"resolution": "1080p"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Video Upscaler
Сколько стоит API Video Upscaler?
Video Upscaler стоит 0,9 кредита (0,009 $) за секунду. Цены по вариантам: 1080p 0,9 кредита за секунду, 720p 0,9 кредита за секунду, 2K 1,8 кредита за секунду, 4K 3,6 кредита за секунду. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Video Upscaler в API?
Укажите popnow/video-upscaler-v1/upscale — Улучшить видео в поле model запроса POST /jobs/createTask.
Сохраняются ли звук и тайминг?
Да. Клип 854×480 с дорожкой AAC вернулся в 1922×1080 с той же дорожкой, а во всех тестах длительность совпала с исходником с точностью до кадра.
Почему результат в 1080p не ровно 1920×1080?
Уровень — это бюджет пикселей, а пропорции клипа сохраняются. Клип 832×480 вернулся в 1896×1094 в 1080p и в 3792×2188 в 4K; вертикальный клип возвращается вертикальным.
Меняется ли движение или то, что происходит в кадре?
Нет. Это проход повышения разрешения: кадрирование, движение, склейки и тайминг остаются как при отправке. Чтобы изменить содержимое, сначала отредактируйте или сгенерируйте заново, а апскейл делайте последним.
Какие ограничения у API Video Upscaler?
Разрешения: 720p · 1080p · 2K · 4K. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Video Upscaler без кода?
Да. Playground запускает Video Upscaler на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
