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

Obtém informações detalhadas sobre trabalhos em lote de Edição de Vídeo Inteligente com Um Clique, incluindo os parâmetros de entrada, o status do trabalho e os IDs e URLs dos ativos de mídia gerados. Esta API suporta a consulta de dados de trabalhos apenas do último ano.

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

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
JobId	string	Não	O ID do trabalho de produção rápida de vídeo.	**b4549d46c88681030f6e**

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	**36-3C1E-4417-BDB2-1E034F**
EditingBatchJob	object	As informações sobre o trabalho de produção rápida de vídeo.
JobId	string	O ID do trabalho.	**b6b2750d4308892ac3330238**
InputConfig	string	As configurações de entrada. Para mais informações, consulte InputConfig.	{ "MediaGroupArray": [{ "GroupName": "MediaGroup1", "MediaArray": [ "**9d46c886b45481030f6e", "6c886b4549d481030f6e" ] }, { "GroupName": "MediaGroup2", "MediaArray": [ "d46c886810b454930f6e", "4549d886810b46c30f6e**" ] }], "TitleArray": [ "回龙观盒马鲜生开业啦", "盒马鲜生开业啦" ], "SpeechTextArray": [ "附近的商场新开了一家盒马鲜生，今天是第一天开业" "商场里的人不少，零食、酒水都比较便宜大家也快来看看呀" ] }
EditingConfig	string	As configurações de edição. Para mais informações, consulte EditingConfig.	{ "MediaConfig": { "Volume": 0 }, "SpeechConfig": { "Volume": 1 }, "BackgroundMusicConfig": { "Volume": 0.3 } }
OutputConfig	string	As configurações de saída. Para mais informações, consulte OutputConfig.	{ "MediaURL": "http://xxx.oss-cn-shanghai.aliyuncs.com/xxx_{index}.mp4", "Count": 20, "MaxDuration": 15, "Width": 1080, "Height": 1920, "Video": {"Crf": 27} }
Status	string	O status do trabalho. Valores válidos: Init: O trabalho foi inicializado. Processing: O trabalho está em andamento. Finished: O trabalho foi concluído.	Finished
UserData	string	Os dados definidos pelo usuário, incluindo as configurações de negócios e de callback. Para mais informações, consulte UserData.	{"NotifyAddress":"http://xx.xx.xxx"}
Extend	string	As informações estendidas. Este parâmetro contém os seguintes campos: ErrorCode: o código de erro do trabalho principal. ErrorMessage: a mensagem de erro do trabalho principal.	{ "ErrorCode": "InvalidMaterial.NotFound", "ErrorMessage": "The specified clips id not found:[\"**30d0b5e871eebb2ff7f6c75a**\"]" }
CreateTime	string	A hora em que o trabalho foi criado. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2024-06-13T08:47:07Z
ModifiedTime	string	A hora em que o trabalho foi modificado pela última vez. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2024-06-13T08:57:07Z
CompleteTime	string	A hora em que o trabalho foi concluído. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2024-06-13T08:57:07Z
JobType	string	O tipo de trabalho: Script (Edição de vídeo automatizada com base em script) Smart_Mix (Correspondência inteligente de texto para mídia para edição de vídeo) Sports_Highlights (Compilação de destaques de eventos esportivos) Screen_Media_Highlights (Edição de mashup de multimídia de alta energia) Smart_Mix_Media_Select (Correspondência inteligente – Seleção de material) Smart_Mix_Timeline_Organize (Correspondência inteligente – Orquestração de linha do tempo) Screen_Media_Highlights_Media_Select (Mashup de alta energia – Seleção de material) Screen_Media_Highlights_Timeline_Organize (Mashup de alta energia – Orquestração de linha do tempo) Scene_Batch_Editing (Síntese em lote em várias linhas do tempo)	Script
SubJobList	array<object>	Os subtrabalhos de produção rápida de vídeo.
	object	As informações sobre o subtrabalho de produção rápida de vídeo.
MediaId	string	The ID of the output media asset.	**1470b11171ee9d19e7e6c66a**
JobId	string	The subjob ID.	**8e81933d44e3ae69e2f81485**
MediaURL	string	The URL of the output file.	http:/xxx.oss-cn-shanghai.aliyuncs.com/xxx_0.mp4
Status	string	The subjob state. Valid values: Init: The subjob is initialized. Processing: The subjob is in progress. Success: The subjob is successful. Failed: The subjob failed.	Success
ErrorCode	string	The error code that is returned if the subjob failed. This parameter is not returned if the subjob is successful.	InvalidMaterial.NotFound
ErrorMessage	string	The error message that is returned if the subjob failed. This parameter is not returned if the subjob is successful.	The specified clips id not found:["**30d0b5e871eebb2ff7f6c75a**"]
ProjectId	string	The ID of the online editing project.	**7cc47fe04eaa81bd853acb6a**
Duration	number	The duration of the output video, in seconds (s).	24.5
ExtendInput	string	A entrada adicional. Quando JobType é Smart_Mix_Timeline_Organize ou Screen_Media_Highlights_Timeline_Organize, a entrada adicional é o resultado da seleção de material. Quando JobType é Scene_Batch_Editing, a entrada adicional é uma lista de IDs de projetos de edição de vídeo.	["**7cc47fe04eaa81bd853acb6a", "04eaa7cc47fe81bd853acb6a**"]
ExtendOutput	string	As saídas adicionais. Quando JobType é Smart_Mix_Media_Select ou Screen_Media_Highlights_Media_Select, os resultados da seleção de material também são retornados.	{ "textMatchMediaOutputList": [{ "textMatchMediaSentenceOutputList": [{ "duration": 3.366667, "matchClipList": [{ "clipId": "null-2", "endTime": 11.16, "mediaId": "**a0900f5071efbf1ce7e6c66a", "score": -0.253, "startTime": 8.04 }], "text": "A new Freshippo store just opened at the nearby mall.", "textId": "0" }, { "duration": 1.566667, "matchClipList": [{ "clipId": "null-1", "endTime": 1.54, "mediaId": "a0900f5071efbf1ce7e6c66a**", "score": -0.2326, "startTime": 0 }], "text": "today Yesfirst day of opening", "textId": "0" } ] }] }

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "EditingBatchJob": {
    "JobId": "****b6b2750d4308892ac3330238****",
    "InputConfig": "{\n  \"MediaGroupArray\": [{\n      \"GroupName\": \"MediaGroup1\",\n      \"MediaArray\": [\n        \"****9d46c886b45481030f6e****\",\n        \"****6c886b4549d481030f6e****\" ]\n    }, {\n      \"GroupName\": \"MediaGroup2\",\n      \"MediaArray\": [\n        \"****d46c886810b454930f6e****\",\n        \"****4549d886810b46c30f6e****\" ]\n  }],\n  \"TitleArray\": [\n      \"回龙观盒马鲜生开业啦\",\n      \"盒马鲜生开业啦\" ],\n  \"SpeechTextArray\": [\n      \"附近的商场新开了一家盒马鲜生，今天是第一天开业\"\n      \"商场里的人不少，零食、酒水都比较便宜大家也快来看看呀\" ]\n}",
    "EditingConfig": "{\n  \"MediaConfig\": {\n      \"Volume\": 0\n  },\n  \"SpeechConfig\": {\n      \"Volume\": 1\n  },\n \"BackgroundMusicConfig\": {\n      \"Volume\": 0.3\n  }\n}",
    "OutputConfig": "{\n  \"MediaURL\": \"http://xxx.oss-cn-shanghai.aliyuncs.com/xxx_{index}.mp4\",\n  \"Count\": 20,\n  \"MaxDuration\": 15,\n  \"Width\": 1080,\n  \"Height\": 1920,\n  \"Video\": {\"Crf\": 27}\n}",
    "Status": "Finished",
    "UserData": "{\"NotifyAddress\":\"http://xx.xx.xxx\"}",
    "Extend": "{\n\t\"ErrorCode\": \"InvalidMaterial.NotFound\",\n\t\"ErrorMessage\": \"The specified clips id not found:[\\\"****30d0b5e871eebb2ff7f6c75a****\\\"]\"\n}",
    "CreateTime": "2024-06-13T08:47:07Z",
    "ModifiedTime": "2024-06-13T08:57:07Z\n",
    "CompleteTime": "2024-06-13T08:57:07Z\n",
    "JobType": "Script",
    "SubJobList": [
      {
        "MediaId": "****1470b11171ee9d19e7e6c66a****",
        "JobId": "****8e81933d44e3ae69e2f81485****",
        "MediaURL": "http:/xxx.oss-cn-shanghai.aliyuncs.com/xxx_0.mp4",
        "Status": "Success",
        "ErrorCode": "InvalidMaterial.NotFound",
        "ErrorMessage": "The specified clips id not found:[\"****30d0b5e871eebb2ff7f6c75a****\"]",
        "ProjectId": "****7cc47fe04eaa81bd853acb6a****",
        "Duration": 24.5
      }
    ],
    "ExtendInput": "[\"****7cc47fe04eaa81bd853acb6a****\", \"****04eaa7cc47fe81bd853acb6a****\"]",
    "ExtendOutput": "{\n\"textMatchMediaOutputList\": [{\n\"textMatchMediaSentenceOutputList\": [{\n\"duration\": 3.366667,\n\"matchClipList\": [{\n\"clipId\": \"null-2\",\n\"endTime\": 11.16,\n\"mediaId\": \"****a0900f5071efbf1ce7e6c66a****\",\n\"score\": -0.253,\n\"startTime\": 8.04\n}],\n\"text\": \"A new Freshippo store just opened at the nearby mall.\",\n\"textId\": \"0\"\n},\n{\n\"duration\": 1.566667,\n\"matchClipList\": [{\n\"clipId\": \"null-1\",\n\"endTime\": 1.54,\n\"mediaId\": \"****a0900f5071efbf1ce7e6c66a****\",\n\"score\": -0.2326,\n\"startTime\": 0\n}],\n\"text\": \"today Yesfirst day of opening\",\n\"textId\": \"0\"\n}\n]\n}]\n}"
  }
}

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.