Bulk Video Creator template parameters - Intelligent Media Services: Central de Documentação do Alibaba Cloud

Ao criar um modelo do Bulk Video Creator pela API AddTemplate, defina os ativos de entrada, as opções de edição e as configurações de saída.

Importante

A região na URL do OSS de todos os ativos de mídia deve corresponder à região do endpoint de serviço da OpenAPI chamada.
Regiões compatíveis: China (Shanghai), China (Beijing), China (Hangzhou), China (Shenzhen), EUA (Silicon Valley), Singapura.
Substitua todos os espaços reservados nos exemplos de parâmetros, como [your-bucket], [your-region-id], [your-file-name], [your-file-path] e IDs de ativos de mídia (por exemplo, "**9d46c8b4548681030f6e**"), pelos valores reais.

Observações de uso

Chame a API AddTemplate para crie um modelo personalizado do Bulk Video Creator. Para obter detalhes sobre os parâmetros da API, consulte a seção AddTemplate abaixo.
Para recuperar um modelo específico, chame a API GetTemplate.
Para listar modelos, chame a API ListTemplates.

AddTemplate

Parâmetro	Tipo	Descrição	Exemplo	Obrigatório
Name	String	Nome do modelo	batch-editing-template-1	Não
Type	String	Tipo do modelo. Para o Bulk Video Creator, este valor deve ser `BatchEditing`.	BatchEditing	Sim
Config	JSON	Parâmetros de configuração do modelo	Consulte Config em Exemplos de parâmetros.	Sim

Config

Parâmetro	Tipo	Descrição	Exemplo	Obrigatório
InputTemplateConfig	JSON	Define parâmetros como adesivos, música de fundo e imagens de fundo.	Consulte InputTemplateConfig em Exemplos de parâmetros.	Não
EditingTemplateConfig	JSON	Especifica parâmetros de edição, incluindo títulos, narrações, música de fundo e imagens de fundo.	Consulte EditingTemplateConfig em Exemplos de parâmetros.	Não
OutputTemplateConfig	JSON	Determina as configurações de saída, como resolução e parâmetros do fluxo de vídeo.	Consulte OutputTemplateConfig em Exemplos de parâmetros.	Sim

InputTemplateConfig

Parâmetro	Tipo	Descrição	Exemplo	Obrigatório
StickerArray	List<Sticker>	Marcas d'água ou logotipos a adicionar. Para formatos compatíveis, consulte Formatos de imagem.	[{"MediaId":"9d46c8b4548681030f6e","X":10,"Y":100,"Width":300,"Height":300,"Opacity":0.6}]	Não
BackgroundMusicArray	List<String>	Música de fundo. Aceita ID de ativo de mídia ou URL do OSS. Para formatos compatíveis, consulte Formatos de áudio.	["b4549d46c88681030f6e","549d46c88b4681030f6e****"]	Não
BackgroundImageArray	List<String>	Imagem de fundo. Aceita ID de ativo de mídia ou URL do OSS. Para formatos compatíveis, consulte Formatos de imagem.	["b4549d46c88681030f6e","549d46c88b4681030f6e****"]	Não

EditingTemplateConfig

Parâmetro	Tipo	Descrição	Exemplo	Obrigatório
TitleConfig	JSON	Configuração de título. Permite definir parâmetros de legenda.	Consulte Exemplo de TitleConfig.	Não
SubHeadingConfig	JSON	Configuração de subtítulos multinível. Permite definir parâmetros de legenda. Campos JSON: chave: Level valor: Text	{"1":{"Y":0.3,"FontSize":40},"3":{"Y":0.5,"FontSize":30}}	Não
SpeechConfig	JSON	Configuração do roteiro de narração. Importante O modelo não permite configurar o parâmetro Parâmetros públicos de produção de vídeo em lote.	Consulte Exemplo de SpeechConfig.	Não
BackgroundMusicConfig	JSON	Configuração da música de fundo.	Consulte Exemplo de BackgroundMusicConfig.	Não
BackgroundImageConfig	JSON	Configuração da imagem de fundo. Ignorado se já houver uma imagem de fundo definida no InputTemplateConfig.	Consulte Exemplo de BackgroundImageConfig.	Não
FECanvas	JSON	Configuração da tela para visualizações na página front-end.	{"Width": 1080,"Height": 1920}	Não

FECanvas

Nota

Para migrar estilos de um modelo comum para um modelo do Bulk Video Creator, copie o parâmetro FECanvas e a configuração de estilo de títulos e legendas do modelo comum. Em seguida, atribua-os aos parâmetros TitleConfig, SpeechConfig.AsrConfig e FECanvas. Isso garante que os tamanhos das legendas na visualização correspondam à saída final.

Parâmetro	Tipo	Descrição	Exemplo	Obrigatório
Width	Integer	Largura da tela. Unidade: pixel.	450	Sim
Height	Integer	Altura da tela. Unidade: pixel.	800	Sim

OutputTemplateConfig

Parâmetro	Tipo	Descrição	Exemplo	Obrigatório
Width	Integer	Largura de saída. Unidade: pixel.	1920	Sim
Height	Integer	Altura de saída. Unidade: pixel.	1080	Sim
Video	JSONObject	Configuração do fluxo de vídeo de saída, incluindo Crf e Codec.	{"Crf": 27}	Não

Exemplos de parâmetros

{
  "Name": "batch-editing-template-1",
  "Type": "BatchEditing",
  "Config": {
    "InputTemplateConfig": {
      "BackgroundImageArray": [
        "https://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name].png"
      ],
      "BackgroundMusicArray": [
        "icepublic-0c4475c3936f3a8743850f2da942ceee"
      ],
      "StickerArray": [
        {
          "MediaURL": "https://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name].jpeg",
          "X": 0.1,
          "Y": 0.1,
          "Width": 0.1,
          "Height": 0.1
        }
      ]
    },
    "EditingTemplateConfig": {
      "TitleConfig": {
        "Y": 0.7
      },
      "SpeechConfig": {
        "Voice": "zhifei",
        "AsrConfig": {
          "Y": 0.9
        }
      }
    },
    "OutputTemplateConfig": {
      "Width": 1080,
      "Height": 1920
    }
  }
}