SubmitFpShotJob - ApsaraVideo Media Processing: Central de Documentação do Alibaba Cloud

Descrição da operação

Use esta operação para enviar trabalhos de análise de DNA de vídeo, áudio, imagem e texto.
Esta é uma API assíncrona. Após enviar um trabalho, a operação retorna um ID de trabalho. O serviço então coloca o trabalho na fila para processamento em segundo plano. Quando o trabalho é concluído, o ApsaraVideo Media Processing envia uma notificação de callback com os resultados. Você também pode chamar a operação QueryFpShotJob para verificar o status do trabalho.
Os recursos de análise de DNA estão disponíveis nas regiões China (Pequim), China (Xangai), China (Hangzhou), Ásia-Pacífico SE 1 (Singapura) e Arábia Saudita (Riade). O serviço na região da Arábia Saudita (Riade) é operado por um parceiro. Esses recursos não estão disponíveis em outras regiões. O recurso de análise de DNA de texto é suportado apenas na região da China (Xangai).
Os seguintes formatos de arquivo de entrada são suportados:
- Formatos de imagem: JPEG, PNG e BMP.
- Formatos de vídeo: MP4, AVI, MKV, MPG, TS, MOV, FLV e MXF.
- Codecs de vídeo: MPEG-2, MPEG-4, H.264, HEVC e WMV.
Para análise de DNA de texto, a biblioteca de DNA suporta apenas strings de texto longas que são adicionadas com TextType definido como Text. A entrada de pesquisa deve ser um resultado de Reconhecimento Automático de Fala (ASR) com TextType definido como ASR. O resultado do ASR deve ser uma matriz JSON de objetos que contenham os campos start, end e text.

Limite de QPS

Esta operação é limitada a 100 consultas por segundo (QPS) por usuário. Chamadas que excedem esse limite estão sujeitas a limitação de taxa, o que pode afetar seus negócios. Planeje suas chamadas de acordo. Para mais informações, consulte Limites de QPS.

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

mts:SubmitFpShotJob

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Input	string	Sim	O arquivo de entrada para o trabalho. Você pode especificar o arquivo usando uma URL do OSS, uma URL HTTP ou um ativo de mídia do ApsaraVideo VOD. URL do OSS: uma string JSON que contém a tríade do OSS. Exemplo: `{"Bucket":"test-bucket","Location":"oss-cn-shanghai","Object":"test.mp4"}` URL HTTP: uma URL publicamente acessível. Exemplo: `http://example-test-**.mp4`. Ativo de mídia do ApsaraVideo VOD: uma string JSON que contém o ID do ativo de mídia. Exemplo: `{"MediaId":"99238321"}` Nota* A região do bucket do OSS e a região de armazenamento do ativo de mídia devem ser iguais à região onde você usa o serviço ApsaraVideo Media Processing.	{"Bucket":"example-bucket-**","Location":"oss-cn-shanghai","Object":"example-**.flv"}
PipelineId	string	Não	O ID do pipeline usado para notificações de mensagens. Você pode encontrar o ID do pipeline em Configurações globais > Pipelines no console do ApsaraVideo Media Processing.	88c6ca184c0e47098a5b665e2a12****
FpShotConfig	string	Sim	As configurações do trabalho de DNA de vídeo. O valor deve ser um objeto JSON. Para mais informações, consulte FpShotConfig.	{ "PrimaryKey": "12345**", "SaveType": "save", "FpDBId": "417f2ada5999daf**" }
UserData	string	Não	Os dados definidos pelo usuário. O valor pode ter até 128 bytes de comprimento e não pode começar com um caractere especial.	testid-****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	25818875-5F78-4A13-BEF6-D7393642CA58
JobId	string	O ID do trabalho de DNA de vídeo. Recomendamos que você salve este ID para chamadas subsequentes às operações relacionadas.	2a0697e35a7342859f733a9190c4****

Parâmetros de notificação assíncrona

Parâmetro	Tipo	Descrição
Type	String	O tipo da mensagem.
FpShotJobNotify	AliyunFpShotJobNotify	Um trabalho de DNA de vídeo. Para mais informações, consulte o tipo de dados AliyunFpShotJobNotify.
UserData	String	Os dados definidos pelo usuário.

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "JobId": "2a0697e35a7342859f733a9190c4****"
}

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.