Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:Filigranes vidéo

Dernière mise à jour :Sep 22, 2026

Cette rubrique fournit des exemples d'utilisation des opérations API du module de filigranes vidéo. Ces opérations API sont encapsulées dans le SDK ApsaraVideo VOD pour Python. Vous pouvez appeler ces opérations pour ajouter, modifier, supprimer et interroger des filigranes. Vous pouvez également définir un filigrane par défaut.

Notes d'utilisation

  • Tous les exemples de cette rubrique utilisent une paire AccessKey pour initialiser une instance de client.

  • Pour plus de détails sur les paramètres de requête et de réponse, consultez l' et ouvrez l'onglet API Documentations.

  • Pour des exemples de SDK concernant d'autres opérations API, rendez-vous sur l'. Dans l'onglet Parameters, spécifiez les paramètres et lancez l'appel. Sélectionnez ensuite la version du SDK et le langage dans l'onglet SDK Sample Code pour afficher et télécharger le code.

  • Les exemples de cette rubrique utilisent le SDK V1.0. Pour les exemples V2.0, sélectionnez la version correcte du SDK dans l'OpenAPI Explorer.

Initialiser un client

Avant d'utiliser le SDK, initialisez un client. Pour plus d'informations, consultez la section Initialisation.

Ajouter un filigrane

Vous pouvez appeler l'opération AddWatermark pour ajouter un filigrane.

Portail OpenAPI : ou AddWatermark.

Exemple de code :

Remarque
  • Pour plus d'informations sur l'URL de téléchargement de fichier et les informations d'identification, consultez la section CreateUploadAttachedMedia.

  • Pour savoir comment télécharger un fichier de filigrane vers un compartiment Object Storage Service (OSS), consultez la section Télécharger des objets OSS.

from aliyunsdkvod.request.v20170321 import AddWatermarkRequest
def add_watermark(clt):
    request = AddWatermarkRequest.AddWatermarkRequest()

    request.set_Name('watermark-sample')
    # If you want to use an image watermark, the image must be stored in an OSS bucket and the image file and source video file must be stored in the same region, such as China (Shanghai).
    # Example of FileUrl: http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/watermark/test-****.png.  
    request.set_FileUrl('<your File URL>')

    # Example on how to configure a text watermark:
    request.set_Type('Text')
    # Specify the text content, font, size, color, transparency, and other configurations.
    watermarkConfig = {'Content': 'watermark Text', 'FontName': 'SimSun', 'FontSize': 25, 'FontColor': 'Black',
                       'FontAlpha': 0.2, 'BorderColor': 'White', 'BorderWidth': 1, 'Top': 20, 'Left': 15}
    request.set_WatermarkConfig(json.dumps(watermarkConfig))

    """
    # Example on how to configure an image watermark:
    request.set_Type('Image')
    # The start time and duration of the watermark.
    timeline = {'Start': 2, 'Duration': 'ToEND'}
    # The position configurations of the watermark.
    watermarkConfig = {'Dx': 8, 'Dy': 8, 'Width': 55, 'Height': 55, 'ReferPos': 'BottomRight', 'Timeline': timeline}
    request.set_WatermarkConfig(json.dumps(watermarkConfig))
    """

    request.set_accept_format('JSON')
    response = json.loads(clt.do_action_with_exception(request))
    return response

try:
    clt = init_vod_client()
    watermark = add_watermark(clt)
    print(json.dumps(watermark, ensure_ascii=False, indent=4))

except Exception as e:
    print(e)
    print(traceback.format_exc())

Modifier un filigrane

Vous pouvez appeler l'opération UpdateWatermark pour modifier un filigrane.

Portail OpenAPI : | UpdateWatermark.

Exemple de code :

Important

Vous ne pouvez pas utiliser cette opération pour modifier l'URL du filigrane image. Si vous souhaitez modifier l'URL du filigrane image, créez un nouveau filigrane.

from aliyunsdkvod.request.v20170321 import UpdateWatermarkRequest
def update_watermark(clt):
    request = UpdateWatermarkRequest.UpdateWatermarkRequest()
    request.set_WatermarkId('<watermarkId>')
    request.set_Name('new-watermark-name')

    # Example on how to modify a text watermark:
    # Specify the text content, font, size, color, transparency, and other configurations.
    watermarkConfig = {'Content': 'watermark Text', 'FontName': 'SimSun', 'FontSize': 25, 'FontColor': 'Black',
                       'FontAlpha': 0.2, 'BorderColor': 'White', 'BorderWidth': 1, 'Top': 20, 'Left': 15}
    request.set_WatermarkConfig(json.dumps(watermarkConfig))

    """
    # Example on how to modify an image watermark:
    # The start time and duration of the watermark.
    timeline = {'Start': 2, 'Duration': 'ToEND'}
    # The position configurations of the watermark.
    watermarkConfig = {'Dx': 8, 'Dy': 8, 'Width': 55, 'Height': 55, 'ReferPos': 'BottomRight', 'Timeline': timeline}
    request.set_WatermarkConfig(json.dumps(watermarkConfig))
    """

    request.set_accept_format('JSON')
    response = json.loads(clt.do_action_with_exception(request))
    return response

try:
    clt = init_vod_client()
    watermark = update_watermark(clt)
    print(json.dumps(watermark, ensure_ascii=False, indent=4))

except Exception as e:
    print(e)
    print(traceback.format_exc())

Supprimer un filigrane

Vous pouvez appeler l'opération DeleteWatermark pour supprimer un filigrane.

Portail OpenAPI : / DeleteWatermark.

Interroger des filigranes

  • Vous pouvez appeler l'opération GetWatermark pour interroger les détails d'un seul filigrane.

    Portail OpenAPI : GetWatermark.

  • Vous pouvez appeler l'opération ListWatermark pour interroger plusieurs filigranes.

    Portail OpenAPI : ListWatermark.

Définir un filigrane par défaut

Vous pouvez appeler l'opération SetDefaultWatermark pour définir un filigrane par défaut.

Portail OpenAPI : SetDefaultWatermark.