Skip to main content
POST

Autorizaciones

Authorization
string
header
requerido

##Todas las APIs requieren autenticación Bearer Token##

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Cuerpo

application/json
model
enum<string>
predeterminado:tencent-video-upscale
requerido

Nombre del modelo de escalado de video

Opciones disponibles:
tencent-video-upscale
Ejemplo:

"tencent-video-upscale"

video_urls
string<uri>[]
requerido

Lista de URL de los videos de entrada

Notas:

  • Solo se admite 1 video por solicitud (si se proporcionan varios, solo se usa el primero)
  • La URL del video debe ser directamente accesible para el servidor (URL pública o prefirmada)
  • Formatos admitidos: .mp4, .mov
  • Duración máxima: 60 segundos
  • Resolución máxima del original: 4K (lado corto de hasta 2160 píxeles)
  • Al enviar la solicitud, el servidor lee la duración, la resolución y la tasa de fotogramas. Si la lectura falla, devuelve video_probe_failed
Required array length: 1 element
Ejemplo:
mode
enum<string>
predeterminado:realistic

Estilo de mejora. Elige según el contenido del video

Opciones:

  • realistic - Realista general: grabaciones reales y otras escenas habituales — predeterminado
  • realistic_distant - Realista, planos lejanos: optimizado para rostros pequeños en planos lejanos
  • animation - Animación general: animación, anime y dibujos animados
  • animation_distant - Animación, planos lejanos: optimizado para rostros pequeños en escenas animadas con personajes lejanos
  • face_fidelity - Fidelidad facial: conserva los rasgos faciales originales en la medida de lo posible
  • detail_boost - Refuerzo de detalles: resalta texturas y bordes
  • soft - Suave: menor enfoque para un aspecto más natural

No distingue entre mayúsculas y minúsculas. Los valores no válidos se rechazan

Opciones disponibles:
realistic,
realistic_distant,
animation,
animation_distant,
face_fidelity,
detail_boost,
soft
Ejemplo:

"realistic"

quality
enum<string>
predeterminado:1080p

Resolución de destino, medida por el lado corto del video

Opciones:

  • 720p - Lado corto de 720 píxeles
  • 1080p - Lado corto de 1080 píxeles — predeterminado
  • 2k - Lado corto de 1440 píxeles
  • 4k - Lado corto de 2160 píxeles

Notas:

  • La resolución de destino no puede ser inferior a la original. Por ejemplo, un video 1080p admite 1080p, 2k o 4k; se rechaza 720p
  • Elegir el nivel más bajo que sea al menos igual a la resolución original mantiene el tamaño de la imagen prácticamente sin cambios
Opciones disponibles:
720p,
1080p,
2k,
4k
Ejemplo:

"1080p"

model_params
object

Parámetros específicos del modelo

callback_url
string<uri>

Dirección de callback HTTPS después de completar la tarea

Momento del callback:

  • Se activa cuando la tarea se completa, falla o se cancela
  • Se envía después de completar la confirmación de facturación

Restricciones de seguridad:

  • Solo se admite el protocolo HTTPS
  • El callback a direcciones IP internas está prohibido (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • La longitud de la URL no debe exceder 2048 caracteres

Mecanismo de callback:

  • Tiempo de espera: 10 segundos
  • Máximo 3 reintentos en caso de fallo (reintentos después de 1 segundo/2 segundos/4 segundos)
  • El formato del cuerpo de respuesta del callback es consistente con el formato de respuesta de la API de consulta de tareas
  • La dirección de callback que devuelve un código de estado 2xx se considera exitosa, otros códigos de estado activarán reintentos
Ejemplo:

"https://your-domain.com/webhooks/video-task-completed"

Respuesta

Tarea de mejora de video creada correctamente

created
integer

Marca de tiempo de creación de la tarea

Ejemplo:

1757169743

id
string

ID de tarea

Ejemplo:

"task-unified-1757169743-7cvnl5zw"

model
string

Nombre del modelo real utilizado

Ejemplo:

"tencent-video-upscale"

object
enum<string>

Tipo de tarea

Opciones disponibles:
video.generation.task
progress
integer

Porcentaje de progreso de la tarea (0-100)

Rango requerido: 0 <= x <= 100
Ejemplo:

0

status
enum<string>

Estado de la tarea

Opciones disponibles:
pending,
processing,
completed,
failed
Ejemplo:

"pending"

task_info
object

Información detallada de la tarea de video

type
enum<string>

Tipo de salida de la tarea

Opciones disponibles:
text,
image,
audio,
video
Ejemplo:

"video"

usage
object

Información de uso y facturación