> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Tencent Upscale Vidéo > - Tencent Video Upscale (tencent-video-upscale) améliore les vidéos existantes et augmente leur résolution à `720p`, `1080p`, `2k` ou `4k` - Propose 7 styles pour les prises de vue réelles, les animations, les petits visages dans les plans éloignés, la fidélité des visages, les détails renforcés et un rendu plus doux - Conserve par défaut la fréquence d’images d’origine (`model_params.max_fps: "source"`) ; utilisez `"30"`, `"60"` ou `"120"` pour définir une limite. La fréquence est uniquement réduite ; aucune interpolation d’images n’est effectuée - Facturation selon la durée de la vidéo. Consultez les [tarifs des modèles EvoLink](https://evolink.ai/models) pour les différentes résolutions et fréquences d’images de sortie - Traitement asynchrone : utilisez l’ID de tâche renvoyé pour [consulter son état](/fr/api-manual/task-management/get-task-detail) - Les tâches ne peuvent pas être annulées après leur soumission - Les URL des vidéos améliorées sont valables pendant 24 heures. Enregistrez votre vidéo rapidement ## OpenAPI ````yaml fr/api-manual/video-series/tencent/tencent-video-upscale.json POST /v1/videos/generations openapi: 3.1.0 info: title: Interface tencent-video-upscale description: >- Améliorez la qualité vidéo avec Tencent Video Upscale et augmentez la résolution à 720p, 1080p, 2K ou 4K license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Environnement de production security: - bearerAuth: [] tags: - name: Génération vidéo description: APIs liées à la génération vidéo par IA paths: /v1/videos/generations: post: tags: - Génération vidéo summary: Interface tencent-video-upscale description: >- - Tencent Video Upscale (tencent-video-upscale) améliore les vidéos existantes et augmente leur résolution à `720p`, `1080p`, `2k` ou `4k` - Propose 7 styles pour les prises de vue réelles, les animations, les petits visages dans les plans éloignés, la fidélité des visages, les détails renforcés et un rendu plus doux - Conserve par défaut la fréquence d’images d’origine (`model_params.max_fps: "source"`) ; utilisez `"30"`, `"60"` ou `"120"` pour définir une limite. La fréquence est uniquement réduite ; aucune interpolation d’images n’est effectuée - Facturation selon la durée de la vidéo. Consultez les [tarifs des modèles EvoLink](https://evolink.ai/models) pour les différentes résolutions et fréquences d’images de sortie - Traitement asynchrone : utilisez l’ID de tâche renvoyé pour [consulter son état](/fr/api-manual/task-management/get-task-detail) - Les tâches ne peuvent pas être annulées après leur soumission - Les URL des vidéos améliorées sont valables pendant 24 heures. Enregistrez votre vidéo rapidement operationId: createTencentVideoUpscaleTask requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: default_1080p: summary: >- Par défaut : style réaliste général, 1080p, fréquence d’images d’origine value: model: tencent-video-upscale video_urls: - https://example.com/my-video.mp4 explicit_defaults: summary: >- Équivalent à l’exemple précédent, avec toutes les valeurs par défaut explicites value: model: tencent-video-upscale video_urls: - https://example.com/my-video.mp4 mode: realistic quality: 1080p model_params: max_fps: source animation_4k: summary: Améliorer une vidéo d’animation en 4K value: model: tencent-video-upscale video_urls: - https://example.com/my-animation.mp4 mode: animation quality: 4k cap_frame_rate: summary: Limiter une vidéo à fréquence d’images élevée à 30 images/s value: model: tencent-video-upscale video_urls: - https://example.com/my-60fps-video.mp4 quality: 1080p model_params: max_fps: '30' with_callback: summary: Avec URL de callback value: model: tencent-video-upscale video_urls: - https://example.com/my-video.mp4 mode: face_fidelity quality: 2k callback_url: https://your-domain.com/webhooks/video-task-completed responses: '200': description: Tâche d’amélioration vidéo créée avec succès content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: Paramètres de requête invalides content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_video: summary: URL vidéo manquante value: error: code: invalid_parameter message: >- video_urls is required and must not be empty for tencent-video-upscale type: invalid_request_error invalid_mode: summary: Style d’amélioration non valide value: error: code: invalid_parameter message: >- invalid mode "general" for tencent-video-upscale; supported: realistic, realistic_distant, animation, animation_distant, face_fidelity, detail_boost, soft type: invalid_request_error invalid_max_fps: summary: Limite de fréquence d’images non valide value: error: code: invalid_parameter message: >- invalid model_params.max_fps auto for tencent-video-upscale; supported: "source", 30, 60, 120 type: invalid_request_error too_long: summary: La vidéo dépasse 60 secondes value: error: code: invalid_parameter message: video duration 75.2s exceeds the 60s limit type: invalid_request_error source_too_large: summary: La vidéo source dépasse 4K value: error: code: invalid_parameter message: >- source video resolution exceeds 4K (short side 2880px > 2160px) type: invalid_request_error target_too_low: summary: La résolution cible est inférieure à celle de la source value: error: code: invalid_parameter message: >- target quality 720p is lower than the source video (short side 1080px); choose a higher quality type: invalid_request_error top_level_fps: summary: Le paramètre fps au premier niveau n’est pas pris en charge value: error: code: invalid_parameter message: >- fps is not supported for tencent-video-upscale; use model_params.max_fps (30, 60 or 120) to cap the output frame rate type: invalid_request_error probe_failed: summary: Échec de la lecture des métadonnées vidéo value: error: code: video_probe_failed message: >- Failed to read the video's duration, resolution and frame rate. Please provide a publicly downloadable MP4 or MOV video URL type: invalid_request_error '401': description: Non authentifié, jeton invalide ou expiré content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Quota insuffisant, recharge requise content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Accès refusé content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: tencent-video-upscale' type: invalid_request_error '429': description: Limite de débit dépassée content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Erreur interne du serveur content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error '503': description: >- Service temporairement indisponible. Réessayez plus tard ou contactez l’assistance content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: VideoGenerationRequest: type: object required: - model - video_urls properties: model: type: string description: Nom du modèle d’augmentation de résolution vidéo enum: - tencent-video-upscale default: tencent-video-upscale example: tencent-video-upscale video_urls: type: array description: >- 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` items: type: string format: uri minItems: 1 maxItems: 1 example: - https://example.com/my-video.mp4 mode: type: string description: >- 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 enum: - realistic - realistic_distant - animation - animation_distant - face_fidelity - detail_boost - soft default: realistic example: realistic quality: type: string description: >- 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 enum: - 720p - 1080p - 2k - 4k default: 1080p example: 1080p model_params: type: object description: Paramètres propres au modèle properties: max_fps: type: string description: >- Fréquence d’images maximale de la vidéo de sortie. Par défaut, `"source"` conserve la fréquence d’images d’origine ; omettre ce paramètre équivaut à `"source"` **Options :** - `"source"` - Conserver la fréquence d’images d’origine — **valeur par défaut** - `"30"` - Fréquence de sortie limitée à 30 images/s - `"60"` - Fréquence de sortie limitée à 60 images/s - `"120"` - Fréquence de sortie limitée à 120 images/s **Comportement :** - Si la fréquence d’origine ne dépasse pas la limite, elle est conservée ; **aucune interpolation d’images n’est effectuée**. Au-delà, elle est réduite à la limite - Avec `"source"` ou sans ce paramètre, les fréquences d’origine supérieures à `120` images/s sont tout de même réduites à `120` images/s **Types acceptés :** - Les chaînes de caractères sont recommandées. Les entiers `30`, `60` et `120` sont aussi acceptés (par exemple, `"60"` et `60` sont équivalents) - `"source"` est insensible à la casse - Les autres valeurs (comme `45`, `60.5` ou `"auto"`) sont rejetées - Ce modèle n’accepte pas le paramètre `fps` au premier niveau enum: - source - '30' - '60' - '120' default: source example: '30' callback_url: type: string description: >- 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 format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: Horodatage de création de la tâche example: 1757169743 id: type: string description: ID de tâche example: task-unified-1757169743-7cvnl5zw model: type: string description: Nom du modèle réellement utilisé example: tencent-video-upscale object: type: string enum: - video.generation.task description: Type de tâche progress: type: integer description: Pourcentage de progression de la tâche (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Statut de la tâche enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Informations détaillées de la tâche vidéo type: type: string enum: - text - image - audio - video description: Type de sortie de la tâche example: video usage: $ref: '#/components/schemas/VideoUsage' description: Informations d'utilisation et de facturation ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Identifiant du code d'erreur message: type: string description: Description de l'erreur type: type: string description: Type d'erreur VideoTaskInfo: type: object properties: can_cancel: type: boolean description: >- Indique si la tâche peut être annulée (les tâches de ce modèle ne peuvent pas être annulées après leur soumission) example: false estimated_time: type: integer description: >- Temps estimé de traitement en secondes. Le temps réel dépend de la file d’attente ; la 4K, les fréquences d’images élevées et les vidéos longues prennent nettement plus de temps minimum: 0 example: 120 video_duration: type: integer description: Durée de la vidéo (secondes) example: 0 VideoUsage: type: object description: Informations d'utilisation et de facturation properties: billing_rule: type: string description: >- Règle de facturation. Ce modèle est facturé selon la durée de la vidéo avec `per_second`. Consultez les [tarifs des modèles EvoLink](https://evolink.ai/models) pour les prix applicables enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: >- Consommation estimée de crédits (préautorisation). La consommation finale est calculée une fois la tâche terminée ; le montant final figure sur votre facture minimum: 0 example: 3.264 user_group: type: string description: Catégorie de groupe d'utilisateurs example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Toutes les API nécessitent une authentification Bearer Token## **Obtenir une clé API :** Visitez la [Page de gestion des clés API](https://evolink.ai/dashboard/keys) pour obtenir votre clé API **Ajouter à l'en-tête de requête :** ``` Authorization: Bearer YOUR_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.