Todos os produtos
Search

Este produto

    Intelligent Media Services:Compilação de destaques

    Central de documentação

    Intelligent Media Services:Compilação de destaques

    Última atualização: Jul 05, 2026

    Descreve os parâmetros da API para produção de vídeos de montagem de destaques a partir de séries ou filmes, abrangendo materiais de entrada, configuração de edição e configurações de saída.

    Importante

    • Nota: Ao usar esta API, a região especificada na URL do Object Storage Service (OSS) para todos os ativos de mídia deve corresponder à região do endpoint da OpenAPI que você chamar.

    • Regiões suportadas: China (Shanghai), China (Beijing), China (Hangzhou), China (Shenzhen), EUA (Oeste) e Singapura. O recurso de detecção de rótulos de ação (correspondente aos parâmetros EnableActionRecog e CustomActions) é suportado apenas na região da China (Shanghai).

    • Esta versão não suporta materiais de vídeo sem vozes humanas. Certifique-se de que seus materiais de vídeo atendam a esse requisito.

    • Ao usar o serviço, substitua parâmetros como [your-bucket], [your-region-id], [your-file-name], [your-file-path] e IDs de ativos de mídia (por exemplo, "****9d46c8b4548681030f6e****") nos exemplos pelos seus valores reais.

    Notas de uso

    Parâmetros do InputConfig

    O InputConfig especifica materiais de entrada como filmagens, narrações, música de fundo e adesivos.

    Parâmetro

    Tipo

    Descrição

    Exemplo

    Obrigatório

    MediaArray

    List<String>

    • Materiais de vídeo para séries ou filmes. Apenas vídeos são suportados. Você pode inserir uma lista de IDs de ativos de mídia ou URLs do OSS. A duração total dos vídeos não pode exceder duas horas, e o número máximo de vídeos é 30.

    • Para mais informações sobre os formatos de vídeo suportados, consulte Formatos de vídeo.

      Importante

      Materiais de vídeo sem legendas e vozes humanas não são suportados.

    Consulte Exemplos de parâmetros.

    Sim

    HighlightStrategy

    HighlightStrategy

    A política de montagem de destaques.

    Consulte Exemplos de parâmetros.

    Não

    OpeningArray

    List<Media>

    • Clipes de abertura fixos. Um clipe é selecionado aleatoriamente para cada produção. Você pode inserir uma lista de IDs de ativos de mídia ou URLs do OSS. O número máximo de clipes é 20.

    • Imagens e vídeos são suportados. Para mais informações sobre os formatos suportados, consulte Formatos de vídeo e Formatos de imagem.

    Consulte Exemplos de parâmetros.

    Não

    EndingArray

    List<Media>

    • Clipes de encerramento fixos. Um clipe é selecionado aleatoriamente para cada produção. Você pode inserir uma lista de IDs de ativos de mídia ou URLs do OSS. O número máximo de clipes é 20.

    • Imagens e vídeos são suportados. Para mais informações sobre os formatos suportados, consulte Formatos de vídeo e Formatos de imagem.

    Consulte Exemplos de parâmetros.

    Não

    TitleArray

    List<String>

    Títulos. São suportados no máximo 50 títulos. Um título é selecionado aleatoriamente para cada produção. Cada título pode conter até 50 caracteres.

    ["Hema Fresh in Huilongguan is now open","Hema Fresh is now open"]

    Não

    SubHeadingArray

    List<SubHeading>

    Subtítulos. São suportados até cinco níveis de subtítulos.

    Consulte Exemplos de parâmetros.

    Não

    StickerArray

    List<Sticker>

    • Um array de adesivos. Um adesivo é selecionado aleatoriamente para cada produção. São suportados no máximo 50 adesivos. Você pode especificar IDs de ativos de mídia ou URLs do OSS.

    • Regra de randomização: Suponha que você forneça 10 adesivos e defina o número de vídeos de saída como 20. Primeiro, um número aleatório de 1 a 10 é gerado, por exemplo, 3. Em seguida, os adesivos são selecionados na ordem 3, 4, 5, 6, 7, 8, 9, 10, 1, 2, 3, 4, 5, 6, 7 e assim por diante.

    • Para mais informações sobre os formatos suportados, consulte Formatos de imagem.

    Consulte Exemplos de parâmetros.

    Não

    BackgroundMusicArray

    List<String>

    • Um array de faixas de música de fundo. Uma faixa é selecionada aleatoriamente para cada produção. São suportadas no máximo 50 faixas. Você pode especificar IDs de ativos de mídia ou URLs do OSS.

    • Regra de randomização: Suponha que você forneça 10 faixas de música de fundo e defina o número de vídeos de saída como 20. Primeiro, um número aleatório de 1 a 10 é gerado, por exemplo, 3. Em seguida, as faixas são selecionadas na ordem 3, 4, 5, 6, 7, 8, 9, 10, 1, 2, 3, 4, 5, 6, 7 e assim por diante.

    • Para mais informações sobre os formatos suportados, consulte Formatos de áudio.

    Consulte Exemplos de parâmetros.

    Não

    BackgroundImageArray

    List<String>

    • Um array de imagens de fundo. Uma imagem é selecionada aleatoriamente para cada produção. São suportadas no máximo 50 imagens. Você pode especificar IDs de ativos de mídia ou URLs do OSS.

    • Regra de randomização: Suponha que você forneça 10 imagens de fundo e defina o número de vídeos de saída como 20. Primeiro, um número aleatório de 1 a 10 é gerado, por exemplo, 3. Em seguida, as imagens são selecionadas na ordem 3, 4, 5, 6, 7, 8, 9, 10, 1, 2, 3, 4, 5, 6, 7 e assim por diante.

    • Para mais informações sobre os formatos suportados, consulte Formatos de imagem.

    Consulte Exemplos de parâmetros.

    Não

    Parâmetros do HighlightStrategy

    Parâmetro

    Tipo de dados

    Descrição

    Exemplo

    Obrigatório

    IntroConfig

    JSON

    Configuração para o início da seção de destaques.

    • Mode: O modo de seleção. Valor padrão: Disabled.

      • Auto: Seleciona automaticamente o clipe mais intenso como início.

      • Disabled: Nenhum início adicional é adicionado.

    {"Mode":"Disabled"}

    Não

    TargetDurationConfig

    TargetDurationConfig

    Configuração para a duração do vídeo de saída.

    {"TargetDuration": 180, "SpeedRange": [0.95, 1]}

    Não

    PlotPacingType

    String

    • O ritmo narrativo da seção de destaques. Este parâmetro só tem efeito quando ThemeConfig.ThemeType está definido como JumpHighlight.

    • Valores válidos:

      • Slow

      • Nãormal

      • Fast

    Slow

    Não. Valor padrão: Normal.

    ThemeConfig

    ThemeConfig

    Configuração do tema de edição.

    {"ThemeType":"JumpHighlight" }

    Não

    HighlightDescription

    String

    Uma descrição da política de extração de destaques. Este parâmetro só tem efeito quando ThemeConfig.ThemeType está definido como SmoothHighlight.

    Priorize cenas com as seguintes características. Emoções externalizadas evidentes: O protagonista masculino expressa diretamente emoções fortes por meio de ações, como raiva, proteção ou reviravolta (por exemplo, a 'rivalidade' entre o protagonista e seu irmão mais velho). Forte contraste: Transmita conflitos internos por meio de comportamentos ou identidades contrastantes (como lutas de poder ou tensão emocional). Conflitos de enredo concentrados: Concentre-se nos conflitos centrais do protagonista, como rixas familiares ou identidades disfarçadas, para aumentar o envolvimento do espectador. Enredos dramáticos proeminentes: Inclua diálogos bizarros ou reviravoltas no enredo (como 'uma mulher disfarçada de homem é reconhecida') para aumentar o apelo e gerar repercussão.

    Não

    FaceInfo

    FaceInfo

    • Defina informações de rosto para ajudar a identificar personagens. Se você deseja destacar certas personagens nos destaques, configure este parâmetro.

    • Este parâmetro só tem efeito quando ThemeConfig.ThemeType está definido como SmoothHighlight.

    {"ImageInfoList":[{"Name":"Ning X","ImageURL":"http://[your-cdn-domain]/[your-file-path]/face1.png"}]}

    Não

    EnableActionRecog

    Boolean

    Se deve ativar a detecção de ação. Quando ativada, os clipes de destaque são selecionados com base nos resultados da detecção de ação.

    Nota

    A detecção de ação é suportada apenas na região da China (Shanghai).

    true

    Não. Valor padrão: false.

    CustomActions

    List<String>

    Rótulos de ação personalizados. O sistema prioriza o mapeamento com base nos nomes dos rótulos fornecidos. Exemplo: ["fighting","crying"]. O array pode conter até 50 rótulos. Cada rótulo pode conter até 5 caracteres.

    Nota

    A detecção de ação é suportada apenas na região da China (Shanghai).

    ["fighting","crying"]

    Não

    Parâmetros do ThemeConfig

    Parâmetro

    Tipo de dados

    Descrição

    Exemplo

    Obrigatório

    ThemeType

    String

    • JumpHighlight: Edição com cortes secos. Seleciona vários clipes de destaque e os concatena em ordem cronológica. O vídeo resultante pode ter saltos narrativos e é adequado para criar compilações puras de destaques. Uma tarefa pode gerar apenas um vídeo por vez.

    • SmoothHighlight: Edição com cortes suaves. Seleciona vários clipes de destaque como aberturas e, em seguida, a partir de cada abertura, recorta um segmento do vídeo original com a duração do TargetDuration. O sistema remove automaticamente os clipes duplicados e ajusta o início e o fim. Os vídeos resultantes têm um enredo mais coerente, e vários vídeos podem ser gerados de uma vez.

    SmoothHighlight

    Não. Valor padrão: JumpHighlight.

    Parâmetros do TargetDurationConfig

    Parâmetro

    Tipo de dados

    Descrição

    Exemplo

    Obrigatório

    TargetDuration

    Float

    • A duração total desejada da seção de destaques (excluindo aberturas fixas, encerramentos e o início da seção de destaques), em segundos. A duração real pode variar ligeiramente. Se você não definir este parâmetro, a duração será adaptada automaticamente com base no enredo.

    • O valor deve ser maior ou igual a 5 segundos e menor ou igual à duração total do material de origem.

    180

    Não

    SpeedRange

    List<String>

    O intervalo de ajuste de velocidade.

    Se você deseja que o vídeo de saída tenha uma velocidade fixa, defina os valores inicial e final do intervalo de velocidade como iguais. Por exemplo, [1.2, 1.2] define a velocidade como 1,2x.

    Se você deseja que a duração real do vídeo de saída seja o mais próxima possível do TargetDuration, defina um intervalo de velocidade aceitável. Por exemplo:

    • Suponha que o TargetDuration seja 10 e o SpeedRange seja [0,95, 1]. O intervalo de duração aceitável calculado a partir do SpeedRange é [10, 10,526] segundos. A lógica para calcular a duração real do vídeo de saída é a seguinte:

      • Se a duração real do clipe for 10,5 segundos, que está dentro do intervalo aceitável [10, 10,526], a velocidade será ajustada para aproximadamente 0,9524x (10 / 10,5). A duração final do vídeo será de 10 segundos.

      • Se a duração real do clipe for 11 segundos, a velocidade será ajustada pelo limite inferior do SpeedRange, que é 0,95x. A duração final do vídeo será de 11 segundos multiplicados por 0,95, resultando em uma duração de 10,45 segundos.

    [0.95, 1]

    Não

    Parâmetros do FaceInfo

    Parâmetro

    Tipo

    Descrição

    Obrigatório

    ImageInfoList

    List<ImageInfo>

    Uma lista de fotos das personagens (rostos). A lista pode conter até 200 fotos.

    Não
    Parâmetros do ImageInfo

    Parâmetro

    Tipo

    Descrição

    Exemplo

    Obrigatório

    Name

    String

    O nome da personagem (rosto).

    Daniel

    Sim

    ImageURL

    String

    O endereço de armazenamento da foto da personagem (rosto). A URL deve ser acessível pela Internet. Certifique-se de que a imagem do rosto contenha apenas uma pessoa, e que o rosto esteja nítido, sem obstruções significativas ou partes ausentes.

    http://[your-cdn-domain]/[your-file-path]/face1.png

    Sim, um é obrigatório.

    ImageId

    String

    O ID do ativo de mídia da imagem.

    ****9d46c886b45481030f6e****

    Parâmetros do Media

    Parâmetro

    Tipo de dados

    Descrição

    Exemplo

    Obrigatório

    MediaId

    String

    O ID do ativo de mídia.

    ****b4549dfvc88681030f6e****

    Você deve especificar um dos dois.

    Se ambos forem especificados, o MediaId será usado.

    MediaURL

    String

    A URL do ativo de mídia. Apenas OSS autogerenciado é suportado.

    Regra: http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4

    Exemplo: http://example.oss-cn-shanghai.aliyuncs.com/example/example_{index}.mp4

    In

    Float

    Quando o material é um vídeo, este é o ponto de entrada do material, em segundos.

    0

    Não

    Out

    Float

    Quando o material é um vídeo, este é o ponto de saída do material, em segundos.

    5

    Não

    Duration

    Float

    Quando o material é uma imagem, esta é a duração de exibição do material, em segundos.

    2

    Não

    DyncFrames

    Integer

    Quando o material é um GIF, este é o número de quadros na imagem animada.

    25

    Não

    Exemplos de parâmetros

    Edição com cortes suaves

    {
  "MediaArray": [
    "****9d46c8b42f4581030f6e****",
    "****9d46c8b4frtf81030f6e****",
    "****9d46c8b4asdf81030f6e****",
    "****9d46c8b43d3481030f6e****"
  ],
  "HighlightStrategy": {
    "IntroConfig": {
      "Mode": "Disabled"
    },
    "TargetDurationConfig": {
      "TargetDuration": 300
    },
    "ThemeConfig": {
      "ThemeType": "SmoothHighlight"
    },
    "HighlightDescription":"Prioritize scenes with the following features. Obvious externalized emotions: The male protagonist directly expresses strong emotions through actions, such as anger, protection, or comeback (for example, the 'rivalry' between the male protagonist and his older brother). Strong contrast: Convey internal conflicts through contrasting behaviors or identities (such as power struggles or emotional tension). Concentrated plot conflicts: Focus on the protagonist's core conflicts, such as family feuds or disguised identities, to enhance viewer engagement. Prominent dramatic plots: Include bizarre dialogues or plot twists (such as 'a woman disguised as a man is recognized') to increase appeal and create buzz.",
    "FaceInfo":{"ImageInfoList":[{"Name":"Ning X","ImageURL":"http://[your-cdn-domain]/[your-file-path]/face1.png"}]},
    "EnableActionRecog": true,
    "CustomActions": ["fighting","crying"]
  },
  "OpeningArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "In": 0,
      "Out": 5
    },
    {
      "MediaId": "****9d46c8b4548661030f6e****",
      "In": 0,
      "Out": 5
    }
  ],
  "EndingArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "In": 0,
      "Out": 5
    },
    {
      "MediaId": "****9d46c8b4548661030f6e****",
      "In": 0,
      "Out": 5
    }
  ],
  "TitleArray": [
    "Hema Fresh in Huilongguan is now open",
    "Hema Fresh is now open"
  ],
  "SubHeadingArray": [
    {
      "Level": 1,
      "TitleArray": [
        "Subheading 1",
        "Subheading 2"
      ]
    },
    {
      "Level": 3,
      "TitleArray": [
        "Level 3 subheading"
      ]
    }
  ],
  "StickerArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "X": 10,
      "Y": 100,
      "Width": 300,
      "Height": 300,
      "Opacity": 0.6
    },
    {
      "MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png",
      "X": 10,
      "Y": 100,
      "Width": 300,
      "Height": 300
    }
  ],
  "BackgroundMusicArray": [
    "****b4549d46c88681030f6e****",
    "****549d46c88b4681030f6e****",
    "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].mp3"
  ],
  "BackgroundImageArray": [
    "****6c886b4549d481030f6e****",
    "****9d46c8548b4681030f6e****",
    "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png"
  ]
}

    Edição com cortes secos

    {
  "MediaArray": [
    "****9d46c8b42f4581030f6e****",
    "****9d46c8b4frtf81030f6e****",
    "****9d46c8b4asdf81030f6e****",
    "****9d46c8b43d3481030f6e****"
  ],
  "HighlightStrategy": {
    "IntroConfig": {
      "Mode": "Disabled"
    },
    "ThemeConfig": {
      "ThemeType": "JumpHighlight"
    },
    "EnableActionRecog": true,
    "CustomActions": ["fighting","crying"]
  },
  "OpeningArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "In": 0,
      "Out": 5
    },
    {
      "MediaId": "****9d46c8b4548661030f6e****",
      "In": 0,
      "Out": 5
    }
  ],
  "EndingArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "In": 0,
      "Out": 5
    },
    {
      "MediaId": "****9d46c8b4548661030f6e****",
      "In": 0,
      "Out": 5
    }
  ],
  "TitleArray": [
    "Hema Fresh in Huilongguan is now open",
    "Hema Fresh is now open"
  ],
  "SubHeadingArray": [
    {
      "Level": 1,
      "TitleArray": [
        "Subheading 1",
        "Subheading 2"
      ]
    },
    {
      "Level": 3,
      "TitleArray": [
        "Level 3 subheading"
      ]
    }
  ],
  "StickerArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "X": 10,
      "Y": 100,
      "Width": 300,
      "Height": 300,
      "Opacity": 0.6
    },
    {
      "MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png",
      "X": 10,
      "Y": 100,
      "Width": 300,
      "Height": 300
    }
  ],
  "BackgroundMusicArray": [
    "****b4549d46c88681030f6e****",
    "****549d46c88b4681030f6e****",
    "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].mp3"
  ],
  "BackgroundImageArray": [
    "****6c886b4549d481030f6e****",
    "****9d46c8548b4681030f6e****",
    "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name].png"
  ]
}

    Parâmetros do EditingConfig

    O EditingConfig especifica as configurações de produção para o vídeo de saída, como volume, posição, transições e filtros.

    Parâmetro

    Tipo

    Descrição

    Exemplo

    Obrigatório

    MediaConfig

    JSON

    Configuração para os materiais de vídeo de entrada.

    Consulte Exemplo de parâmetro.

    Não

    TitleConfig

    JSON

    Configuração de título. Suporta parâmetros de legenda.

    Consulte Exemplo de parâmetro.

    Não

    SubHeadingConfig

    JSON

    Configuração de subtítulos multinível. Suporta parâmetros de legenda.

    Descrição dos campos JSON:

    Consulte Exemplo de parâmetro.

    Não

    BackgroundMusicConfig

    JSON

    Configuração para música de fundo.

    Consulte Exemplo de parâmetro.

    Não

    BackgroundImageConfig

    JSON

    Configuração para a imagem de fundo. Se uma imagem de fundo já estiver configurada no InputConfig, este campo não terá efeito.

    Consulte Exemplo de parâmetro.

    Não

    ProcessConfig

    JSON

    Configuração para o processamento de montagem.

    Consulte Exemplo de parâmetro.

    FECanvas

    JSON

    Configuração de canvas para visualizações de página frontend.

    {"Width": 1080,"Height": 1920}

    Não

    ProduceConfig

    JSON

    Configuração para edição e produção de vídeo padrão. Para mais informações sobre os campos, consulte: EditingProduceConfig

    {"AutoRegisterInputVodMedia":true,"OutputWebmTransparentChannel":true,"CoverConfig":{"StartTime":3.3},"AudioChannelCopy":"left","PipelineId":"xxxd54a97cff4108b555b01166d4bxxx","MaxBitrate":5000,"KeepOriginMaxBitrate":false,"KeepOriginVideoMaxFps":false}

    Não

    Parâmetros do ProcessConfig

    Parâmetro

    Tipo

    Descrição

    Exemplo

    Obrigatório

    AllowVfxEffect

    Boolean

    Se deve permitir efeitos especiais.

    true

    Não. Valor padrão: false.

    VfxEffectProbability

    Float

    A probabilidade de aplicar um efeito especial a cada clipe de vídeo. Intervalo de valores: 0,0 a 1,0. Suporta até duas casas decimais.

    0.6

    Não. Valor padrão: 0,5.

    VfxFirstClipEffectList

    List<String>

    • Se o VfxFirstClipEffectList não estiver vazio, o efeito especial para o primeiro clipe do vídeo de saída será selecionado desta lista.

    • Se o VfxFirstClipEffectList estiver vazio, o efeito especial para o primeiro clipe será selecionado aleatoriamente entre os seguintes: "slightshow", "starfieldshinee", "starfieldshinee2", "starsparkle", "colorfulripples" e "starfield".

    • Para exemplos de efeitos especiais, consulte: Exemplos de efeitos especiais.

    ["slightshow","starfieldshinee"]

    Não

    VfxNãotFirstClipEffectList

    List<String>

    • Se o VfxNotFirstClipEffectList não estiver vazio, os efeitos especiais para clipes além do primeiro serão selecionados desta lista.

    • Se o VfxNotFirstClipEffectList estiver vazio, os efeitos especiais para clipes além do primeiro serão selecionados entre os seguintes: "zoomslight", "zoom", "zoominout" e "slightshake".

    • Para exemplos de efeitos especiais, consulte: Exemplos de efeitos especiais.

    ["zoomslight","zoom"]

    Não

    AllowTransition

    Boolean

    Se deve permitir transições.

    true

    Não. Valor padrão: false.

    TransitionDuration

    Float

    A duração da transição, em segundos. Se a duração da transição for maior que a duração do clipe menos 1, o efeito de transição para esse clipe não terá efeito.

    0.5

    Não. Valor padrão: 0,5 segundos.

    TransitionList

    List<String>

    Uma lista de efeitos de transição personalizados. Quando AllowTransition é true, um efeito de transição é selecionado aleatoriamente desta lista para produção. Para os efeitos de transição disponíveis, consulte Biblioteca de efeitos de transição. Se este parâmetro estiver vazio, uma transição será selecionada aleatoriamente entre as seguintes: "linearblur", "colordistance", "crosshatch", "dreamyzoom" e "doomscreentransition_up".

    ["directional", "linearblur"]

    Não

    UseUniformTransition

    Boolean

    Se deve usar o mesmo efeito de transição em todo um único vídeo de saída.

    true

    Não. Valor padrão: true.

    AllowFilter

    Boolean

    Se deve permitir filtros personalizados.

    false

    Não. Valor padrão: false.

    FilterList

    List<String>

    Uma lista de efeitos de filtro personalizados. Quando AllowFilter é true, um filtro é selecionado aleatoriamente desta lista para produção. Para os efeitos de filtro disponíveis, consulte Exemplos de efeitos de filtro. Se este parâmetro estiver vazio, nenhum efeito de filtro será adicionado.

    ["m1", "m2"]

    Não

    Exemplo de parâmetro

    {
  "MediaConfig": {
    "Volume": 0 // Mute the source video material by default.
  },
  "TitleConfig": {
    "Alignment": "TopCenter",
    "AdaptMode": "AutoWrap",
    "Font": "Alibaba PuHuiTi 2.0 95 ExtraBold",
    "SizeRequestType": "Nominal",
    "Y": 0.1, // The Y-coordinate of the title when the output video is in portrait mode.
    "Y": 0.05, // The Y-coordinate of the title when the output video is in landscape mode.
    "Y": 0.08 // The Y-coordinate of the title when the output video is in square mode.
  },
   "SubHeadingConfig": {
    "1": {
      "Y": 0.3,
      "FontSize": 40
    },
    "3": {
      "Y": 0.5,
      "FontSize": 30
    }
  },
  "BackgroundMusicConfig": {
    "Volume": 0.2,   // Set the background music volume to 20% by default.
    "Style": null
  },
  "ProcessConfig": {
    "AllowVfxEffect": false,	  // Specifies whether to add special effects.
    "AllowTransition": false,	  // Specifies whether to add transitions.
  }
}

    Parâmetros do TemplateConfig

    O TemplateConfig especifica um modelo de produção de vídeo. Para descrições de parâmetros e exemplos de uso, consulte TemplateConfig.

    Parâmetros do OutputConfig

    O OutputConfig especifica parâmetros de saída como o endereço de entrega, regras de nomenclatura, dimensões e o número de vídeos a serem produzidos.

    Parâmetro

    Tipo

    Descrição

    Exemplo

    Obrigatório

    MediaURL

    String

    O endereço do vídeo de saída. Deve conter o placeholder {index}.

    Regra: http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4

    Exemplo: http://example.oss-cn-shanghai.aliyuncs.com/example/example_{index}.mp4

    Obrigatório quando GeneratePreviewOnly é false e o vídeo de saída é entregue ao OSS.

    StorageLocation

    String

    O endereço de armazenamento para ativos de mídia entregues ao VOD.

    Regra: [your-vod-bucket].oss-[your-region-id].aliyuncs.com

    Exemplo: outin-****6c886b4549d481030f6e****.oss-cn-shanghai.aliyuncs.com

    Obrigatório quando GeneratePreviewOnly é false e o vídeo de saída é entregue ao VOD.

    FileName

    String

    O nome do arquivo de saída. Deve conter o placeholder {index}.

    Regra: [your-file-name]__{index}.mp4

    Exemplo: example_{index}.mp4

    Obrigatório quando GeneratePreviewOnly é false e o vídeo de saída é entregue ao VOD.

    GeneratePreviewOnly

    Boolean

    • Se GeneratePreviewOnly estiver definido como true, a tarefa atual gera apenas uma timeline para visualização e não produz efetivamente o vídeo. Você não precisa especificar o endereço do vídeo de saída.

    • Após a conclusão da tarefa de produção de vídeo com um clique, consulte o resultado da tarefa usando GetBatchMediaProducingJob. A lista de subtarefas retornada conterá o ID do projeto de edição (projectId). Você pode então chamar GetEditingProject para obter a timeline de visualização.

    false

    Não. Valor padrão: false.

    Count

    Integer

    • O número de vídeos de saída.

    • Quando ThemeConfig.ThemeType for JumpHighlight, o Count pode ser apenas 1.

    • Quando ThemeConfig.ThemeType for SmoothHighlight, o número de vídeos gerados é menor ou igual ao Count. O número real de vídeos depende do número de clipes de destaque. O valor do Count varia de 1 a 100.

    1

    Não. Default valor: 1.

    Width

    Integer

    A largura do vídeo de saída, em px.

    1080

    Sim

    Height

    Integer

    A altura do vídeo de saída, em px.

    1920

    Sim

    Video

    JSONObject

    Configuração para o stream de vídeo de saída, como Crf e Codec.

    {"Crf": 27}

    Não

    Exemplo de parâmetro

    {
 	"MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-name]_{index}.mp4",
 	"Count": 1,
 	"Width": 1080,
 	"Height": 1920,
 	"Video": {"Crf": 27},
        "GeneratePreviewOnly":false
}

    Lógica de processamento

    • Configure os materiais de edição usando o MediaArray. Os materiais são analisados e processados na ordem em que são fornecidos.

    • Configure a abertura e o encerramento da seção de destaques usando o HighlightStrategy.

    • Configure a abertura fixa (pre-roll) antes da seção de destaques e o encerramento fixo (post-roll) depois dela usando OpeningArray e EndingArray.

    • Os parâmetros na chamada da API de produção de vídeo com um clique têm prioridade sobre os parâmetros definidos em um modelo. Se você configurar o TemplateConfig, o sistema primeiro lê os parâmetros não vazios da chamada da API. Para quaisquer parâmetros vazios, o sistema lê os valores do modelo.

    Referências