API de Video Upscaler

Referencia completa de la API para los modelos FlaqAI Video Upscaler.

Variantes del modelo

Esta API admite dos variantes de escalado de vídeo:

Comparación rápida

Crear una tarea de escalado

Punto de acceso

httpCopiar
POST /api/v1/video/task

Parámetros de la solicitud

Obligatorios

La relación de aspecto de salida se determina a partir del vídeo de origen y no puede configurarse por separado.

Formato de la respuesta

Respuesta inicial

Todos los modelos devuelven un task_id para la consulta periódica:

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

Respuesta de la consulta

Consulta GET /api/v1/video/{taskId} para comprobar el estado:

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

Valores de estado

• submitted: Tarea aceptada y en espera de procesamiento
• processing: Generación del vídeo en curso
• succeed: Generación del vídeo completada
• failed: Error en la generación del vídeo

Tiempo de procesamiento

El tiempo de procesamiento habitual es de 2 a 5 minutos, dependiendo de la duración del vídeo subido y de la resolución de destino.

Consulta el estado cada 5-10 segundos.

Prácticas recomendadas

• Usa una URL HTTPS estable y de acceso público para video_url.
• Elige la resolución de destino según la calidad del archivo de origen; aumentar la resolución no permite recuperar detalles que no existen en el original.
• Ten en cuenta la duración mínima facturada de 5 segundos cuando calcules los créditos de vídeos cortos.
• Usa video-upscaler para flujos de trabajo sensibles al coste y video-upscaler-pro cuando la prioridad sea la calidad de la mejora.