AddLiveAISubtitle - - Centre de documentation Alibaba Cloud

Ajoute un modèle de sous-titres en appelant AddLiveAISubtitle.

Description de l'opération

Description

Cette opération vous permet d'ajouter une configuration de modèle de sous-titres en direct. La configuration du modèle décrit le contenu des sous-titres, la mise en page et d'autres informations.
Après avoir ajouté un modèle de sous-titres, appelez l'opération AddLiveAIProduceRules pour ajouter des règles de sous-titres. Les sous-titres ne prennent effet dans le flux qu'après le redémarrage de l'ingestion du flux.
Les sous-titres en temps réel sont pris en charge uniquement dans les régions Chine (Pékin), Chine (Shanghai), Singapour, Indonésie (Jakarta) et Arabie saoudite (Riyad).

Important La fonctionnalité de sous-titres en temps réel est actuellement en préversion publique. Chaque utilisateur peut ajouter jusqu'à 300 modèles de sous-titres. Cette fonctionnalité est gratuite pendant la préversion publique. Une fois la préversion publique terminée, la tarification standard s'applique. La date précise sera annoncée ultérieurement.

Limite de QPS

La limite de QPS par utilisateur pour cette opération est de 60 appels par seconde. Si cette limite est dépassée, les appels d'API sont limités, ce qui peut affecter votre activité. Appelez cette opération de manière appropriée. Pour plus d'informations, consultez Limite de QPS.

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.

live:AddLiveAISubtitle

create

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Non	L'identifiant de la région.	cn-shanghai
SubtitleName	string	Oui	Le nom du modèle de sous-titres. Le nom ne peut contenir que des chiffres, des lettres et des traits d'union (-). Le nom ne peut pas commencer par un trait d'union.	sub01
SrcLanguage	string	Oui	La langue source. Valeurs valides : Anglais : en-US Chinois : zh-CN Russe : ru-RU	zh-CN
DstLanguage	string	Non	La langue cible pour la traduction. Valeurs valides : Anglais : en-US Chinois : zh-CN Espagnol : es-ES Russe : ru-RU	zh-CN
FontColor	string	Non	La couleur de la police. Spécifiez la valeur au format RGBA.	0xFFFFFF
FontName	string	Non	La police. Valeurs valides : KaiTi : KaiTi (par défaut) AlibabaPuHuiTi-Regular : Alibaba PuHuiTi Regular AlibabaPuHuiTi-Bold : Alibaba PuHuiTi Bold AlibabaPuHuiTi-Light : Alibaba PuHuiTi Light NotoSansHans-Regular : Noto Sans SC Regular NotoSansHans-Bold : Noto Sans SC Bold NotoSansHans-Light : Noto Sans SC Light	KaiTi
BgColor	string	Non	La couleur d'arrière-plan du sous-titre. Spécifiez la valeur au format RGBA.	0xFF0000
PositionNormalized	array	Oui	La position du sous-titre. La valeur correspond aux coordonnées x,y avec le coin inférieur gauche de l'écran comme origine. Remarque Les valeurs x et y doivent être normalisées. Les valeurs réelles sont multipliées par la hauteur de l'écran. Par exemple, si la hauteur de l'écran est de 720p et que PositionNormalized est défini sur [0.1,0.5], la position réelle du sous-titre est x = 72 et y = 360.	[0.32,0.27]
	number	Non	La valeur des coordonnées de la position du sous-titre.	0.32
ShowSourceLan	boolean	Non	Indique si la langue source doit être affichée. Valeur par défaut : false.	true
MaxLines	integer	Non	Le nombre de lignes à afficher.	2
WordPerLine	integer	Oui	Le nombre de caractères par ligne. Valeurs valides : entiers dans la plage [1, 500].	20
FontSizeNormalized	number	Oui	La taille de la police. Valeurs valides : [0, 1].	0.037
BorderWidthNormalized	number	Non	L'épaisseur de la police. Valeurs valides : [0, 1].	0.05
BgWidthNormalized	number	Non	La taille de l'arrière-plan du sous-titre. Valeurs valides : [0, 1].	0.09
CopyFrom	string	Non	Le modèle de sous-titres à partir duquel copier. Définissez ce paramètre sur la valeur de SubtitleName.	sub01
Description	string	Non	La description personnalisée du sous-titre. La description peut contenir des caractères chinois, des lettres, des chiffres et des caractères spéciaux, et ne peut pas dépasser 128 caractères.	modèle de sous-titres IA en direct
Width	string	Non	La largeur de l'écran d'aperçu. Unité : px.	1280
Height	string	Non	La hauteur de l'écran d'aperçu. Unité : px. La largeur × hauteur de l'écran d'aperçu prend en charge uniquement les spécifications suivantes : Basse définition paysage 360P : 640 × 360 Basse définition portrait 360P : 360 × 640 Définition standard paysage 480P : 854 × 480 Définition standard portrait 480P : 480 × 854 Haute définition paysage 720P : 1280 × 720 Haute définition portrait 720P : 720 × 1280 Ultra haute définition paysage 1080P : 1920 × 1080 Ultra haute définition portrait 1080P : 1080 × 1920	720

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	5c6a2a0df228-4a64-af62-20e91b96****
SubtitleId	string	L'identifiant du modèle de sous-titres.	445409ec-7eaa-461d-8f29-4bec2eb9****

Exemples

JSON format

{
  "RequestId": "5c6a2a0df228-4a64-af62-20e91b96****",
  "SubtitleId": "445409ec-7eaa-461d-8f29-4bec2eb9****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidParameter	%s.	Les paramètres spécifiés sont invalides. Vérifiez si les paramètres d'entrée sont complets et corrects.
400	MissingParameter	%s.	Un paramètre requis est manquant.
400	InvalidParameter.Malformed	There are invalid parameters: %s.	Des paramètres invalides sont présents : %s.

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

Notes de version

Consultez Notes de version pour la liste complète.