Video Upscaler API

Complete API reference for FlaqAI Video Upscaler models.

Model Variants

This API supports two video upscaling variants:

Quick Comparison

Create an Upscaling Task

Endpoint

httpCopy
POST /api/v1/video/task

Request Parameters

Required

The output aspect ratio is determined by the source video and cannot be set separately.

Response Format

Initial Response

All models return a task_id for polling:

jsonCopy
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Polling Response

Poll GET /api/v1/video/{taskId} to check status:

jsonCopy
{
  "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"
        }
      ]
    }
  }
}

Status Values

• submitted: Task accepted and waiting to be processed
• processing: Video generation in progress
• succeed: Video generation completed
• failed: Video generation failed

Processing Time

Typical processing time is 2–5 minutes, depending on the duration of the uploaded video and the target resolution.

Poll every 5-10 seconds to check status.

Best Practices

• Use a stable, publicly accessible HTTPS URL for video_url.
• Choose the target resolution according to the source quality; increasing resolution cannot restore details absent from the source.
• Account for the 5-second minimum billed duration when estimating credits for short videos.
• Use video-upscaler for cost-sensitive workflows and video-upscaler-pro when enhancement quality is the priority.