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 วินาที

แนวทางปฏิบัติที่ดีที่สุด

• ใช้ URL แบบ HTTPS ที่เสถียรและเข้าถึงได้แบบสาธารณะสำหรับ video_url
• เลือกความละเอียดเป้าหมายตามคุณภาพต้นฉบับ การเพิ่มความละเอียดไม่สามารถกู้คืนรายละเอียดที่ไม่มีอยู่ในต้นฉบับได้
• คำนึงถึงระยะเวลาขั้นต่ำที่เรียกเก็บเงิน 5 วินาทีเมื่อประมาณเครดิตสำหรับวิดีโอสั้น
• ใช้ video-upscaler สำหรับเวิร์กโฟลว์ที่คำนึงถึงต้นทุน และใช้ video-upscaler-pro เมื่อให้ความสำคัญกับคุณภาพการปรับปรุง