AddTemplate - Intelligent Media Services: Central de Documentação do Alibaba Cloud

Cria um modelo.

Descrição da operação

Para mais informações sobre como usar um modelo regular, consulte Criar e usar um modelo regular.
Para mais informações sobre como usar um modelo avançado, consulte Criar e usar modelos avançados.
Após a criação de um modelo avançado, ele entra no estado Processing. Nesse caso, o modelo não está disponível. O modelo só pode ser usado quando estiver no estado Available. O tempo necessário para o processamento do modelo varia de acordo com o tamanho do arquivo do modelo. Geralmente, varia de 10 segundos a 5 minutos.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ice:AddTemplate

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Name	string	Não	O nome do modelo personalizado.	Template name
Type	string	Não	O tipo do modelo. Valores válidos: Timeline: um modelo regular criado com base na timeline de um projeto de edição de vídeo, no qual múltiplos materiais são organizados em sequência em várias camadas. Pode ser usado para converter texto e imagens em vídeos, criar álbuns de fotos, adicionar partes de abertura e encerramento e aplicar a marca d'água padrão. VETemplate: um modelo avançado criado usando efeitos do Adobe After Effects (AE). Pode ser usado para produzir animações complexas e efeitos de mídia avançados. Valores válidos: Timeline : VETemplate :	Timeline
Config	string	Não	As configurações do modelo. O objeto Config de um modelo regular é encapsulado com base no objeto Timeline de um projeto de edição online. O objeto Config de um modelo personalizado oferece recursos mais flexíveis. Se você tiver requisitos especiais, recomendamos que compreenda a estrutura de um objeto Config e configure um modelo personalizado. Para mais informações, consulte Objeto Config de um modelo regular. Para mais informações sobre exemplos de objetos Config, consulte Configurações básicas de modelo.	参见Timeline模板Config文档
CoverUrl	string	Não	A URL da miniatura do modelo.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg
PreviewMedia	string	Não	O ID do vídeo de pré-visualização do modelo.	**01bf24bf41c78b2754cb3187**
Status	string	Não	O estado do modelo. Valores válidos: Available: O modelo está disponível. Created: O modelo foi criado, mas não está pronto para uso. Uploading: O vídeo está sendo carregado. Processing: O modelo avançado está sendo processado. UploadFailed: Falha ao carregar o vídeo. ProcessFailed: Falha ao processar o modelo avançado. Valores válidos: UploadFailed : ProcessFailed : Available : Uploading : Created : Processing :	Available
Source	string	Não	A origem a partir da qual o modelo é criado. Valores válidos: OpenAPI AliyunConsole WebSDK Valores válidos: AliyunConsole : WebSDK : OpenAPI :	OpenAPI
RelatedMediaids	string	Não	Os IDs dos materiais associados ao modelo para uso pelo editor de modelos regulares.	{"video":["1805a0c6ca544fb395a06ca683619655"]}

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	**2876-6263-4B75-8F2C-CD0F7FCF**
Template	object	As informações do modelo.
TemplateId	string	O ID do modelo.	**01bf24bf41c78b2754cb3187**
Name	string	O nome do modelo.	Template name
Type	string	O tipo do modelo. Valores válidos: Timeline: modelo regular. VETemplate: modelo avançado. Valores válidos: Timeline : VETemplate :	Timeline
Config	string	As configurações do modelo.	参见Config文档
CoverUrl	string	A URL da miniatura do modelo.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg
PreviewMedia	string	O ID do vídeo de pré-visualização.	**01bf24bf41c78b2754cb3187**
Status	string	O estado do modelo. Valores válidos: UploadFailed: Falha ao carregar o vídeo. ProcessFailed: Falha ao processar o modelo avançado. Available: O modelo está disponível. Uploading: O vídeo está sendo carregado. Created: O modelo foi criado, mas não está pronto para uso. Processing: O modelo avançado está sendo processado. Valores válidos: UploadFailed : ProcessFailed : Available : Uploading : Created : Processing :	Available
CreateSource	string	A origem a partir da qual o modelo foi criado. Valores válidos: AliyunConsole WebSDK OpenAPI Valores válidos: AliyunConsole : WebSDK : OpenAPI :	OpenAPI
ModifiedSource	string	A origem a partir da qual o modelo foi modificado. Valores válidos: AliyunConsole WebSDK OpenAPI Valores válidos: AliyunConsole : WebSDK : OpenAPI :	OpenAPI

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "****2876-6263-4B75-8F2C-CD0F7FCF****",
  "Template": {
    "TemplateId": "****01bf24bf41c78b2754cb3187****",
    "Name": "Template name",
    "Type": "Timeline",
    "Config": "参见Config文档",
    "CoverUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg",
    "PreviewMedia": "****01bf24bf41c78b2754cb3187****",
    "Status": "Available",
    "CreateSource": "OpenAPI",
    "ModifiedSource": "OpenAPI"
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.