API Video Upscaler

Полная справочная документация API для моделей FlaqAI Video Upscaler.

Варианты модели

Этот API поддерживает два варианта масштабирования видео:

Краткое сравнение

Создание задачи масштабирования

Конечная точка

httpКопировать
POST /api/v1/video/task

Параметры запроса

Обязательные

Соотношение сторон результата определяется исходным видео и не может быть задано отдельно.

Формат ответа

Первоначальный ответ

Все модели возвращают task_id для опроса статуса:

jsonКопировать
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Ответ на опрос

Для проверки статуса периодически запрашивайте GET /api/v1/video/{taskId}:

jsonКопировать
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Значения статуса

• submitted: задача принята и ожидает обработки
• processing: выполняется генерация видео
• succeed: генерация видео завершена
• failed: не удалось сгенерировать видео

Время обработки

Обычно обработка занимает 2–5 минут в зависимости от длительности загруженного видео и целевого разрешения.

Проверяйте статус каждые 5–10 секунд.

Рекомендации {#}

• Используйте для video_url стабильный общедоступный URL с протоколом HTTPS.
• Выбирайте целевое разрешение с учетом качества исходного материала: повышение разрешения не может восстановить детали, отсутствующие в оригинале.
• При расчете кредитов для коротких видео учитывайте минимальную оплачиваемую длительность в 5 секунд.
• Используйте video-upscaler для процессов с ограниченным бюджетом, а video-upscaler-pro — когда приоритетом является качество улучшения.