API Video Upscaler

Riferimento API completo per i modelli FlaqAI Video Upscaler.

Varianti del modello

Questa API supporta due varianti di upscaling video:

Modello	ID	Descrizione
Video Upscaler	`video-upscaler`	Upscaling video standard con una tariffazione al secondo conveniente
Video Upscaler Pro	`video-upscaler-pro`	Upscaling video premium per un miglioramento di qualità superiore

Confronto rapido

Funzionalità	Video Upscaler	Video Upscaler Pro
Ingresso	URL del video	URL del video
Risoluzioni di destinazione	720p, 1080p, 2k, 4k	720p, 1080p, 2k, 4k
Proporzioni	Determinate dal file sorgente	Determinate dal file sorgente
Durata minima fatturata	5 secondi	5 secondi

Creare un'attività di upscaling

Punto di accesso

http
POST /api/v1/video/task

Parametri della richiesta

Obbligatori

Parametro	Tipo	Descrizione
`model_name`	string	`"video-upscaler"` o `"video-upscaler-pro"`
`video_url`	string	URL accessibile pubblicamente del video sorgente
`target_resolution`	string	Risoluzione di output: `"720p"`, `"1080p"`, `"2k"` o `"4k"`

Le proporzioni dell'output sono determinate dal video sorgente e non possono essere impostate separatamente.

Formato della risposta

Risposta iniziale

Tutti i modelli restituiscono un task_id per il polling:

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

Risposta del polling

Esegui il polling di GET /api/v1/video/{taskId} per verificare lo stato:

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

Valori di stato

submitted: Attività accettata e in attesa di elaborazione
processing: Generazione del video in corso
succeed: Generazione del video completata
failed: Generazione del video non riuscita

Tempo di elaborazione

Il tempo di elaborazione tipico è di 2–5 minuti, a seconda della durata del video caricato e della risoluzione di destinazione.

Esegui il polling ogni 5–10 secondi per verificare lo stato.

Procedure consigliate

Usa un URL HTTPS stabile e accessibile pubblicamente per video_url.
Scegli la risoluzione di destinazione in base alla qualità del file sorgente; aumentare la risoluzione non può ripristinare dettagli assenti nel file sorgente.
Tieni conto della durata minima fatturata di 5 secondi quando stimi i crediti per i video brevi.
Usa video-upscaler per i flussi di lavoro attenti ai costi e video-upscaler-pro quando la priorità è la qualità del miglioramento.