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

Cria um projeto de edição online. Você pode especificar configurações como título, descrição, timeline e thumbnail para o projeto.

Descrição da operação

A cobrança é baseada na duração do vídeo editado. Para mais informações, consulte VideoEditing. Se o processamento falhar, não haverá cobrança.
Após criar o projeto de edição, você pode chamar SubmitMediaProducingJob - Submeter tarefa de composição de edição para submeter uma tarefa de síntese de edição de mídia. Chame SubmitLiveEditingJob - Submeter tarefa de edição ao vivo para submeter uma tarefa de edição ao vivo.

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:CreateEditingProject

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Title	string	Sim	O título do projeto de edição online.	example
Description	string	Não	A descrição do projeto de edição online.	Description
Timeline	string	Não	A timeline do projeto de edição online, no formato JSON.	{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"**4d7cf14dc7b83b0e801c"},{"MediaId":"4d7cf14dc7b83b0e801c**"}]}]}
CoverURL	string	Não	A URL da thumbnail do projeto de edição online.	https://example.com/example.png
TemplateId	string	Não	O ID do modelo. Este parâmetro é usado para construir rapidamente uma timeline com facilidade. Nota: Apenas um entre Timeline e TemplateId pode ser especificado. Se TemplateId for especificado, ClipsParam também deve ser especificado.	**96e8864746a0b6f3**
ClipsParam	string	Não	O parâmetro de material correspondente ao modelo, no formato JSON. Se TemplateId for especificado, ClipsParam também deve ser especificado. Para mais informações.	See the template user guide.
TemplateType	string	Não	O tipo de modelo. Este parâmetro é obrigatório se você criar um projeto de edição online baseado em modelo. Valor padrão: Timeline. Valores válidos: Timeline: um modelo regular. VETemplate: um modelo avançado. Valores válidos: Timeline : VETemplate :	Timeline
MaterialMaps	string	Não	O material associado ao projeto. Separe múltiplos IDs de material com vírgulas (,). Cada tipo suporta até 10 IDs de material.	{"video":"***2e057304fcd9b145c5cafc*", "image":"8021a8d493da643c8acd98*,*cb6307a4edea614d8b3f3c*", "liveStream": "[{\"appName\":\"testrecord\",\"domainName\":\"test.alivecdn.com\",\"liveUrl\":\"rtmp://test.alivecdn.com/testrecord/teststream\",\"streamName\":\"teststream\"}]", "editingProject": "*9b145c5cafc2e057304fcd***"}
BusinessConfig	string	Não	A configuração de negócios do projeto. Este parâmetro pode ser ignorado para projetos de edição gerais. Para um projeto de edição de transmissão ao vivo, observe as seguintes regras: OutputMediaConfig.StorageLocation é obrigatório. OutputMediaConfig.Path é opcional. Se você não especificar esta opção, os clipes de transmissão ao vivo serão armazenados no diretório raiz por padrão. Os valores válidos de OutputMediaTarget incluem vod-media e oss-object. Se você não especificar OutputMediaTarget, o valor padrão oss-object será usado. Se você definir OutputMediaTarget como vod-media, a configuração de OutputMediaConfig.Path não terá efeito.	{ "OutputMediaConfig" : { "StorageLocation": "test-bucket.oss-cn-shanghai.aliyuncs.com", "Path": "test-path" }, "OutputMediaTarget": "oss-object", "ReservationTime": "2021-06-21T08:05:00Z" }
ProjectType	string	Não	O tipo do projeto de edição. Valores válidos: EditingProject e LiveEditingProject. O valor EditingProject indica um projeto de edição regular, e o valor LiveEditingProject indica um projeto de edição de transmissão ao vivo.	LiveEditingProject

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	****3B-0E1A-586A-AC29-742247****
Project	object	As informações sobre o projeto de edição online.
ProjectId	string	O ID do projeto de edição online.	**01bf24bf41c78b2754cb3187**
Title	string	O título do projeto de edição online.	example_title
Description	string	A descrição do projeto de edição online.	example_description
Timeline	string	A timeline do projeto de edição online, no formato JSON. Se você deixar este parâmetro vazio, uma timeline vazia será criada e a duração do projeto de edição online será zero.	{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"**4d7cf14dc7b83b0e801c"},{"MediaId":"4d7cf14dc7b83b0e801c**"}]}]}
TemplateId	string	O ID do modelo.	**96e8864746a0b6f3**
ClipsParam	string	Os parâmetros de material do modelo.	See the template user guide.
CoverURL	string	A URL da thumbnail do projeto de edição online.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
Status	integer	O status do projeto de edição online. Valores válidos: - 1: Draft - 2: Editing - 3: Producing - 4: Produced - 5: ProduceFailed - 7: Deleted	2
StatusName	string	O status do projeto de edição online. Para mais informações, consulte a lista de status.	Editing
CreateTime	string	A hora em que o projeto de edição online foi criado.	2021-01-08T16:52:07Z
ModifiedTime	string	A hora em que o projeto de edição online foi editado pela última vez.	2021-01-08T16:52:07Z
Duration	number	A duração do projeto de edição online.	3.4200000
CreateSource	string	O método de criação do projeto de edição online. Valores válidos: - OpenAPI - AliyunConsole - WebSDK - LiveEditingOpenAPI - LiveEditingConsole	WebSDK
ModifiedSource	string	O método de edição do projeto de edição online. Valores válidos: - OpenAPI - AliyunConsole - WebSDK - LiveEditingOpenAPI - LiveEditingConsole	WebSDK
TemplateType	string	O tipo de modelo do projeto de edição online. Valores válidos: - Timeline - VETemplate	Timeline
BusinessConfig	string	A configuração de negócios do projeto. Este parâmetro pode ser ignorado para projetos de edição gerais.	{ "OutputMediaConfig" : { "StorageLocation": "test-bucket.oss-cn-shanghai.aliyuncs.com", "Path": "test-path" }, "OutputMediaTarget": "oss-object", "ReservationTime": "2021-06-21T08:05:00Z" }
ProjectType	string	O tipo do projeto de edição. Valor padrão: EditingProject. Valores válidos: - EditingProject: um projeto de edição regular. - LiveEditingProject: um projeto de edição de transmissão ao vivo.	LiveEditingProject
BusinessStatus	string	O status de negócios do projeto. Este parâmetro pode ser ignorado para projetos de edição gerais. Valores válidos: Reserving ReservationCanceled BroadCasting LoadingFailed LiveFinished	Reserving

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "Project": {
    "ProjectId": "****01bf24bf41c78b2754cb3187****",
    "Title": "example_title",
    "Description": "example_description",
    "Timeline": "{\"VideoTracks\":[{\"VideoTrackClips\":[{\"MediaId\":\"****4d7cf14dc7b83b0e801c****\"},{\"MediaId\":\"****4d7cf14dc7b83b0e801c****\"}]}]}",
    "TemplateId": "****96e8864746a0b6f3****",
    "ClipsParam": "See the template user guide.",
    "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
    "Status": 2,
    "StatusName": "Editing",
    "CreateTime": "2021-01-08T16:52:07Z",
    "ModifiedTime": "2021-01-08T16:52:07Z",
    "Duration": 3.42,
    "CreateSource": "WebSDK",
    "ModifiedSource": "WebSDK",
    "TemplateType": "Timeline",
    "BusinessConfig": "{ \"OutputMediaConfig\" :    { \"StorageLocation\": \"test-bucket.oss-cn-shanghai.aliyuncs.com\", \"Path\": \"test-path\"   }, \"OutputMediaTarget\": \"oss-object\", \"ReservationTime\": \"2021-06-21T08:05:00Z\" }",
    "ProjectType": "LiveEditingProject",
    "BusinessStatus": "Reserving"
  }
}

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.