Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Inicialização

Última atualização: Jun 27, 2026

Este tópico descreve como inicializar o ApsaraVideo VOD SDK for Python usando um par de AccessKey ou um token do Security Token Service (STS). Escolha o método mais adequado às necessidades do seu negócio.

Informações básicas

Os SDKs do ApsaraVideo VOD podem ser inicializados de duas formas distintas. É possível usar o par de AccessKey de uma conta Alibaba Cloud ou de um usuário RAM com as permissões necessárias, concedidas por políticas de autorização. O par de AccessKey permanece válido após a criação da conta Alibaba Cloud ou do usuário RAM. Recomendamos esse método para uso no servidor. Como alternativa, utilize um token STS com as permissões adequadas, definidas também por políticas de autorização. Nesse caso, você define o período de validade do token STS.

Pré-requisitos

  • O ApsaraVideo VOD SDK for Python deve estar instalado. Para mais detalhes, consulte Instalação.

  • Um usuário RAM precisa estar criado e com as permissões necessárias concedidas. Para mais informações, veja Criar um usuário RAM e conceder permissões.

  • Configure as variáveis de ambiente ALIBABA_CLOUD_ACCESS_KEY_ID e ALIBABA_CLOUD_ACCESS_KEY_SECRET. Para orientações detalhadas, acesse Configurar variáveis de ambiente no Linux, macOS e Windows.

    Importante
    • O par de AccessKey de uma conta Alibaba Cloud tem permissão em todas as operações de API. Utilize o par de AccessKey de um usuário RAM para chamar operações de API ou executar tarefas rotineiras de operação e manutenção.

    • Evite codificar diretamente seu AccessKey ID e AccessKey secret no código do projeto. Em caso de vazamento, todos os recursos da sua conta ficarão comprometidos.

  • Uma região deve estar especificada para o uso do ApsaraVideo VOD. Por exemplo, ao utilizar o serviço na região China (Shanghai), o ID da região é cn-shanghai. Consulte Centros e endpoints do VOD para mais informações.

Inicializar o SDK com um par de AccessKey

Obtenha um par de AccessKey para concluir a verificação de identidade e chamar as operações de API do ApsaraVideo VOD. Para saber como obter esse par, consulte Criar um par de AccessKey.

Use o par de AccessKey para inicializar o SDK. Código de exemplo:

# -*- coding: UTF-8 -*-
import json
import traceback
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.auth.credentials import AccessKeyCredential

# Obtain the AccessKey information.
def init_vod_client():
    regionId = 'cn-shanghai'   # The region in which ApsaraVideo VOD is activated.
    connectTimeout = 3         # The timeout period. Unit: seconds.
    // The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. We recommend that you use a RAM user to call API operations or perform routine O&M. 
    // We recommend that you do not save your AccessKey pair (AccessKey ID and AccessKey secret) in your project code. Otherwise, the AccessKey pair may be leaked. As a result, the security of all resources within your account is compromised. 
    // In this example, ApsaraVideo VOD reads the AccessKey pair from the environment variables to implement identity verification for API access. Before you run the sample code, configure the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET. 
    credentials = AccessKeyCredential(os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'], os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET'])
    return AcsClient(region_id=regionId, credential=credentials)

Inicializar o SDK com um token STS

Um token STS é necessário para inicializar o SDK. Para obter instruções sobre como conseguir esse token, consulte a seção "Usar STS para autorizar acesso" no tópico Criar uma função e conceder permissões de acesso temporário à função usando STS.

Utilize um token STS para inicializar o SDK. Código de exemplo:

# -*- coding: UTF-8 -*-
import json
import traceback
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.auth.credentials import StsTokenCredential

# Obtain the STS information.
def init_vod_client(accessKeyId, accessKeySecret, securityToken):
    regionId = 'cn-shanghai'   # The region in which ApsaraVideo VOD is activated.
    connectTimeout = 3         # The timeout period. Unit: seconds.
    credential = StsTokenCredential(os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'], os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET'], os.environ['ALIBABA_CLOUD_SECURITY_TOKEN'])
    return AcsClient(region_id=regionId, auto_retry=True, max_retry_time=3, timeout=connectTimeout, credential=credential)

Instruções

  1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

  2. Escreva o português brasileiro DO ZERO — esqueça a estrutura das frases em inglês

  3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

  4. Tags xref (<a data-tag="xref" ...>texto</a>) — preserve a TAG INTEIRA com todos os atributos na ordem e caixa originais, traduza APENAS o texto visível entre > e

  5. Aplique todas as regras específicas do idioma rigorosamente

  6. Aplique as regras de stopwords com tolerância zero

  7. Use o modo imperativo em passos numerados e listas de procedimentos

  8. Garanta consistência terminológica — mesmo termo = mesma tradução em todo o documento

  9. Varie os inícios de frase em listas/tabelas — nenhum início repetido 3+ vezes

  10. Retorne APENAS o documento markdown em português brasileiro, sem explicações