Skip to main content
POST

Autorisations

​
Authorization
string
header
requis

##Toutes les API nécessitent une authentification Bearer Token##

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Corps

application/json
​
model
enum<string>
défaut:tencent-video-upscale
requis

Nom du modèle d’augmentation de résolution vidéo

Options disponibles:
tencent-video-upscale
Exemple:

"tencent-video-upscale"

​
video_urls
string<uri>[]
requis

Liste des URL des vidéos d’entrée

Remarques :

  • Une seule vidéo (1) est prise en charge par requête (si plusieurs sont fournies, seule la première est utilisée)
  • L’URL vidéo doit être directement accessible au serveur (URL publique ou présignée)
  • Formats pris en charge : .mp4, .mov
  • Durée maximale : 60 secondes
  • Résolution source maximale : 4K (côté court ne dépassant pas 2160 pixels)
  • Lors de la soumission, le serveur lit la durée, la résolution et la fréquence d’images de la vidéo. En cas d’échec, il renvoie video_probe_failed
Required array length: 1 element
Exemple:
​
mode
enum<string>
défaut:realistic

Style d’amélioration à choisir selon le contenu de la vidéo

Options :

  • realistic - Réaliste général : prises de vue réelles et autres scènes courantes — valeur par défaut
  • realistic_distant - Réaliste, plans éloignés : optimisé pour les petits visages dans les plans éloignés
  • animation - Animation générale : animation, anime et dessins animés
  • animation_distant - Animation, plans éloignés : optimisé pour les petits visages dans les scènes animées avec des personnages éloignés
  • face_fidelity - Fidélité des visages : préserve autant que possible les traits d’origine
  • detail_boost - Renforcement des détails : accentue les textures et les contours
  • soft - Doux : accentuation plus légère pour un rendu plus naturel

Insensible à la casse. Les valeurs non valides sont rejetées

Options disponibles:
realistic,
realistic_distant,
animation,
animation_distant,
face_fidelity,
detail_boost,
soft
Exemple:

"realistic"

​
quality
enum<string>
défaut:1080p

Résolution cible, mesurée sur le côté court de la vidéo

Options :

  • 720p - Côté court de 720 pixels
  • 1080p - Côté court de 1080 pixels — valeur par défaut
  • 2k - Côté court de 1440 pixels
  • 4k - Côté court de 2160 pixels

Remarques :

  • La résolution cible ne peut pas être inférieure à celle de la source. Par exemple, une source 1080p accepte 1080p, 2k ou 4k ; 720p est rejeté
  • Choisir le palier le plus bas qui est au moins égal à la résolution source laisse la taille de l’image pratiquement inchangée
Options disponibles:
720p,
1080p,
2k,
4k
Exemple:

"1080p"

​
model_params
object

Paramètres propres au modèle

​
callback_url
string<uri>

Adresse de rappel HTTPS après l'achèvement de la tâche

Moment du rappel :

  • Déclenché lorsque la tâche est terminée, échouée ou annulée
  • Envoyé après confirmation de la facturation

Restrictions de sécurité :

  • Seul le protocole HTTPS est pris en charge
  • Les rappels vers les adresses IP internes sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • La longueur de l'URL ne doit pas dépasser 2048 caractères

Mécanisme de rappel :

  • Délai d'expiration : 10 secondes
  • Maximum 3 tentatives en cas d'échec (tentatives après 1 seconde/2 secondes/4 secondes)
  • Le format du corps de réponse du rappel est cohérent avec le format de réponse de l'API de requête de tâche
  • Un code de statut 2xx renvoyé par l'adresse de rappel est considéré comme un succès, les autres codes de statut déclenchent une nouvelle tentative
Exemple:

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

Réponse

Tâche d’amélioration vidéo créée avec succès

​
created
integer

Horodatage de création de la tâche

Exemple:

1757169743

​
id
string

ID de tâche

Exemple:

"task-unified-1757169743-7cvnl5zw"

​
model
string

Nom du modèle réellement utilisé

Exemple:

"tencent-video-upscale"

​
object
enum<string>

Type de tâche

Options disponibles:
video.generation.task
​
progress
integer

Pourcentage de progression de la tâche (0-100)

Plage requise: 0 <= x <= 100
Exemple:

0

​
status
enum<string>

Statut de la tâche

Options disponibles:
pending,
processing,
completed,
failed
Exemple:

"pending"

​
task_info
object

Informations détaillées de la tâche vidéo

​
type
enum<string>

Type de sortie de la tâche

Options disponibles:
text,
image,
audio,
video
Exemple:

"video"

​
usage
object

Informations d'utilisation et de facturation