Todos os produtos
Search
Central de documentação

ApsaraVideo Live:UpdateCustomLiveStreamTranscode

Última atualização: Jun 28, 2026

Atualiza uma configuração de transcodificação personalizada.

Descrição da operação

Esta operação suporta os seguintes tipos de modelos de transcodificação personalizados:

  • h264: transcodificação padrão H.264.

  • h264-nbhd: transcodificação H.264 Narrowband HD™.

  • h265: transcodificação padrão H.265.

  • h265-nbhd: transcodificação H.265 Narrowband HD™.

  • audio: transcodificação apenas de áudio.

Limite de QPS

Você pode chamar esta operação até 6.000 vezes por segundo por conta.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

live:UpdateCustomLiveStreamTranscode

update

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Não

O ID da região.

cn-shanghai

Domain

string

Sim

O domínio de streaming. Este parâmetro não pode ser modificado.

example.com

App

string

Sim

O AppName da transmissão ao vivo. Este parâmetro não pode ser modificado.

liveApp****

Template

string

Sim

O nome personalizado do modelo de transcodificação. Este parâmetro não pode ser modificado.

LiveCusTranscode****

TemplateType

string

Sim

O tipo do modelo de transcodificação personalizado. Este parâmetro não pode ser modificado.

h264

Height

integer

Não

Altura do vídeo de saída em pixels. Requisitos:

  • Height ≥ 100

  • max(Height, Width) ≤ 2560

  • min(Height, Width) ≤ 1440

Nota

Para modelos h265-nbhd, não pode exceder 720.

720

Width

integer

Não

Largura do vídeo de saída em pixels.

Requisitos:

  • Width ≥ 100

  • max(Height, Width) ≤ 2560

  • min(Height, Width) ≤ 1440

Nota

Para modelos h265-nbhd, não pode exceder 1280.

576

FPS

integer

Não

A taxa de quadros do vídeo de saída. Unidade: quadros por segundo (FPS). Valores válidos: 1 a 60.

30

VideoBitrate

integer

Não

A taxa de bits do vídeo de saída. Unidade: kbps. Valores válidos: 1 a 6000.

Nota

O sistema tenta transcodificar o vídeo na taxa de bits especificada. No entanto, a taxa de bits real pode não ser igual ao valor especificado, especialmente quando o valor especificado é muito alto ou muito baixo.

720

AudioBitrate

integer

Não

A taxa de bits do áudio de saída. Unidade: kbps. Valores válidos: 1 a 1000.

512

Gop

string

Não

O tamanho do Group of Pictures (GOP). A unidade pode ser quadro ou segundo. Valores válidos:

  • Por quadros: 1 a 3000.

  • Por segundos: 1s a 20s.

1

Profile

integer

Não

O perfil de codec de vídeo. Um valor maior indica melhor qualidade de vídeo e maior consumo de recursos para codificação e decodificação. Valores válidos:

  • 1: baseline (para dispositivos móveis).

  • 2: main (para dispositivos SD).

  • 3: high (para dispositivos HD).

2

AudioProfile

string

Não

O perfil de áudio. Valores válidos:

  • aac_low

  • aac_he

  • aac_he_v2

  • aac_ld

aac_low

AudioCodec

string

Não

O codec de áudio. Valores válidos:

  • aac

  • mp3

aac

AudioRate

integer

Não

A taxa de amostragem de áudio. Valores válidos: 22050, 32000, 44100, 48000 e 96000. Unidade: Hz.

Nota

Se você definir AudioProfile como aac_ld, a taxa de amostragem não poderá exceder 44100.

96000

AudioChannelNum

integer

Não

O número de canais de áudio. Valores válidos:

  • 1: mono.

  • 2: estéreo.

2

Lazy

string

Não

Especifica se a transcodificação sob demanda deve ser ativada. Valores válidos:

  • yes: A transcodificação só começa quando o primeiro visualizador solicita este fluxo transcodificado.

  • no: A transcodificação começa imediatamente após a publicação do fluxo.

yes

EncryptParameters

string

Não

As configurações de criptografia, formatadas como uma string JSON.

  • EncryptType: O tipo de criptografia. Defina o valor como aliyun.

  • KmsKeyID: O ID da chave mestra do cliente (CMK) no Key Management Service (KMS).

  • KmsKeyExpireInterval: O período de rotação da chave. Unidade: segundos. Valores válidos: 60 a 3600.

Nota

Ao usar a criptografia Digital Rights Management (DRM), você não pode modificar o KmsKeyID.

{"EncryptType": "aliyun", "KmsKeyID":"afce5722-81d2-43c3-9930-7601da11****","KmsKeyExpireInterval":"3600"}

ResWithSource

string

Não

As configurações de resolução adaptativa. Se especificadas, substituem os parâmetros Height e Width. Campos:

  • Type (string): Obrigatório. Valores válidos:

    • short: define a borda mais curta do vídeo para o valor especificado e dimensiona a outra borda para manter a proporção original.

    • long: define a borda mais longa do vídeo para o valor especificado e dimensiona a outra borda para manter a proporção original.

    • screen: Corresponde a saída a uma resolução padrão, invertendo automaticamente as dimensões com base na orientação da fonte.

  • Value (string): Obrigatório. Valores válidos:

    • Para short: 360, 480, 540, 720 e 1080.

    • Para long: 640, 848, 960, 1280 e 1920.

    • Para screen: 640×360, 848×480, 960×540, 1280×720 e 1920×1080.

{"Type":"short","Value":"1080"}

FpsWithSource

string

Não

Adapta a taxa de quadros de saída com base na taxa de quadros da fonte, mantendo-a dentro de um intervalo especificado. Se especificado, substitui o parâmetro FPS. Campos:

  • UpLimit (integer): Obrigatório. O limite superior da taxa de quadros. Deve ser um número inteiro de 1 a 60 e maior que o limite inferior.

  • LowerLimit (integer): Obrigatório. O limite inferior da taxa de quadros. Deve ser um número inteiro de 1 a 60 e menor que o limite superior.

{"UpLimit":60,"LowerLimit":1}

BitrateWithSource

string

Não

As configurações de taxa de bits adaptativa. Se especificadas, substituem o parâmetro VideoBitrate. Campos:

  • UpLimit (integer): Obrigatório. O limite superior da taxa de bits. Deve ser um número inteiro de 128 a 10000 e maior que o limite inferior.

  • LowerLimit (integer): Obrigatório. O limite inferior da taxa de bits. Deve ser um número inteiro de 128 a 10000 e menor que o limite superior.

  • Factor (float): Obrigatório: O fator pelo qual a taxa de bits da fonte é multiplicada para calcular a taxa de bits de saída. Valores válidos: 0,1 a 1. O valor pode ter precisão de uma casa decimal. Um valor de 1 indica que a taxa de bits de saída é igual à taxa de bits da fonte.

{"UpLimit":2500,"LowerLimit":800,"Factor":1}

ExtWithSource

string

Não

Outras configurações adaptativas que alinham o fluxo transcodificado com o fluxo de origem. Campos:

  • KeyFrameOpen: Especifica se os quadros-chave devem ser alinhados com o fluxo de origem. Valores válidos: yes e no.

  • Copyts (string): Especifica se o carimbo de data/hora de apresentação (PTS) deve ser alinhado com o fluxo de origem. Valores válidos: yes e no.

  • SeiMode: O modo de passagem para Supplemental Enhancement Information (SEI). Valores válidos: 0 (desativado), 1 (passagem de parâmetros parciais) e 2 (passagem de todos).

{"KeyFrameOpen":"yes","Copyts":"yes","SeiMode":1}

DeInterlaced

boolean

Não

Especifica se o entrelaçamento deve ser detectado e removido automaticamente durante a transcodificação. O desentrelaçamento converte vídeo entrelaçado em vídeo progressivo.

  • true: ativa o desentrelaçamento.

  • false: mantém o formato de origem. Este é o valor padrão.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O ID da solicitação.

RequestId

string

O ID da solicitação.

16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameters %s Please check and try again later. Exception parameter exists, please check and try again.
400 ConfigAlreadyExists %s Please check and try again later. Configuration already exists, please check and try again.
400 TemplateLimit %s Please check and try again later. The number of templates reached the upper limit.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.