API Video Upscaler

Referensi API lengkap untuk model FlaqAI Video Upscaler.

Varian Model

API ini mendukung dua varian peningkatan skala video:

Perbandingan Singkat

Membuat Tugas Peningkatan Skala

Titik akhir

httpSalin
POST /api/v1/video/task

Parameter Permintaan

Wajib

Rasio aspek output ditentukan oleh video sumber dan tidak dapat diatur secara terpisah.

Format Respons

Respons Awal

Semua model mengembalikan task_id untuk polling:

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

Respons Polling

Lakukan polling GET /api/v1/video/{taskId} untuk memeriksa status:

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

Nilai Status

• submitted: Tugas diterima dan menunggu untuk diproses
• processing: Pembuatan video sedang berlangsung
• succeed: Pembuatan video selesai
• failed: Pembuatan video gagal

Waktu Pemrosesan

Waktu pemrosesan biasanya 2–5 menit, tergantung pada durasi video yang diunggah dan resolusi target.

Lakukan polling setiap 5–10 detik untuk memeriksa status.

Praktik Terbaik

• Gunakan URL HTTPS stabil yang dapat diakses secara publik untuk video_url.
• Pilih resolusi target sesuai kualitas sumber; meningkatkan resolusi tidak dapat memulihkan detail yang tidak ada pada sumber.
• Pertimbangkan durasi tagihan minimum 5 detik saat memperkirakan kredit untuk video pendek.
• Gunakan video-upscaler untuk alur kerja yang peka terhadap biaya dan video-upscaler-pro jika kualitas penyempurnaan menjadi prioritas.