Tous les produits
Search
Centre de documentation

Intelligent Media Services:CreateLiveTranscodeTemplate

Dernière mise à jour :Aug 14, 2026

Crée un modèle de transcodage en temps réel pour soumettre des tâches de transcodage en temps réel.

Description de l'opération

Le transcodage multimédia en temps réel est pris en charge uniquement dans la région de Shanghai.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ice:CreateLiveTranscodeTemplate

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

Type

string

Oui

Le type de modèle. Valeurs valides :

  • normal : standard.

  • narrow-band : HD à bande étroite.

  • audio-only : audio uniquement.

  • origin : qualité d'origine.

normal

Name

string

Oui

Le nom du modèle.

mon modèle

TemplateConfig

object

Non

La configuration du modèle.

Remarque

Les exigences relatives aux paramètres transmis varient en fonction du type de modèle (Type). Lorsque Type est défini sur normal, au moins l'un des paramètres de largeur et de hauteur doit être spécifié, et les paramètres de fréquence d'images et de débit binaire sont requis. Pour les autres types de modèles, spécifiez les paramètres en fonction de vos besoins.

VideoParams

object

Non

Les paramètres vidéo.

Codec

string

Non

Le type d'encodage. Valeurs valides :

  • H.264

  • H.265

H.264

Height

string

Non

La hauteur de la vidéo transcodée. Valeurs valides :

  • Height ≥ 128

  • max(Height, Width) ≤ 2560

  • min(Height, Width) ≤ 1440

Important Pour les modèles HD à bande étroite H.265, la résolution ne doit pas dépasser 1280 × 720.

720

Width

string

Non

La largeur de la vidéo transcodée. Valeurs valides :

  • Width ≥ 128

  • max(Height, Width) ≤ 2560

  • min(Height, Width) ≤ 1440

Important Pour les modèles HD à bande étroite H.265, la résolution ne doit pas dépasser 1280 × 720.

1280

Fps

string

Non

La fréquence d'images de la vidéo transcodée. Unité : FPS. Valeurs valides : 1 à 60.

25

Bitrate

string

Non

Le débit binaire de la vidéo transcodée. Unité : kbps. Valeurs valides : 1 à 6000.

2500

Gop

string

Non

Le GOP (Group of Pictures) vidéo. Unité : images. Valeurs valides : 1 à 3000.

1000

Profile

string

Non

Le profil d'encodage. Un ensemble de fonctionnalités d'encodage spécifiques prises en charge par la vidéo. Une valeur plus élevée produit généralement une meilleure qualité d'image, mais consomme davantage de ressources d'encodage et de décodage. Valeurs valides :

  • 1 : baseline (adapté aux appareils mobiles).

  • 2 : main (adapté aux appareils à résolution standard).

  • 3 : high (adapté aux appareils à haute résolution).

2

AudioParams

object

Non

Les paramètres audio.

Codec

string

Non

Le format d'encodage audio. Valeurs valides :

  • AAC

  • MP3

AAC

Bitrate

string

Non

Le débit binaire de l'audio transcodé. Unité : kbps. Valeurs valides : 1 à 1000.

100

Samplerate

string

Non

La fréquence d'échantillonnage audio. Valeurs valides : 22050 à 96000.

Important Si AudioProfile est défini sur aac_ld, la fréquence d'échantillonnage ne doit pas dépasser 44100.

44100

Channels

string

Non

Le nombre de canaux audio. Valeurs valides :

  • 1 : mono.

  • 2 : stéréo.

2

Profile

string

Non

Le préréglage d'encodage audio. Lorsque Codec est défini sur AAC, valeurs valides :

  • aac_low

  • aac_he

  • aac_he_v2

  • aac_ld

aaclow

Éléments de réponse

Élément

Type

Description

Exemple

object

Schéma de la réponse.

RequestId

string

L'identifiant de la requête.

******3B-0E1A-586A-AC29-742247******

TemplateId

string

L'identifiant du modèle.

****20b48fb04483915d4f2cd8ac****

Exemples

JSON format

{
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "TemplateId": "****20b48fb04483915d4f2cd8ac****"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidParam.Height Invalid Parameters: Height
400 InvalidParam.Width Invalid Parameters: Width
400 InvalidParam.Fps Invalid Parameters: Fps
403 OperationDenied Your account has not enabled the ICE service.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.