Todos os produtos
Search
Central de documentação

Intelligent Media Management:TargetVideo

Última atualização: Aug 28, 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 fluxos 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 os 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 têm efeito. 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 especificar tanto a largura quanto a altura, ou especificar apenas a largura ou a altura. Você também pode usar o parâmetro AdaptiveResolutionDirection para especificar tanto os lados longo e curto, ou apenas o lado longo ou 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 corresponde à 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 é lado longo × lado curto.

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

true

ScaleType

string

O modo de redimensionamento. Valores válidos:

  • stretch (padrão): Largura/altura ou lados longo/curto fixos. Força o redimensionamento e estica para preencher áreas em branco.

  • crop: Redimensionamento proporcional. Redimensiona para a resolução mínima que se estende além da largura/altura ou retângulo de lado longo/curto especificado e, em seguida, recorta o excesso centralmente.

  • fill: Redimensionamento proporcional. Redimensiona para a resolução máxima dentro da largura/altura ou retângulo de lado longo/curto especificado e, em seguida, preenche as áreas em branco com preto usando alinhamento central.

  • fit: Redimensionamento proporcional. Redimensiona para a resolução máxima dentro da largura/altura ou retângulo de lado longo/curto especificado.

Nota

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

crop

Rotation

integer

O grau de rotação horária do vídeo. 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 o parâmetro Bitrate. O intervalo de valores é [0,51]. Um valor maior resulta em menor qualidade de vídeo. O intervalo de valores recomendado é [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 tem efeito 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, o parâmetro BufferSize deve ser especificado.

Nota

Este parâmetro tem efeito 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 HD leve. Valores válidos:

0: Valor padrão. Desativado.

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

Nota

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

Importante O HD leve 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 Introdução ao produto HD leve.

0

FilterVideo

object

Os parâmetros de processamento de vídeo. Este parâmetro não entra em vigor quando o parâmetro TranscodeVideo está vazio ou quando 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): marca d'água de texto.

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

text

Dx

number

Os significados diferem dependendo se o valor é um número inteiro ou decimal:

  • 0 (padrão): Tanto o deslocamento em pixels quanto a proporção do deslocamento horizontal em relação à altura da resolução de saída são 0.

  • Inteiro: O deslocamento em pixels (px). Faixa de valores: [1,4096].

  • Decimal: A proporção do deslocamento horizontal em relação à altura da resolução de saída. Faixa de valores: (0,1).

0

Dy

number

Os significados diferem dependendo se o valor é um número inteiro ou decimal:

  • 0 (padrão): Tanto o deslocamento em pixels quanto a proporção do deslocamento vertical em relação à altura da resolução de saída são 0.

  • Inteiro: O deslocamento em pixels (px). Faixa de valores: [1,4096].

  • Decimal: A proporção do deslocamento vertical em relação à altura da resolução de saída. Faixa de valores: (0,1).

0

StartTime

number

O horário inicial para adicionar a marca d'água, em segundos (s). O valor padrão é o horário inicial do vídeo.

0

Duration

number

A duração durante a qual a marca d'água é exibida, em segundos (s). O valor padrão é 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): canto superior esquerdo

  • topright: canto superior direito

  • bottomright: canto inferior direito

  • bottomleft: canto inferior esquerdo

topleft

Content

string

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

Importante Este parâmetro entra em vigor quando o parâmetro Type está definido como text.

exemplo

FontName

string

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

  • SourceHanSans-Regular (padrão)

  • SourceHanSans-Bold

  • SourceHanSerif-Regular

  • SourceHanSerif-Bold

Importante Este parâmetro entra em vigor quando o parâmetro Type está definido como text.

SourceHanSans-Bold

FontSize

integer

O tamanho da fonte da marca d'água de texto. Valor padrão: 16. O valor deve ser um número inteiro. Faixa de valores: (4,120).

Importante Este parâmetro entra em vigor 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. Valor padrão: #000000. Valores como "red" e "green" também são suportados.

Importante Este parâmetro entra em vigor quando o parâmetro Type está definido como text.

red

FontApha

number

A transparência da fonte da marca d'água de texto. Faixa de valores: (0,1]. Valor padrão: 1, que indica totalmente opaco.

Importante Este parâmetro entra em vigor quando o parâmetro Type está definido como text.

0.8

BorderWidth

integer

A largura da borda da marca d'água de texto, em pixels (px). O valor deve ser um número inteiro. Faixa de valores: [0,4096]. Valor padrão: 0.

Importante Este parâmetro entra em vigor quando o parâmetro Type está definido como text.

2

BorderColor

string

A cor da borda do texto da marca d'água. O formato é #RRGGBB. Valor padrão: #000000. Valores como "red" e "green" também são suportados.

Importante Este parâmetro entra em vigor quando o parâmetro Type está definido como text.

red

URI

string

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

O formato do URI do OSS é 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 entra em vigor quando o parâmetro Type está definido como file.

oss://test-bucket/watermark.jpg

Width

number

A largura da imagem da marca d'água. O valor padrão é a largura original da imagem da marca d'água. Os significados diferem dependendo se o valor é um número inteiro ou decimal:

  • Inteiro: O valor em pixels da largura de remoção de logotipo, em pixels (px). Faixa de valores: [1,4096].

  • Decimal: A proporção relativa à largura da resolução do vídeo de saída. Faixa de valores: (0,1).

80

Height

number

A altura da imagem da marca d'água. O valor padrão é a altura original da imagem da marca d'água. Os significados diferem dependendo se o valor é um número inteiro ou decimal:

  • Inteiro: O valor em pixels da altura de remoção de logotipo, em pixels (px). Faixa de valores: [1,4096].

  • Decimal: A proporção relativa à altura da resolução do vídeo de saída. Faixa de valores: (0,1).

40

Delogos

array

Desfoca uma área retangular do vídeo para remover logotipos, marcas de emissora e elementos semelhantes.

object

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

StartTime

number

O horário inicial para adicionar o mosaico, em segundos (s). O valor padrão é o horário inicial do vídeo.

0

Duration

number

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

15

Dx

number

Os significados diferem dependendo se o valor é um número inteiro ou decimal:

  • 0 (padrão): Tanto o deslocamento em pixels quanto a proporção do deslocamento horizontal em relação à altura da resolução de saída são 0.

  • Inteiro: O deslocamento em pixels (px). Faixa de valores: [1,4096].

  • Decimal: A proporção do deslocamento horizontal em relação à altura da resolução de saída. Faixa de valores: (0,1).

0

Dy

number

Valor padrão: 0. Os significados diferem dependendo se o valor é um número inteiro ou decimal:

  • 0 (padrão): Tanto o deslocamento em pixels quanto a proporção do deslocamento vertical em relação à altura da resolução de saída são 0.

  • Inteiro: O deslocamento em pixels (px). Faixa de valores: [1,4096].

  • Decimal: A proporção do deslocamento vertical em relação à altura da resolução de saída. Faixa de valores: (0,1).

0

Width

number

A largura do mosaico. O valor padrão é o decimal 1.0, que preenche toda a largura do vídeo de saída. Os significados diferem dependendo se o valor é um número inteiro ou decimal:

  • Inteiro: O valor em pixels, em pixels (px). Faixa de valores: [1,4096].

  • Decimal: A proporção relativa à largura da resolução do vídeo de saída. Faixa de valores: (0,1).

100

Height

number

A altura do mosaico. O valor padrão é o decimal 1.0, que preenche toda a altura do vídeo de saída. Os significados diferem dependendo se o valor é um número inteiro ou decimal:

  • Inteiro: O valor em pixels, em pixels (px). Faixa de valores: [1,4096].

  • Decimal: A proporção relativa à altura da resolução do vídeo de saída. Faixa de valores: (0,1).

40

ReferPos

string

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

  • topleft (padrão): canto superior esquerdo

  • topright: canto superior direito

  • bottomright: canto inferior direito

  • bottomleft: canto inferior esquerdo

topleft

Speed

number

A configuração de velocidade de reprodução de vídeo. Faixa de valores: [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 com aceleração de velocidade.

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 visualização pública. Se você tiver alguma dúvida, participe do grupo do DingTalk para fornecer feedback. Para obter o número do grupo do DingTalk, consulte Fale conosco.

Confidence

number

O limite de confiança facial, que define o limite inferior de confiança para reconhecimento facial. Se o valor de confiança de um rosto detectado for inferior a esse limite, o rosto não será dessensibilizado.

  • Faixa de valores: 0.0 a 1.0.

  • Valor padrão: 0.0 (nenhuma filtragem de confiança é realizada).

0.4

MinSize

integer

O limite de tamanho mínimo de rosto, que define o tamanho mínimo dos rostos a serem dessensibilizados. Se a largura ou altura de um rosto detectado for menor que esse limite, o rosto não será dessensibilizado. Unidade: pixels. Valor padrão: 0, que indica nenhuma restrição ao tamanho do rosto.

0.4

ScaleRatio

number

A proporção de escala da caixa de detecção. Faixa de valores: 0.1 a 5.0. Escala tanto a largura quanto a altura da caixa de detecção com base em seu centro. • > 1.0: Amplia a área de desfoque. • < 1.0: Reduz a área de desfoque. • = 1.0: Usa a caixa de detecção original.

1.0

BlurRadius

integer

O raio de desfoque. Faixa de valores: 1 a 100. Um valor maior geralmente resulta em uma área mais desfocada.

100

Transparency

number

A transparência e a intensidade de suavização das bordas da área de desfoque. Faixa de valores: 0.0 a 1.0. • 0.0: Exibe o efeito de desfoque completo. • 1.0: Nenhum processamento de desfoque é realizado. Apenas a imagem original é exibida. • 0.0 a 1.0: Um valor maior resulta em uma proporção maior da imagem original, um raio de desfoque real menor e, geralmente, uma faixa de suavização de bordas maior.

0.0

LicensePlate

object

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

Nota

Este recurso está em visualização pública. Se você tiver alguma dúvida, participe do grupo do DingTalk para fornecer feedback. Para obter o número do grupo do DingTalk, consulte Fale conosco.

Confidence

number

O limite de confiança da placa de veículo, que define o limite inferior de confiança para reconhecimento de placas. Se o valor de confiança de uma placa detectada for inferior a esse limite, a placa não será dessensibilizada.

  • Faixa de valores: 0.0 a 1.0.

  • Valor padrão: 0.0 (nenhuma filtragem de confiança é realizada).

0.4

MinSize

integer

O limite de tamanho mínimo de placa de veículo, que define o tamanho mínimo das placas a serem dessensibilizadas. Se a largura ou altura de uma placa detectada for menor que esse limite, a placa não será dessensibilizada. Unidade: pixels. Valor padrão: 0, que indica nenhuma restrição ao tamanho da placa.

0.4

ScaleRatio

number

A proporção de escala da caixa de detecção. Faixa de valores: 0.1 a 5.0. Escala tanto a largura quanto a altura da caixa de detecção com base em seu centro. • > 1.0: Amplia a área de desfoque. • < 1.0: Reduz a área de desfoque. • = 1.0: Usa a caixa de detecção original.

1.0

BlurRadius

integer

O raio de desfoque. Faixa de valores: 1 a 100. Um valor maior geralmente resulta em uma área mais desfocada.

100

Transparency

number

A transparência e a intensidade de suavização das bordas da área de desfoque. Faixa de valores: 0.0 a 1.0. • 0.0: Exibe o efeito de desfoque completo. • 1.0: Nenhum processamento de desfoque é realizado. Apenas a imagem original é exibida. • 0.0 a 1.0: Um valor maior resulta em uma proporção maior da imagem original, um raio de desfoque real menor e, geralmente, uma faixa de suavização de bordas maior.

0.0