Video Upscaler API

Vollständige API-Referenz für die FlaqAI Video Upscaler-Modelle.

Modellvarianten

Diese API unterstützt zwei Varianten der Video-Hochskalierung:

Schnellvergleich

Hochskalierungsaufgabe erstellen

Endpunkt

httpKopieren
POST /api/v1/video/task

Anfrageparameter

Erforderlich

Das Seitenverhältnis der Ausgabe wird durch das Quellvideo bestimmt und kann nicht separat festgelegt werden.

Antwortformat

Erste Antwort

Alle Modelle geben eine task_id für die Statusabfrage zurück:

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

Antwort der Statusabfrage

Rufen Sie GET /api/v1/video/{taskId} regelmäßig auf, um den Status zu prüfen:

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

Statuswerte

• submitted: Aufgabe angenommen und wartet auf Verarbeitung
• processing: Videogenerierung läuft
• succeed: Videogenerierung abgeschlossen
• failed: Videogenerierung fehlgeschlagen

Verarbeitungszeit

Die typische Verarbeitungszeit beträgt je nach Dauer des hochgeladenen Videos und Zielauflösung 2–5 Minuten.

Fragen Sie den Status alle 5–10 Sekunden ab.

Bewährte Methoden

• Verwenden Sie für video_url eine stabile, öffentlich zugängliche HTTPS-URL.
• Wählen Sie die Zielauflösung entsprechend der Qualität des Quellmaterials; eine höhere Auflösung kann keine Details wiederherstellen, die in der Quelle fehlen.
• Berücksichtigen Sie bei der Schätzung der Credits für kurze Videos die Mindestabrechnungsdauer von 5 Sekunden.
• Verwenden Sie video-upscaler für kostensensible Workflows und video-upscaler-pro, wenn die Optimierungsqualität Priorität hat.