AddWaterMarkTemplate - - Centre de documentation Alibaba Cloud

Crée un modèle de filigrane.

Description de l'opération

Après avoir créé un modèle de filigrane en appelant cette opération, vous pouvez spécifier le modèle de filigrane et la ressource de filigrane lorsque vous soumettez une tâche de transcodage. Cela vous permet d'ajouter des informations de filigrane à la vidéo de sortie.

Limite de QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde et par compte. Les requêtes qui dépassent cette limite sont abandonnées et vous subirez des interruptions de service. Nous vous recommandons de prendre en compte cette limite lors de l'appel de cette opération. 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.

mts:AddWaterMarkTemplate

create

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Name	string	Oui	Le nom du modèle de filigrane. La valeur peut contenir des lettres et des chiffres et sa taille peut atteindre 128 octets.	example-watermark-****
Config	string	Oui	La configuration du modèle de filigrane. La valeur est un objet JSON. Pour plus d'informations, consultez la section « WaterMarks » de la rubrique Détails des paramètres. Remarque Si vous n'avez pas besoin d'une corrélation positive entre la taille du texte du filigrane et la résolution, vous pouvez activer l'adaptation pour le filigrane. Pour ce faire, ajoutez `['adaptive']=true` au paramètre TextWaterMark.	{"Width":"10","Height":"30","Dx":"10","Dy":"5","ReferPos":"TopRight","Type":"Image","Timeline":{"Start":"0","Duration":"10"}}

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
WaterMarkTemplate	object	Les détails du modèle de filigrane.
Type	string	Le type de filigrane. Valeurs valides : Image : un filigrane d'image. Text : un filigrane textuel.	Image
RatioRefer	object	Les valeurs des paramètres Height, Width, Dx et Dy par rapport aux bords de référence. Si les valeurs des paramètres Height, Width, Dx et Dy sont des décimales comprises entre 0 et 1, les valeurs sont calculées en se référant aux bords suivants dans l'ordre : Width : le bord de la largeur. Height : le bord de la hauteur. Long : le bord long. Short : le bord court.
Dx	string	The horizontal offset of the watermark relative to the output video image. Default value: 0. The default value indicates no offset. The value can be an integer or a decimal. Integer: the vertical offset. This indicates the absolute position. Unit: pixel. Decimal: the ratio of the horizontal offset to the width of the output video. The ratio varies based on the size of the video. Four decimal places are supported, such as 0.9999. More decimal places are discarded.	0.51
Width	string	The width of the watermark image in the output video. The value can be an integer or a decimal. Integer: the width of the watermark image. This indicates the absolute position. Unit: pixel. Decimal: the ratio of the width of the watermark image to the width of the output video. The ratio varies based on the size of the video. Four decimal places are supported, such as 0.9999. More decimal places are discarded.	0.36
Height	string	The height of the watermark image in the output video. The value can be an integer or a decimal. Integer: the height of the watermark image. This indicates the absolute position. Unit: pixel. Decimal: the ratio of the height of the watermark image to the height of the output video. The ratio varies based on the size of the video. Four decimal places are supported, such as 0.9999. More decimal places are discarded.	0.33
Dy	string	The vertical offset of the watermark relative to the output video image. Default value: 0. The default value indicates no offset. The value can be an integer or a decimal. Integer: the vertical offset. This indicates the absolute position. Unit: pixel. Decimal: the ratio of the vertical offset to the height of the output video. The ratio varies based on the size of the video. Four decimal places are supported, such as 0.9999. More decimal places are discarded.	0.28
ReferPos	string	La position du filigrane. Valeurs valides : TopRight : le coin supérieur droit. TopLeft : le coin supérieur gauche. BottomRight : le coin inférieur droit. BottomLeft : le coin inférieur gauche.	TopRight
State	string	L'état du modèle de filigrane. Normal : le modèle de filigrane est normal. Deleted : le modèle de filigrane est supprimé.	Normal
Dx	string	Le décalage horizontal. Unité : pixel.	10
Width	string	La largeur de l'image du filigrane. Unité : pixel.	10
Height	string	La hauteur de l'image du filigrane. Unité : pixel.	30
Timeline	object	La chronologie du filigrane.
Start	string	The beginning of the time range during which the watermark is displayed. Unit: seconds. Default value: 0.	0
Duration	string	The display duration of the watermark. Default value: ToEND. The default value indicates that the watermark is displayed until the video ends.	ToEND
Name	string	Le nom du modèle de filigrane.	example-watermark-****
Dy	string	Le décalage vertical. Unité : pixel.	5
Id	string	L'identifiant du modèle de filigrane. Nous vous recommandons de conserver cet identifiant pour les appels d'opérations ultérieurs.	3780bd69b2b74540bc7b1096f564****
RequestId	string	L'identifiant de la requête.	54BB917F-DD35-4F32-BABA-E60E31B21W63

Exemples

JSON format

{
  "WaterMarkTemplate": {
    "Type": "Image",
    "RatioRefer": {
      "Dx": "0.51",
      "Width": "0.36",
      "Height": "0.33",
      "Dy": "0.28"
    },
    "ReferPos": "TopRight",
    "State": "Normal",
    "Dx": "10",
    "Width": "10",
    "Height": "30",
    "Timeline": {
      "Start": "0",
      "Duration": "ToEND"
    },
    "Name": "example-watermark-****",
    "Dy": "5",
    "Id": "3780bd69b2b74540bc7b1096f564****"
  },
  "RequestId": "54BB917F-DD35-4F32-BABA-E60E31B21W63"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.