Todos os produtos
Search
Central de documentação

ApsaraVideo Media Processing:Captura de snapshots

Última atualização: Jun 27, 2026

Use o MPS SDK for Python V2.0 para enviar um job de snapshot e capturar quadros de vídeo em momentos específicos. Snapshots são amplamente utilizados para miniaturas de vídeo, sprites de imagem e pré-visualizações na barra de progresso.

Código de exemplo

O exemplo a seguir usa SubmitSnapshotJobRequest para capturar 10 snapshots a partir da marca de 5 segundos, com intervalos de 20 segundos, e salva a saída em um bucket do OSS.

import os
import sys

from typing import List

from alibabacloud_mts20140618.client import Client as Mts20140618Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_mts20140618 import models as mts_20140618_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient

class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client() -> Mts20140618Client:
        """
        Use your AccessKey ID and AccessKey secret to initialize a client.
        @return: Client
        @throws Exception
        """
        config = open_api_models.Config(
            # Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured. ,
            access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            # Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured. ,
            access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
        )
        config.endpoint = f'mts.cn-hangzhou.aliyuncs.com'
        return Mts20140618Client(config)

    @staticmethod
    def main(
        args: List[str],
    ) -> None:
        client = Sample.create_client()
        submit_snapshot_job_request = mts_20140618_models.SubmitSnapshotJobRequest(
            # The job input.
            input='{"Bucket":"example-bucket","Location":"example-location","Object":"example%2Ftest.flv"}',
            # The snapshot configuration.
            snapshot_config='{"OutputFile":{"Bucket":"example-001","Location":"example-location","Object":"{Count}.jpg"},"Time":"5","Num":"10","Interval":"20"}',
            # The user-defined data.
            user_data='testid-001',
            # The ID of the MPS queue.
            pipeline_id='dd3dae411e704030b921e52698e5****'
        )
        runtime = util_models.RuntimeOptions()
        try:
            # Write your own code to display the response of the API operation if necessary.
            client.submit_snapshot_job_with_options(submit_snapshot_job_request, runtime)
        except Exception as error:
            # Handle exceptions with caution in actual business scenarios and never ignore exceptions in your project. In this example, error messages are displayed for reference only. 
            # The error message.
            print(error.message)
            # The URL of the corresponding error diagnostics page.
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)

    @staticmethod
    async def main_async(
        args: List[str],
    ) -> None:
        client = Sample.create_client()
        submit_snapshot_job_request = mts_20140618_models.SubmitSnapshotJobRequest(
            # The job input.
            input='{"Bucket":"example-bucket","Location":"example-location","Object":"example%2Ftest.flv"}',
            # The snapshot configuration.
            snapshot_config='{"OutputFile":{"Bucket":"example-001","Location":"example-location","Object":"{Count}.jpg"},"Time":"5","Num":"10","Interval":"20"}',
            # The user-defined data.
            user_data='testid-001',
            # The ID of the MPS queue.
            pipeline_id='dd3dae411e704030b921e52698e5****'
        )
        runtime = util_models.RuntimeOptions()
        try:
            # Write your own code to display the response of the API operation if necessary.
            await client.submit_snapshot_job_with_options_async(submit_snapshot_job_request, runtime)
        except Exception as error:
            # Handle exceptions with caution in actual business scenarios and never ignore exceptions in your project. In this example, error messages are displayed for reference only. 
            # The error message.
            print(error.message)
            # The URL of the corresponding error diagnostics page.
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)

if __name__ == '__main__':
    Sample.main(sys.argv[1:])

Referências