Todos os produtos
Search
Central de documentação

Intelligent Media Management:TargetVideo

Última atualização: Jul 16, 2026

Parâmetro

Tipo

Descrição

Exemplo

object

As configurações de parâmetros de processamento de vídeo.

DisableVideo

boolean

Especifica se a geração de fluxo de vídeo deve ser desativada. Valores válidos:

  • true: Desativado. O arquivo de saída não contém um fluxo de vídeo.

  • false (padrão): Não desativado.

false

Stream

array

A lista de números de índice de fluxo de vídeo a serem processados do arquivo de origem. Um valor vazio (padrão) indica que o fluxo de vídeo com o menor número de índice (o primeiro fluxo de vídeo) é processado. Um número de índice maior que 100 indica que todos os fluxos de vídeo são processados.

  • Exemplo: [0,1] processa fluxos de vídeo com números de índice 0 e 1. [1] processa o fluxo de vídeo com número de índice 1. [101] processa todos os fluxos de vídeo.

Nota

Apenas fluxos de vídeo com números de índice existentes são processados. Se um fluxo de vídeo correspondente a um número de índice não existir, esse número de índice será ignorado.

integer

O número de índice do fluxo de vídeo a ser processado.

0

TranscodeVideo

object

Os parâmetros de transcodificação de vídeo. Um valor vazio indica que o processamento de vídeo está desativado e o arquivo de saída não contém um fluxo de vídeo.

Nota

Não é recomendável definir este parâmetro como um valor vazio para desativar o processamento de vídeo.

Codec

string

O formato de codificação de vídeo. Valores válidos:

  • Para a API CreateMediaConvert: copy (padrão), h264, h265, vp9.
    Aviso Quando este parâmetro é definido como copy, os fluxos de vídeo a serem processados são copiados diretamente para o arquivo de saída, e outros parâmetros em TranscodeVideo não entram em vigor. copy não pode ser usado para concatenação de vídeo e é normalmente usado para cenários de conversão de formato de contêiner.
  • Para a API GenerateVideoPlaylist: h264 (padrão), h265.

h264

PixelFormat

string

O formato de pixel. O valor padrão é o mesmo do vídeo de origem. Valores válidos:

  • yuv420p

  • yuv422p

  • yuv444p

  • yuv420p10le

  • yuv422p10le

  • yuv444p10le

  • yuva420p

Nota

yuva420p está disponível apenas para a API CreateMediaConvert, e o parâmetro Codec deve ser definido como vp9.

yuv420p

FrameRateOption

string

A opção de taxa de quadros. Valores válidos:

  • fixed: Sempre usa a taxa de quadros de vídeo alvo especificada.

  • adaptive: Usa a taxa de quadros do vídeo de origem quando ela é inferior à taxa de quadros de vídeo alvo especificada.

  • fall: Retorna uma falha quando a taxa de quadros do vídeo de origem é inferior à taxa de quadros de vídeo alvo especificada.

Valor padrão:

  • Para a API CreateMediaConvert, o valor padrão é fixed.

  • Para a API GenerateVideoPlaylist, o valor padrão é adaptive.

Nota

Este parâmetro deve ser definido juntamente com o parâmetro FrameRate.

fixed

FrameRate

number

A taxa de quadros do vídeo. O valor padrão é o mesmo do vídeo de origem.

25

ResolutionOption

string

A opção de resolução. Valores válidos:

  • fixed: Sempre usa a resolução de vídeo alvo especificada.

  • adaptive: Usa a resolução do vídeo de origem quando a área de resolução do vídeo de origem é menor que a área de resolução de vídeo alvo especificada.

  • fall: Retorna uma falha quando a área de resolução do vídeo de origem é menor que a área de resolução de vídeo alvo especificada.

Valor padrão:

  • Para a API CreateMediaConvert, o valor padrão é fixed.

  • Para a API GenerateVideoPlaylist, o valor padrão é adaptive.

Nota

Este parâmetro deve ser definido juntamente com o parâmetro Resolution.

fixed

Resolution

string

A resolução do vídeo de saída no formato LarguraxAltura. O valor padrão é o mesmo da resolução de reprodução do vídeo de origem. Você pode configurar tanto a largura quanto a altura, ou configurar apenas a largura ou a altura. Você também pode usar o parâmetro AdaptiveResolutionDirection para configurar os lados longo e curto, ou configurar apenas o lado longo ou o lado curto. O intervalo de valores para um único lado é (0,4096].

  • Exemplo 1: Se AdaptiveResolutionDirection for false, 1280x720 define a largura como 1280 e a altura como 720. 1280x define a largura como 1280 e mantém a altura igual à do vídeo de origem. x720 define a altura como 720 e mantém a largura igual à do vídeo de origem.

  • Exemplo 2: Se AdaptiveResolutionDirection for true, 1280x720 define o lado longo como 1280 e o lado curto como 720. 1280x define o lado longo como 1280 e mantém o lado curto igual ao do vídeo de origem. x720 define o lado curto como 720 e mantém o lado longo igual ao do vídeo de origem.

Nota

Se o vídeo de origem contiver informações de rotação, a determinação de largura/altura e lado longo/curto baseia-se no estado pós-rotação, que é a resolução de reprodução.

640x480

AdaptiveResolutionDirection

boolean

Especifica se o modo adaptativo de lado longo/curto deve ser ativado. Valores válidos:

  • true: Ativado. O formato do parâmetro Resolution é LadoLongo×LadoCurto.

  • false (padrão): Desativado. O formato do parâmetro Resolution é Largura×Altura.

true

ScaleType

string

O modo de dimensionamento. Valores válidos:

  • stretch (padrão): Fixa a largura/altura ou os lados longos/curtos e dimensiona forçosamente o vídeo para preencher a área em branco por estiramento.

  • crop: Dimensiona proporcionalmente até a resolução mínima que se estende além da largura/altura ou do retângulo de lado longo/curto especificado e, em seguida, recorta centralmente a área excedente.

  • fill: Dimensiona proporcionalmente até a resolução máxima dentro da largura/altura ou do retângulo de lado longo/curto especificado e, em seguida, preenche centralmente a área em branco com preto.

  • fit: Dimensiona proporcionalmente até a resolução máxima dentro da largura/altura ou do retângulo de lado longo/curto especificado.

Nota

Este parâmetro deve ser definido juntamente com o parâmetro Resolution.

crop

Rotation

integer

O ângulo de rotação horária do vídeo em graus. Valores válidos:

  • 0 (padrão)

  • 90

  • 180

  • 270

90

BitrateOption

string

A opção de taxa de bits de vídeo. Valores válidos:

  • fixed: Sempre usa a taxa de bits de vídeo alvo especificada.

  • adaptive: Usa a taxa de bits do vídeo de origem quando ela é inferior à taxa de bits de vídeo alvo especificada.

  • fall: Retorna uma falha quando a taxa de bits do vídeo de origem é inferior à taxa de bits de vídeo alvo especificada.

Valor padrão:

  • Para a API CreateMediaConvert, o valor padrão é fixed.

  • Para a API GenerateVideoPlaylist, o valor padrão é adaptive.

Nota

Este parâmetro deve ser definido juntamente com o parâmetro Bitrate.

fixed

Bitrate

integer

A taxa de bits do fluxo de vídeo, em bits por segundo (bit/s).

Nota

Este parâmetro é mutuamente exclusivo com CRF. Se tanto este parâmetro quanto CRF estiverem vazios, a codificação será realizada com um valor CRF de 23.

128000

GOPSize

integer

O número de quadros entre quadros-chave. Valor padrão: 150.

Nota

Este parâmetro não é suportado pela API GenerateVideoPlaylist.

60

CRF

number

Especifica o modo de qualidade constante. Este parâmetro é mutuamente exclusivo com Bitrate. Valores válidos: [0,51]. Um valor mais alto resulta em menor qualidade. Valores recomendados: [18,38].

18

BufferSize

integer

O tamanho do buffer de decodificação para taxa de bits variável, em bits por segundo (bps).

Nota

Este parâmetro entra em vigor apenas quando usado juntamente com o parâmetro CRF.

4000000

MaxBitrate

integer

O limite máximo de taxa de bits para taxa de bits variável. Ao usar este parâmetro, você deve especificar o parâmetro BufferSize.

Nota

Este parâmetro entra em vigor apenas quando usado juntamente com o parâmetro CRF.

128000

BFrames

integer

O número de B-frames consecutivos. Valor padrão: 3.

3

Refs

integer

O número de quadros de referência. Valor padrão: 2.

2

VideoSlim

integer

Ativa o modo Narrowband HD. Valores válidos:

0: Valor padrão. Desativado.

1: Usa o modo Narrowband HD para transcodificação.

Nota

Para obter resultados ideais, use os parâmetros Bitrate ou CRF oficialmente recomendados para transcodificação de vídeo com Narrowband HD.

Importante O Narrowband HD suporta apenas formatos H.264/H.265, apenas yuv420p, profundidade de 8 bits, e não suporta saída de transcodificação de vídeo multi-alvo ou concatenação de vídeo. Para mais informações, consulte Visão geral do Narrowband HD.

0

FilterVideo

object

Os parâmetros de filtro de vídeo. Este parâmetro não entra em vigor quando TranscodeVideo está vazio ou TranscodeVideo.Codec está definido como copy.

Nota

Este parâmetro não é suportado pela API GenerateVideoPlaylist.

Watermarks

array

A lista de marcas d'água de vídeo.

object

As informações da marca d'água de vídeo.

Type

string

O tipo de marca d'água. Valores válidos:

  • text (padrão): Uma marca d'água de texto.

  • file: Uma marca d'água de imagem ou imagem animada.

text

Dx

number

O significado deste parâmetro varia dependendo se o valor é um número inteiro ou decimal:

  • 0 (padrão): O deslocamento de pixel é 0. A proporção do deslocamento horizontal em relação à largura do vídeo de saída também é 0.

  • Inteiro: O deslocamento em pixels (px). O valor varia de 1 a 4096.

  • Decimal: A proporção do deslocamento horizontal em relação à largura do vídeo de saída. O valor varia de (0, 1).

0

Dy

number

O significado deste parâmetro varia dependendo se o valor é um número inteiro ou decimal:

  • 0 (padrão): O deslocamento de pixel é 0. A proporção do deslocamento vertical em relação à altura do vídeo de saída também é 0.

  • Inteiro: O deslocamento em pixels (px). O valor varia de 1 a 4096.

  • Decimal: A proporção do deslocamento vertical em relação à altura do vídeo de saída. O valor varia de (0, 1).

0

StartTime

number

O horário de início para adicionar a marca d'água, em segundos (s). Por padrão, a marca d'água é adicionada desde o início do vídeo.

0

Duration

number

A duração durante a qual a marca d'água é exibida, em segundos (s). Por padrão, a marca d'água é exibida até o final do vídeo.

0

ReferPos

string

A posição de referência para adicionar a marca d'água. Valores válidos:

  • topleft (padrão): O canto superior esquerdo.

  • topright: O canto superior direito.

  • bottomright: O canto inferior direito.

  • bottomleft: O canto inferior esquerdo.

topleft

Content

string

O conteúdo da marca d'água de texto. O valor padrão é vazio.

Importante

Este parâmetro é eficaz apenas quando o parâmetro Type está definido como text.

example

FontName

string

O nome da fonte para a marca d'água de texto. Valores válidos:

  • SourceHanSans-Regular (padrão)

  • SourceHanSans-Bold

  • SourceHanSerif-Regular

  • SourceHanSerif-Bold

Importante

Este parâmetro é eficaz apenas quando o parâmetro Type está definido como text.

SourceHanSans-Bold

FontSize

integer

O tamanho da fonte para a marca d'água de texto. O valor padrão é 16. O valor deve ser um número inteiro no intervalo (4, 120).

Importante

Este parâmetro é eficaz apenas quando o parâmetro Type está definido como text.

18

FontColor

string

A cor da fonte do texto da marca d'água. O formato é #RRGGBB. O valor padrão é #000000. Você também pode inserir valores como "red" ou "green".

Importante

Este parâmetro é eficaz apenas quando o parâmetro Type está definido como text.

red

FontApha

number

A opacidade da fonte da marca d'água de texto. O valor varia de (0, 1]. O valor padrão é 1, o que significa totalmente opaco.

Importante

Este parâmetro é eficaz apenas quando o parâmetro Type está definido como text.

0.8

BorderWidth

integer

A largura do contorno para a marca d'água de texto, em pixels (px). O valor deve ser um número inteiro de 0 a 4096. O valor padrão é 0.

Importante

Este parâmetro é eficaz apenas quando o parâmetro Type está definido como text.

2

BorderColor

string

A cor do contorno do texto da marca d'água. O formato é #RRGGBB. O valor padrão é #000000. Você também pode inserir valores como "red" ou "green".

Importante

Este parâmetro é eficaz apenas quando o parâmetro Type está definido como text.

red

URI

string

A URL do OSS do arquivo de marca d'água. Os formatos suportados são PNG e MOV.

A URL do OSS deve seguir o formato oss://<bucket>/<object>, onde <bucket> é o nome de um bucket do OSS na mesma região do projeto atual, e <object> é o caminho completo do arquivo, incluindo a extensão do nome do arquivo.

Importante

Este parâmetro é eficaz apenas quando o parâmetro Type está definido como file.

oss://test-bucket/watermark.jpg

Width

number

A largura da imagem da marca d'água. Por padrão, é a largura da imagem original da marca d'água. O significado deste parâmetro varia dependendo se o valor é um número inteiro ou decimal:

  • Inteiro: A largura da marca d'água em pixels (px). O valor varia de 1 a 4096.

  • Decimal: A proporção da largura da marca d'água em relação à largura do vídeo de saída. O valor varia de (0, 1).

80

Height

number

A altura da imagem da marca d'água. Por padrão, é a altura da imagem original da marca d'água. O significado deste parâmetro varia dependendo se o valor é um número inteiro ou decimal:

  • Inteiro: A altura da marca d'água em pixels (px). O valor varia de 1 a 4096.

  • Decimal: A proporção da altura da marca d'água em relação à altura do vídeo de saída. O valor varia de (0, 1).

40

Delogos

array

Aplica processamento de mosaico a uma área retangular do vídeo para remover logotipos ou marcas d'água de emissoras.

object

Os parâmetros de processamento de mosaico de vídeo.

StartTime

number

O horário de início para adicionar o mosaico, em segundos (s). Por padrão, o mosaico é adicionado desde o início do vídeo.

0

Duration

number

A duração durante a qual o mosaico é exibido, em segundos (s). Por padrão, o mosaico é exibido até o final do vídeo.

15

Dx

number

O significado deste parâmetro varia dependendo se o valor é um número inteiro ou decimal:

  • 0 (padrão): O deslocamento de pixel é 0. A proporção do deslocamento horizontal em relação à largura do vídeo de saída também é 0.

  • Inteiro: O deslocamento em pixels (px). O valor varia de 1 a 4096.

  • Decimal: A proporção do deslocamento horizontal em relação à largura do vídeo de saída. O valor varia de (0, 1).

0

Dy

number

O valor padrão é 0. O significado deste parâmetro varia dependendo se o valor é um número inteiro ou decimal:

  • 0 (padrão): O deslocamento de pixel é 0. A proporção do deslocamento vertical em relação à altura do vídeo de saída também é 0.

  • Inteiro: O deslocamento em pixels (px). O valor varia de 1 a 4096.

  • Decimal: A proporção do deslocamento vertical em relação à altura do vídeo de saída. O valor varia de (0, 1).

0

Width

number

A largura do mosaico. O valor padrão é o decimal 1.0, o que significa que preenche toda a largura do vídeo de saída. O significado deste parâmetro varia dependendo se o valor é um número inteiro ou decimal:

  • Inteiro: A largura em pixels (px). O valor varia de 1 a 4096.

  • Decimal: A proporção da largura do mosaico em relação à largura do vídeo de saída. O valor varia de (0, 1).

100

Height

number

A altura do mosaico. O valor padrão é o decimal 1.0, o que significa que preenche toda a altura do vídeo de saída. O significado deste parâmetro varia dependendo se o valor é um número inteiro ou decimal:

  • Inteiro: A altura em pixels (px). O valor varia de 1 a 4096.

  • Decimal: A proporção da altura do mosaico em relação à altura do vídeo de saída. O valor varia de (0, 1).

40

ReferPos

string

A posição de referência para adicionar o mosaico. Valores válidos:

  • topleft (padrão): O canto superior esquerdo.

  • topright: O canto superior direito.

  • bottomright: O canto inferior direito.

  • bottomleft: O canto inferior esquerdo.

topleft

Speed

number

A configuração de velocidade de reprodução de vídeo. Valores válidos: [0.5,1.0]. Valor padrão: 1.0.

Nota
  • Esta é a proporção da velocidade de reprodução do arquivo de mídia transcodificado em relação à velocidade de reprodução padrão do arquivo de mídia de origem, não sendo uma transcodificação acelerada.

Importante
  • Este parâmetro é aplicável apenas à API CreateMediaConvertTask.

1.0

Desensitization

object

A configuração de dessensibilização de vídeo.

Importante
  • Este parâmetro é aplicável apenas à API CreateMediaConvertTask.

Face

object

A configuração de dessensibilização facial.

Nota

Este recurso está em pré-visualização pública. Se você tiver alguma dúvida, entre no grupo do DingTalk para dar feedback. Para o número do grupo do DingTalk, consulte Fale conosco.

Confidence

number

O limite de confiança para reconhecimento facial. Isso define o limite inferior para o nível de confiança. Se o nível de confiança de um rosto detectado estiver abaixo deste limite, o rosto não será dessensibilizado.

  • Intervalo de valores: 0.0 a 1.0.

  • Valor padrão: 0.0 (sem filtragem de confiança).

0.4

MinSize

integer

O limite mínimo de tamanho de rosto. Isso define o tamanho mínimo para um rosto ser dessensibilizado. Se a largura ou altura de um rosto detectado for menor que este limite, o rosto não será dessensibilizado. A unidade é pixels. O valor padrão é 0, o que significa que não há restrição de tamanho de rosto.

0.4

ScaleRatio

number

BlurRadius

integer

Transparency

number

LicensePlate

object

A configuração de dessensibilização de placa de veículo.

Nota

Este recurso está em pré-visualização pública. Se você tiver alguma dúvida, entre no grupo do DingTalk para dar feedback. Para o número do grupo do DingTalk, consulte Fale conosco.

Confidence

number

O limite de confiança para reconhecimento de placa de veículo. Isso define o limite inferior para o nível de confiança. Se o nível de confiança de uma placa de veículo detectada estiver abaixo deste limite, a placa não será dessensibilizada.

  • Intervalo de valores: 0.0 a 1.0.

  • Valor padrão: 0.0 (sem filtragem de confiança).

0.4

MinSize

integer

O limite mínimo de tamanho de placa de veículo. Isso define o tamanho mínimo para uma placa de veículo ser dessensibilizada. Se a largura ou altura de uma placa de veículo detectada for menor que este limite, a placa não será dessensibilizada. A unidade é pixels. O valor padrão é 0, o que significa que não há restrição de tamanho de placa de veículo.

0.4

ScaleRatio

number

BlurRadius

integer

Transparency

number