Todos os produtos
Search
Central de documentação

Intelligent Media Services:Configurações de efeitos

Última atualização: Jun 28, 2026

A estrutura do objeto `Effect` varia conforme o tipo. Cada seção abaixo lista os parâmetros de um tipo específico de efeito.

Tipo de efeito: Text (texto de banner)

Exemplo de timeline:Legendas e modelos de legendas.

Nome

Tipo

Obrigatório

Descrição

X

Float

No

A distância horizontal do canto superior esquerdo do texto de banner até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0. Essas coordenadas são dimensionadas com base nos tamanhos do material e do vídeo de saída.

Y

Float

No

A distância vertical do canto superior esquerdo do texto de banner até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0. Essas coordenadas são dimensionadas com base nos tamanhos do material e do vídeo de saída.

TimelineIn

Float

No

O momento em que o texto de banner aparece na timeline. Unidade: segundos. O valor é preciso até quatro casas decimais. Se você não especificar este parâmetro, o valor `TimelineIn` do clip correspondente será usado.

TimelineOut

Float

No

O momento em que o texto de banner desaparece da timeline. Unidade: segundos. O valor é preciso até quatro casas decimais. Se você não especificar este parâmetro, o valor `TimelineOut` do clip correspondente será usado.

Content

String

Yes

O conteúdo do texto de banner.

Font

String

No

A fonte do texto de banner. Fontes suportadas:Lista de fontes. Padrão: SimSun.

FontSize

Int

Yes

O tamanho da fonte do texto de banner. Este tamanho de fonte é dimensionado com base nos tamanhos do material e do vídeo de saída. O valor padrão é 0. O valor máximo é 5000.

Observação:

  • Especifique `FontSize` ou `FixedFontSize`. Se você especificar ambos, apenas `FontSize` terá efeito.

SizeRequestType

String

No

O método usado para calcular o tamanho renderizado real do texto de banner a partir do tamanho da fonte. O valor padrão é `RealDim`.

  • `Nominal`: A altura renderizada da legenda em pixels é igual ao valor de `FontSize`.

  • `RealDim`: Para algumas fontes, a altura renderizada da legenda em pixels pode ser menor que o valor de `FontSize`.

FixedFontSize

Int

Yes

O tamanho da fonte do texto de banner. Este tamanho de fonte não é dimensionado com base nos tamanhos do material e do vídeo de saída.

Observação:

  • Especifique `FontSize` ou `FixedFontSize`. Se você especificar ambos, apenas `FontSize` terá efeito.

FixedX

Float

No

A distância horizontal do canto superior esquerdo do texto de banner até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0. Essas coordenadas não são dimensionadas com base nos tamanhos do material e do vídeo de saída.

FixedY

Float

No

O deslocamento horizontal do texto de banner a partir do canto superior esquerdo do vídeo de saída. Você pode especificar este valor em formato de porcentagem ou de pixel. Um valor no intervalo [0, 0,9999] é tratado como uma proporção relativa à largura do vídeo de saída. Um valor inteiro igual ou maior que 2 é tratado como um valor absoluto em pixels. O valor padrão é 0. A coordenada é relativa ao vídeo de saída e não é dimensionada com base nas dimensões do material de origem.

FontColor

String

No

A cor do texto de banner. O valor é um código de cor hexadecimal que começa com o símbolo de cerquilha (#). Exemplo: `#ffffff`.

FontColorOpacity

String

No

A opacidade do texto de banner. Intervalo: [0, 1]. 1 = opaco, 0 = totalmente transparente. Padrão: 1.

FontFace

FontFace

No

O estilo da fonte do texto de banner.

Spacing

Integer

No

O espaçamento entre caracteres do texto de banner. Unidade: pixels. O valor padrão é 0.

LineSpacing

Integer

No

O espaçamento entre linhas do texto de banner. Unidade: pixels. O valor padrão é 0.

Angle

Float

No

O ângulo de rotação no sentido anti-horário do texto de banner. Unidade: graus. O valor padrão é 0.

BorderStyle

Int

No

O formato de borda e sombra do texto de banner. Valores válidos: 1 (borda + sombra), 3 (caixa de fundo opaco). Padrão: 1.

Outline

Int

No

A largura do contorno do texto de banner. Unidade: pixels. O valor padrão é 0.

OutlineColour

String

No

A cor do contorno do texto de banner. O valor é um código de cor hexadecimal que começa com o símbolo de cerquilha (#). Exemplo: `#ffffff`.

Shadow

Int

No

A profundidade da sombra projetada pelo texto de banner. Unidade: pixels. O valor padrão é 0.

BackColour

String

No

A cor da sombra do texto de banner. O valor é um código de cor hexadecimal que começa com o símbolo de cerquilha (#). Exemplo: `#ffffff`.

Alignment

String

No

O alinhamento do texto de banner. O valor padrão é `TopLeft`. Valores válidos:

  • `TopLeft`: Canto superior esquerdo do vídeo.

  • `TopCenter`: Centro superior do eixo vertical do vídeo.

  • `TopRight`: Canto superior direito do vídeo.

  • `CenterLeft`: Centro esquerdo do eixo horizontal do vídeo.

  • `CenterCenter`: Centro do vídeo.

  • `CenterRight`: Centro direito do eixo horizontal do vídeo.

  • `BottomLeft`: Canto inferior esquerdo do vídeo.

  • `BottomCenter`: Centro inferior do eixo vertical do vídeo.

  • `BottomRight`: Canto inferior direito do vídeo.

Para posicionar com precisão as legendas em diferentes modos de alinhamento, defina este parâmetro como um dos seguintes valores:

  • `Left`: Alinhamento à esquerda. Defina `X` e `Y` como as coordenadas do vértice superior esquerdo da legenda em relação ao canto superior esquerdo do vídeo.

  • `Center`: Alinhamento ao centro. Defina `X` e `Y` como as coordenadas da interseção do eixo central da legenda com a borda superior, em relação ao canto superior esquerdo do vídeo.

  • `Right`: Alinhamento à direita. Defina `X` e `Y` como as coordenadas do vértice superior direito da legenda em relação ao canto superior esquerdo do vídeo.

AdaptMode

String

No

Especifica se o texto de banner deve ser quebrado ou redimensionado automaticamente quando exceder a largura do vídeo ou o `TextWidth` especificado.

  • `AutoWrap`: Quebra o texto automaticamente.

  • `AutoScale`: Redimensiona o texto automaticamente.

  • `AutoWrapAtSpaces`: Quebra o texto automaticamente apenas nos espaços. Adequado para quebra automática de legendas totalmente em inglês.

TextWidth

String

No

A largura da caixa de texto. Este parâmetro é válido apenas quando `AdaptMode` está definido. A largura da caixa de texto é usada para quebra ou redimensionamento automático. Se você não especificar este parâmetro, a largura do vídeo será usada para quebra ou redimensionamento automático. Um valor maior que 0 e menor ou igual a 1 representa uma largura relativa à largura do vídeo de saída. Um valor maior que 1 representa um valor absoluto em pixels.

FontUrl

String

No

O caminho para um arquivo de fonte no seu bucket OSS para gerar legendas. Arquivos de fonte nos formatos TTF, OTF e WOFF são suportados. Exemplo: `https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf`

EffectColorStyle

String

No

O estilo de arte em palavras para o texto de banner.Exemplos de efeitos de arte em palavras.

SubtitleEffects

SubtitleEffect[]

No

Os efeitos de múltiplas camadas para o texto de banner. Você pode definir contornos de múltiplas camadas, sombras de múltiplas camadas, efeitos de desfoque gaussiano e efeitos de fundo de legenda. O desfoque gaussiano é suportado apenas quando o tipo é definido como sombra.

Observação:

  • Se você definir `SubtitleEffects`, os campos `Outline` e `Shadow` na faixa de legenda não terão efeito.

  • Ao definir efeitos de contorno, sombra ou fundo de múltiplas camadas, a ordem do array `SubtitleEffects` determina a ordem das camadas. O primeiro `SubtitleEffect` no array é renderizado na camada inferior, e o último `SubtitleEffect` é renderizado na camada superior.

AaiMotionInEffect

String

No

O efeito de entrada para o texto de banner. Válido apenas para legendas de texto de banner.Exemplos de efeitos de legenda.

AaiMotionIn

Float

No

A duração do efeito de entrada para o texto de banner. Unidade: segundos. O valor é preciso até quatro casas decimais. Se você não especificar `AaiMotionIn`, o valor padrão é 0,5s. Se a duração do texto for menor que 0,5s, o valor será a duração total menos a duração da saída.

AaiMotionOutEffect

String

No

O efeito de saída para o texto de banner. Válido apenas para legendas de texto de banner.Exemplos de efeitos de legenda.

AaiMotionOut

Float

No

A duração do efeito de saída para o texto de banner. Este parâmetro é válido quando o tipo de legenda é texto de banner. Unidade: segundos. O valor é preciso até quatro casas decimais. Se você não especificar `AaiMotionOut`, o valor padrão é 0,5s. Se a duração do texto for menor que 0,5s, o valor será a duração total do texto.

AaiMotionLoopEffect

String

No

O efeito de loop para o texto de banner. Válido apenas para legendas de texto de banner. Não pode coexistir com efeitos de entrada ou saída.Exemplos de efeitos de legenda.

Ratio

Float

No

A velocidade de reprodução do efeito de loop para o texto de banner. Válido apenas para legendas de texto de banner. Preciso até quatro casas decimais. Padrão: 1. Valores maiores que 1 aceleram o loop; valores menores que 1 desaceleram.

TextureURL

String

No

O efeito de textura para a legenda. Este parâmetro é válido quando o tipo de legenda é texto de banner. Os formatos PNG, JPG, JPEG e BMP são suportados. Atualmente, apenas arquivos OSS são suportados. Exemplo: `https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png`

BubbleStyleId

String

No

O estilo de balão para o texto de banner. Válido apenas para legendas de texto de banner.Exemplos de legendas em balão.

BubbleWidth

Float

No

A largura do fundo do balão em relação ao vídeo de saída. Este parâmetro é válido apenas ao usar legendas em balão. Um valor maior que 1 representa um valor absoluto em pixels. Um valor menor ou igual a 1 representa um valor relativo.

BubbleHeight

Float

No

A altura do fundo do balão em relação ao vídeo de saída. Este parâmetro é válido apenas ao usar legendas em balão. Um valor maior que 1 representa um valor absoluto em pixels. Um valor menor ou igual a 1 representa um valor relativo.

Tipo de efeito: DeWatermark (mascaramento)

Nome

Tipo

Obrigatório

Descrição

X

Float

No

A distância horizontal do canto superior esquerdo da área borrada até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0.

Y

Float

No

A distância vertical do canto superior esquerdo da área borrada até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0.

Width

Float

Yes

A largura da área borrada no vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels.

Height

Float

Yes

A altura da área borrada no vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels.

Tipo de efeito: Crop (recorte)

Exemplo de timeline:Recorte de vídeo.

Nome

Tipo

Obrigatório

Descrição

X

Float

No

A distância horizontal do canto superior esquerdo da área mantida após o recorte até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0.

Y

Float

No

A distância vertical do canto superior esquerdo da área mantida após o recorte até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels. O valor padrão é 0.

Width

Float

Yes

A largura da área mantida no vídeo de saída após o recorte. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels.

Height

Float

Yes

A altura da área mantida no vídeo de saída após o recorte. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels.

Tipo de efeito: Scale (dimensionamento)

Se a proporção de aspecto de um material diferir do vídeo de saída e nenhum efeito de dimensionamento estiver configurado, o material é dimensionado automaticamente para ajustar a largura ou a altura, centralizado, e o espaço restante é preenchido com barras pretas.

Exemplo de timeline:Configuração de dimensionamento.

Nome

Tipo

Obrigatório

Descrição

Width

Float

Yes

A largura da área mantida no vídeo de saída após o dimensionamento. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 1 representa um valor absoluto em pixels.

Height

Float

Yes

A altura da área mantida no vídeo de saída após o dimensionamento. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 1 representa um valor absoluto em pixels.

Tipo de efeito: Pad (preenchimento)

Se a proporção de aspecto de um material diferir do vídeo de saída e nenhum efeito de preenchimento estiver configurado, o material é dimensionado automaticamente para ajustar a largura ou a altura, centralizado, e o espaço restante é preenchido com barras pretas.

Exemplo de timeline:Converter vídeo horizontal para vertical com preenchimento borrado.

Nome

Tipo

Obrigatório

Descrição

Left

Float

No

A distância da borda esquerda do material até a borda esquerda do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 1 representa um valor absoluto em pixels.

Right

Float

No

A distância da borda direita do material até a borda direita do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 1 representa um valor absoluto em pixels.

Top

Float

No

A distância da borda superior do material até a borda superior do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 1 representa um valor absoluto em pixels.

Bottom

Float

No

A distância da borda inferior do material até a borda inferior do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 1 representa um valor absoluto em pixels.

Color

String

No

A cor do preenchimento. O valor é um código de cor hexadecimal que começa com o símbolo de cerquilha (#). Exemplo: `#000000`. A cor padrão é preto.

Tipo de efeito: Background (configurações de fundo)

As configurações de fundo incluem desfoque e cor sólida para preencher áreas em branco quando os tamanhos do material e da saída diferem.

Compatível com os efeitos Crop, Scale, VFX e Transition.

Exemplo de timeline:Converter vídeo horizontal para vertical e definir cor de fundo.

Nome

Tipo

Obrigatório

Descrição

SubType

String

Yes

O subtipo. Valores válidos:

`Blur`: Desfoque de fundo.

`Color`: Cor de fundo.

Radius

Float

No

O raio de desfoque. Este parâmetro é válido apenas quando `SubType` é `Blur`. O valor deve estar no intervalo [0,01, 1].

Color

String

No

O valor da cor. Este parâmetro é válido apenas quando `SubType` é `Color`. O valor é um código de cor RGB hexadecimal. Exemplo: `#FFFFFF`.

Tipo de efeito: Transition (transição)

Importante

Este efeito de transição é criado pela sobreposição de dois clips, o que encurta a duração do vídeo final. Para evitar encurtar a duração, use o efeito `DLTransition` descrito abaixo.

Uma transição ocorre entre dois clips. Configure-a apenas no primeiro clip. O efeito sobrepõe o final do clip 1 com o início do clip 2, reduzindo a duração total do vídeo pelo comprimento da transição.

Por exemplo, uma faixa de vídeo tem dois clips: Clip1 (10s) e Clip2 (8s). Se você adicionar uma transição de 4s entre eles, a duração total da faixa de vídeo se torna 14s em vez de 18s.

A tabela a seguir descreve as propriedades de transição. Efeitos de transição específicos:Exemplos de efeitos de transição.

Exemplo de timeline:Exemplo de configuração de timeline de transição.

Nome

Tipo

Obrigatório

Descrição

SubType

String

Yes

O subtipo de transição. Especifique um ou mais subtipos de transição, separados por vírgulas (,). Um subtipo aleatório é selecionado da lista. Você também pode especificar `random` para selecionar um subtipo aleatório entre todas as transições disponíveis. Exemplo: `directional`. Todos os valores e efeitos:Exemplos de efeitos de transição.

Duration

Float

No

A duração do efeito de transição. Unidade: segundos. O valor é preciso até quatro casas decimais. O valor padrão é 1s.

Tipo de efeito: DLTransition (transição com preenchimento de quadros)

Ao contrário de um efeito `Transition` padrão, uma transição de bloqueio de duração (`DLTransition`) não encurta a duração do vídeo final. Em vez disso, ela preenche o período de transição com quadros estáticos.

Os parâmetros para `DLTransition` são os mesmos que para `Transition`.

Nome

Tipo

Obrigatório

Descrição

SubType

String

Yes

O subtipo de transição. Especifique um ou mais subtipos de transição, separados por vírgulas (,). Um subtipo aleatório é selecionado da lista. Você também pode especificar `random` para selecionar um subtipo aleatório entre todas as transições disponíveis. Exemplo: `directional`. Todos os valores e efeitos:Exemplos de efeitos de transição.

Duration

Float

No

A duração do efeito de transição. Unidade: segundos. O valor é preciso até quatro casas decimais. O valor padrão é 1s.

Tipo de efeito: VFX

Exemplo de timeline:VFX.

Nome

Tipo

Obrigatório

Descrição

SubType

String

Yes

O subtipo do efeito. Especifique um ou mais subtipos de efeito, separados por vírgulas (,). Um subtipo aleatório é selecionado da lista. Você também pode especificar `random` para selecionar um subtipo aleatório entre todos os efeitos disponíveis. Exemplo: `colorfulradial`. Todos os valores e efeitos:Exemplos de efeitos.

X

Float

No

Este campo é válido apenas quando `SubType` é `mosaic_rect` ou `blur`. Ele especifica a distância horizontal do canto superior esquerdo da área de efeito até o canto superior esquerdo do vídeo de saída.

Observação: O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels.

Y

Float

No

Este campo é válido apenas quando `SubType` é `mosaic_rect` ou `blur`.

Ele especifica a distância vertical da área de efeito até o canto superior esquerdo do vídeo de saída. Observação: O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels.

Width

Float

No

Este campo é válido apenas quando `SubType` é `mosaic_rect` ou `blur`. Ele especifica a largura da área de efeito no vídeo de saída. Observação: O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels.

Height

Float

No

Este campo é válido apenas quando `SubType` é `mosaic_rect` ou `blur`. Ele especifica a altura da área de efeito no vídeo de saída. Observação: O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels.

ExtParams

String

No

Parâmetros estendidos para o efeito. Este campo é válido apenas para cenários de mascaramento, quando `SubType` é `mask_circle`, `mask_rec`, `mask_linear` ou `mask_minor`. Os parâmetros de configuração de `ExtParams` em cenários de mascaramento são descritos abaixo.

Exemplos de mascaramento e efeitos de saída:Efeitos de mascaramento.

Importante

Para os seguintes parâmetros de máscara, você deve especificar valores float em formato de ponto flutuante, como 0,5 ou 2,0.

Parâmetros para efeitos de máscara circular

SubType=mask_circle

Descrição dos parâmetros de ExtParams

Parâmetro

Tipo

Intervalo de valores

Padrão

Descrição

x

float

[0.0, largura do material]

0.5

A coordenada X do centro da máscara em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels.

y

float

[0.0, altura do material]

0.5

A coordenada Y do centro da máscara em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à altura do material. Um valor maior que 1,0 representa um valor absoluto em pixels.

width

float

[0.0, largura do material]

0.8

A largura da máscara elíptica em relação à largura do material. Um valor no intervalo [0,0, 1,0] representa uma largura relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels.

height

float

[0.0, altura do material]

0.8

A altura da máscara elíptica em relação à largura do material. Um valor no intervalo [0,0, 1,0] representa uma altura relativa à altura do material. Um valor maior que 1,0 representa um valor absoluto em pixels.

antialias

float

[0.0, 1.0]

0.1

O parâmetro de suavização de bordas da máscara elíptica. Um valor maior resulta em maior grau de suavização das bordas.

angle

float

[-9999.0, 9999.0]

0.0

O ângulo de rotação.

Parâmetros para efeitos de máscara retangular

SubType=mask_rec

Descrição dos parâmetros de ExtParams

Parâmetro

Tipo

Intervalo de valores

Padrão

Descrição

x

float

[0.0, largura do material]

0.5

A coordenada X do centro da máscara retangular no material de vídeo, em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels.

y

float

[0.0, altura do material]

0.5

A coordenada Y do centro da máscara retangular no material de vídeo, em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à altura do material. Um valor maior que 1,0 representa um valor absoluto em pixels.

width

float

[0.0, largura do material]

0.8

A largura da máscara retangular. Um valor no intervalo [0,0, 1,0] representa uma largura relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels.

height

float

[0.0, altura do material]

0.8

A altura da máscara retangular. Um valor no intervalo [0,0, 1,0] representa uma altura relativa à altura do material. Um valor maior que 1,0 representa um valor absoluto em pixels.

antialias

float

[0.0, 1.0]

0.1

O parâmetro de suavização de bordas da máscara retangular. Um valor maior resulta em maior grau de suavização das bordas.

radius

float

[0.0, o maior entre a largura ou a altura do material]

0.1

O raio de borda da máscara retangular. Um valor no intervalo [0,0, 1,0] representa um raio relativo ao maior entre a largura ou a altura do material. Um valor maior que 1,0 representa um valor absoluto em pixels.

angle

float

[-9999.0, 9999.0]

0.0

O ângulo de rotação.

Parâmetros para efeitos de máscara linear

SubType=mask_linear

Descrição dos parâmetros de ExtParams

Parâmetro

Tipo

Intervalo de valores

Padrão

Descrição

x

float

[0.0, largura do material]

0.5

A coordenada X do ponto de referência central da máscara linear, em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels.

y

float

[0.0, altura do material]

0.5

A coordenada Y do ponto de referência central da máscara linear no material de vídeo, em relação ao canto superior esquerdo do vídeo. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels.

antialias

float

[0.0, 1.0]

0.1

O parâmetro de suavização de bordas da máscara linear. Um valor maior resulta em maior grau de suavização das bordas.

angle

float

[-9999.0, 9999.0]

0.0

O ângulo de rotação.

Parâmetros para efeitos de máscara espelho

SubType=mask_minor

Descrição dos parâmetros de ExtParams

Parâmetro

Tipo

Intervalo de valores

Padrão

Descrição

x

float

[0.0, largura do material]

0.5

A coordenada X do ponto de referência central da máscara espelho, em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à largura do material. Um valor maior que 1,0 representa um valor absoluto em pixels.

y

float

[0.0, altura do material]

0.5

A coordenada Y do ponto de referência central da máscara espelho, em relação ao canto superior esquerdo do material. Um valor no intervalo [0,0, 1,0] representa uma coordenada relativa à altura do material. Um valor maior que 1,0 representa um valor absoluto em pixels.

antialias

float

[0.0, 1.0]

0.1

O parâmetro de suavização de bordas da máscara espelho. Um valor maior resulta em maior grau de suavização das bordas.

angle

float

[-9999.0, 9999.0]

0.0

O ângulo de rotação.

Tipo de efeito: Filter (filtro)

Exemplo de timeline:Filtro.

Nome

Tipo

Obrigatório

Descrição

SubType

String

Yes

O subtipo de filtro. Especifique um ou mais subtipos de filtro, separados por vírgulas (,). Um subtipo aleatório é selecionado da lista. Você também pode especificar `random` para selecionar um subtipo aleatório entre todos os filtros disponíveis. Exemplo: `M1`. Todos os valores e efeitos:Exemplos de efeitos de filtro.

TimelineIn

Float

No

O momento em que o filtro é aplicado na timeline. Unidade: segundos. O valor é preciso até quatro casas decimais. Se você não especificar este parâmetro, o valor `TimelineIn` do clip correspondente será usado.

TimelineOut

Float

No

O momento em que o filtro é removido da timeline. Unidade: segundos. O valor é preciso até quatro casas decimais. Se você não especificar este parâmetro, o valor `TimelineOut` do clip correspondente será usado.

ExtParams

String

No

Parâmetros estendidos para o filtro. Este campo é válido apenas quando `SubType` é `color`, que aplica um filtro de cor. Os parâmetros de configuração de `ExtParams` para um filtro de cor são descritos abaixo.

Parâmetros de ExtParams para filtro de cor

Exemplo de timeline:Usar filtros de cor.

Descrição dos parâmetros de ExtParams

Parâmetro

Tipo

Intervalo de valores

Descrição

Padrão

brightness

int

[-255,255]

Brilho

0

contrast

int

[-100,100]

Contraste

0

saturation

int

[-100,100]

Saturação

0

kelvin_temperature

int

[1000,40000]

A temperatura. Este parâmetro funciona com

O parâmetro temperature_ratio é aplicado.

6000

temperature_ratio

int

[0,100]

A proporção de temperatura.

0

tint

int

[-100,100]

Matiz

0

dark_corner_ratio

int

[0,100]

A proporção de vinheta.

0

Tipo de efeito: Volume (ajuste de volume)

Exemplos de timeline:Silenciar um vídeo inteiro e Ajustar o volume de vídeo e áudio.

Nome

Tipo

Obrigatório

Descrição

Gain

Float

No

O ganho de volume. Intervalo: [0, 10]. 0 = mudo, 1 = volume original, menor que 1 = mais baixo, maior que 1 = mais alto. Padrão: 1. Valores excessivamente altos podem causar distorção.

Tipo de efeito: AFade (fade de áudio)

Exemplo de timeline:Configurar fade de entrada e saída para clips somente de áudio e áudio em vídeos.

Nome

Tipo

Obrigatório

Descrição

SubType

String

Yes

O subtipo de fade de áudio. Valores válidos:

  • `In` (fade de entrada)

  • `Out` (fade de saída)

Duration

Float

No

A duração do fade. Um fade de entrada é aplicado ao início do clip. Um fade de saída é aplicado ao final do clip. O valor padrão é 0, o que significa que o efeito está desativado.

Curve

String

No

A curva de volume para o fade de áudio. O valor padrão é `exp`.

Valores válidos:

  • `exp` (Curva de volume exponencial)

  • `tri` (Curva de volume linear)

Tipo de efeito: AI_ASR (conversão de fala em texto)

Este efeito gera legendas a partir do áudio. Você pode colocar este efeito no objeto `Effects` de uma faixa de vídeo ou áudio. Os parâmetros são os mesmos que para Tipo de efeito: Text (texto de banner). Por padrão, as legendas são centralizadas na parte inferior do vídeo. Este recurso está disponível apenas nas regiões China (Pequim), China (Xangai) e China (Hangzhou).

Nome

Tipo

Obrigatório

Descrição

X

Float

No

A distância horizontal do canto superior esquerdo do texto de banner até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da largura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels.

Y

Float

No

A distância vertical do canto superior esquerdo do texto de banner até o canto superior esquerdo do vídeo de saída. O valor pode ser uma porcentagem ou um valor em pixels. Um valor no intervalo [0, 0,9999] representa uma porcentagem da altura do vídeo de saída. Um valor inteiro igual ou maior que 2 representa um valor absoluto em pixels.

Font

String

No

A fonte do texto de banner. Fontes suportadas:Lista de fontes. Padrão: SimSun.

FontSize

Int

Yes

O tamanho da fonte do texto de banner.

FontColor

String

No

A cor do texto de banner. O valor é um código de cor hexadecimal que começa com o símbolo de cerquilha (#). Exemplo: `#ffffff`.

FontColorOpacity

String

No

A opacidade do texto de banner. Intervalo: [0, 1]. 1 = opaco, 0 = totalmente transparente. Padrão: 1.

FontFace

FontFace

No

O estilo da fonte do texto de banner.

NeedHighlighting

Boolean

No

Especifica se o realce automático deve ser ativado para legendas ASR.

HighlightingStyle

Style

No

O estilo para legendas realçadas.

Tipo de efeito: Rotate (rotação do material)

Este efeito rotaciona um material em um ângulo especificado. Apenas 90, 180 e 270 graus são suportados. Aplica-se a materiais em faixas de vídeo ou imagem.

Exemplo de timeline:Rotação de material.

Nome

Tipo

Obrigatório

Descrição

Degree

Integer

Yes

O ângulo de rotação no sentido horário do material. Apenas 90, 180 e 270 graus são suportados.

Tipo de efeito: AI_Matting (chroma key)

Este efeito extrai um sujeito de um fundo de tela verde ou azul e o sobrepõe em outro vídeo ou imagem de fundo. Este recurso está disponível apenas nas regiões China (Pequim), China (Xangai) e China (Hangzhou).

Nome

Tipo

Obrigatório

Descrição

Color

String

Yes

A cor de fundo a ser removida. Apenas `green` (tela verde) e `blue` (tela azul) são suportados.

Auto

Integer

Yes

Especifica se a cor de fundo deve ser detectada automaticamente. Valores válidos:

  • 0: Detectar com base no limite.

  • 1: Detecção automática.

Thres

Float

No

O limite para detecção de cor de fundo. Um valor maior significa detecção mais flexível. O valor deve estar no intervalo [0, 10].

Tipo de efeito: AI_RealMatting (remoção de fundo em cena real)

Este efeito extrai uma pessoa de uma cena real em um vídeo e a sobrepõe em outro vídeo ou imagem de fundo. Este recurso está disponível apenas nas regiões China (Pequim), China (Xangai) e China (Hangzhou).

Nome

Tipo

Obrigatório

Descrição

Thres

Float

No

O limite para detecção de cor de fundo. Um valor maior significa detecção mais flexível. O valor deve estar no intervalo [0, 10]. O valor padrão é 2.

Tipo de efeito: AI_Delogo (remoção inteligente de logotipo)

Este efeito reconhece e remove logotipos de vídeos de forma inteligente. Este recurso está disponível apenas nas regiões China (Pequim) e China (Xangai).

Tipo de efeito: Clip (recorte aleatório)

Este efeito recorta aleatoriamente um segmento do material de origem e o adiciona à timeline.

Nome

Tipo

Obrigatório

Descrição

SubType

String

Yes

O tipo de recorte. Apenas o recorte aleatório é suportado: `RandomClip`.

ClipDuration

Float

Yes

A duração do segmento recortado.

Tipo de efeito: Flip (inversão)

Você pode inverter vídeos ou imagens em uma faixa de vídeo horizontalmente ou verticalmente.

Exemplo de timeline:Inversão horizontal e vertical.

Nome

Tipo

Obrigatório

Descrição

Direction

String

Yes

  • `horizontal`: Inverter horizontalmente.

  • `vertical`: Inverter verticalmente.

Tipo de efeito: KenBurns (efeito Ken Burns)

Este efeito aplica um efeito Ken Burns a um vídeo ou imagem em uma faixa de vídeo.

Limitações:

  • Este efeito se aplica a imagens e vídeos. Pode ser usado com VFX, filtros e transições.

  • Como este efeito permite definir a largura e a altura do quadro de saída usando os parâmetros `WindowW` e `WindowH`, ele não pode ser usado com os efeitos `Crop`, `Scale`, `Pad` ou `Background`.

Nome

Tipo

Obrigatório

Descrição

Exemplo

Duration

Float

No

A duração do efeito. O padrão é a duração do clip. O valor máximo é 10. Unidade: segundos (s).

5

WindowW

Float

No

A largura do clip. Por padrão, o valor é igual à largura do vídeo de saída. Unidade: pixels.

Um valor no intervalo 0 < WindowW <= 1 é um valor relativo. Um valor maior que 1 é um valor absoluto.

1

WindowH

Float

No

A altura do clip. Por padrão, o valor é igual à altura do vídeo de saída. Unidade: pixels.

Se o valor de WindowH estiver no intervalo (0,1], o valor é relativo.

> Um valor de 1 indica o valor absoluto.

1

Start

String

No

A posição da área de efeito antes da aplicação do efeito Ken Burns. A posição é determinada pelas coordenadas x e y do canto superior esquerdo e pela largura e altura da área de efeito. Os parâmetros são opcionais. Os valores devem ser separados por vírgulas (,).

"StartX, StartY, StartW, StartH"

Limitações:

0 < StartX + StartW <=1

0 < StartY + StartH <=1

"0,0,0.9,0.9"

StartX

Float

No

A coordenada x do canto superior esquerdo da área de efeito antes da aplicação do efeito Ken Burns. Unidade: pixels.

Se o valor do parâmetro StartX estiver no intervalo [0,1), o valor é relativo.

Um valor igual ou maior que 1 indica um valor absoluto.

0

StartY

Float

No

A coordenada y do canto superior esquerdo da área de efeito antes da aplicação do efeito Ken Burns. Unidade: pixels.

Se o valor do parâmetro StartY estiver no intervalo [0,1), o valor é relativo.

O valor absoluto deve ser maior ou igual a 1.

0

StartW

Float

No

A largura da área de efeito antes da aplicação do efeito Ken Burns. Unidade: pixels.

Se o valor do parâmetro StartW estiver no intervalo (0,1], o valor é relativo.

> Um valor de 1 indica o valor absoluto.

0.9

StartH

Float

No

A altura da área de efeito antes da aplicação do efeito Ken Burns. Unidade: pixels.

Se o valor do parâmetro StartH estiver no intervalo (0,1], o valor é relativo.

> 1 indica um valor absoluto.

0.9

End

String

No

A posição da área de efeito após a aplicação do efeito Ken Burns. A posição é determinada pelas coordenadas x e y do canto superior esquerdo e pela largura e altura da área de efeito. Os parâmetros são opcionais. Os valores devem ser separados por vírgulas (,).

"EndX, EndY, EndW, EndH"

Limitações:

0 < EndX + EndW <=1

0 < EndY + EndH <=1

"0,0,1,1"

EndX

Float

No

A coordenada x do canto superior esquerdo da área de efeito após a aplicação do efeito Ken Burns. Unidade: pixels.

Se o valor do parâmetro StartX estiver no intervalo [0,1), o valor é relativo.

O valor absoluto deve ser maior ou igual a 1.

0

EndY

Float

No

A coordenada y do canto superior esquerdo da área de efeito após a aplicação do efeito Ken Burns. Unidade: pixels.

Se o valor do parâmetro StartY estiver no intervalo [0,1), o valor é relativo.

O valor absoluto deve ser maior ou igual a 1.

0

EndW

Float

No

A largura da área de efeito após a aplicação do efeito Ken Burns. Unidade: pixels.

Se o valor do parâmetro StartW estiver no intervalo (0,1], o valor é relativo.

> Um valor de 1 indica o valor absoluto.

1

EndH

Float

No

A altura da área de efeito após a aplicação do efeito Ken Burns. Unidade: pixels.

Se o valor do parâmetro StartH estiver no intervalo (0,1], o valor é relativo.

> 1 especifica o valor absoluto.

1

Tipo de efeito: ADenoise (remoção de ruído de áudio)

Você pode aplicar este efeito a vídeos com áudio em uma faixa de vídeo ou a clips de áudio em uma faixa de áudio.

Nome

Tipo

Obrigatório

Descrição

Mode

Integer

No

  • 0: Sem processamento (padrão).

  • 1: Redução de ruído leve.

  • 2: Protege a música enquanto remove ruído estacionário. Adequado para conteúdo musical.

  • 3: Remoção forte de ruído estacionário. Adequado para conteúdo de fala sem música.

  • 4: Extração de voz. Remove tanto ruído estacionário quanto não estacionário. Adequado para conteúdo não musical.

Tipo de efeito: Zoom (zoom)

Este efeito adiciona um efeito de zoom ao clip correspondente.

Importante

Este efeito é suportado apenas para clips em uma `VideoTrack`.

Nome

Tipo

Obrigatório

Descrição

StartRate

Float

No

  • A proporção de zoom inicial.

  • Padrão: 1.0.

  • Intervalo de valores: [1.0, 5.0].

EndRate

Float

No

  • A proporção de zoom final.

  • Padrão: `StartRate` + 0.3.

  • Intervalo de valores: [`StartRate`, 5.0].

Duration

Float

No

  • A duração do efeito.

  • Padrão: A duração de renderização do clip atual.

  • Intervalo de valores: [0, duração de renderização do clip atual].

Tipo de efeito: Harmonization (harmonização de fundo)

Este efeito adiciona um efeito de harmonização de fundo ao clip correspondente e é destinado principalmente a clips de vídeo de humano digital. Quando você aplica este efeito a um clip de vídeo de humano digital, a iluminação, o brilho e a temperatura de cor do clip são ajustados para corresponder à imagem de fundo. Isso reduz a incompatibilidade visual entre o clip de humano digital e o fundo.

Importante
  1. Este efeito é suportado apenas para clips em uma `VideoTrack`.

  2. Você pode adicionar apenas um efeito de harmonização em uma única solicitação de edição de vídeo.

Este efeito não possui outros parâmetros de entrada.

Tipo de efeito: ALoudNorm (normalização de volume)

O efeito `ALoudNorm` se aplica a um único material de áudio ou vídeo. Se você tiver vários materiais de áudio ou vídeo e quiser que todos tenham a mesma sonoridade, configure `ALoudNorm` em cada material separadamente.

Nota

Este efeito se aplica apenas a clips de áudio e vídeo. Se `ALoudNorm` for usado com `ADenoise` ou `Volume`, os efeitos são aplicados na seguinte ordem: `ADenoise` > `Volume` > `ALoudNorm`.

Exemplo de timeline:Normalização de volume.

Nome

Tipo

Obrigatório

Descrição

Loudness

Float

No

A sonoridade alvo, que determina o nível de volume e está em conformidade com o padrão EBU R128. Intervalo de valores: [-70,0, -5,0]. Padrão: -24,0.

TruePeak

Float

No

O nível de pico verdadeiro, que limita o nível de pico mais alto do sinal de áudio. Intervalo de valores: [-9,0, +0,0]. Padrão: -2,0.

Tipo de efeito: AEqualize (equalização de volume)

Este é um efeito global que se aplica à faixa de efeitos. Ele aplica equalização de volume uniforme à mixagem de áudio final.

Nota

Este efeito é global e não pode ser aplicado a um único clip.

Exemplo de timeline:Equalização de volume.

Nome

Tipo

Obrigatório

Descrição

Peak

Float

No

O nível de pico alvo do áudio. O valor padrão é 0,95. Não exceda este valor.

O valor deve estar no intervalo aberto (0, 1).

Gain

Float

No

O coeficiente de ganho máximo. O valor deve estar no intervalo [1,0, 100,0]. O valor padrão é 10,0.

O normalizador de áudio dinâmico determina o fator de ganho (local) máximo possível para cada quadro de entrada que não cause corte ou distorção.

Tipo de efeito: FreezeFrame (quadro congelado)

Este efeito se aplica a materiais de vídeo em uma faixa de vídeo e cria um quadro congelado a partir do último quadro do vídeo.

Nota

Este efeito se aplica apenas a materiais de vídeo em uma faixa de vídeo. Ele não se aplica a materiais de imagem em uma faixa de vídeo ou a materiais em uma faixa de áudio.

Este efeito não pode ser usado com o efeito Tipo de efeito: Transition.

Exemplo de timeline:Quadro congelado de vídeo.

Nome

Tipo

Obrigatório

Descrição

Duration

Float

No

A duração do quadro congelado. O valor padrão é 0. Unidade: segundos (s).