Envia um job de análise de fingerprint de mídia para pesquisar, em uma biblioteca de fingerprints, arquivos de mídia com fingerprints idênticos ou semelhantes aos de um arquivo de entrada.
Observações de uso
Use esta operação para enviar jobs de análise de fingerprint de vídeo ou texto.
Esta operação envia o job de forma assíncrona. Os resultados da consulta podem não estar disponíveis quando a resposta for retornada. Após a geração dos resultados, o sistema retorna uma mensagem assíncrona.
-
Jobs de análise de fingerprint de texto estão disponíveis apenas na região China (Shanghai). O arquivo de entrada deve ter um dos seguintes formatos:
Formatos de imagem: JPEG, PNG e BMP.
Formatos de vídeo: MP4, AVI, MKV, MPG, TS, MOV, FLV, MXF.
Formatos de codificação de vídeo: MPEG2, MPEG4, H264, HEVC e WMV.
Limite de QPS
Cada conta pode chamar esta operação até 150 vezes por segundo. Se a quantidade de chamadas por segundo ultrapassar esse limite, o sistema ativa o throttling, o que pode afetar seus serviços. Recomendamos observar esse limite ao utilizar esta operação. Para mais informações, consulte Limite de QPS.
Depuração
Parâmetros da requisição
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| Action | String | Sim | SubmitFpShotJob | A operação a ser executada. Defina o valor como SubmitFpShotJob. |
| Input | String | Sim | {"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"} | URL do Object Storage Service (OSS) da entrada do job. O valor é um objeto JSON. Consulte a URL do OSS no console do OSS ou do ApsaraVideo Media Processing (MPS). Para mais informações, veja a seção "InputFile" do tópico Detalhes dos parâmetros. Nota O bucket do OSS deve residir na mesma região especificada para o MPS. |
| PipelineId | String | Não | 88c6ca184c0e47098a5b665e2a12**** | ID da fila do MPS. Este ID associa o job a um método de notificação. Para visualizar o ID da fila do MPS, faça login no MPS console e escolha Global Settings > Pipelines no painel de navegação à esquerda. |
| FpShotConfig | String | Sim | {"PrimaryKey":"12345****", "SaveType": "save"} | Configurações do job de análise de fingerprint de mídia. O valor é um objeto JSON. Para mais informações, veja a seção "FpShotConfig" do tópico Detalhes dos parâmetros. |
| UserData | String | Não | testid-**** | Dados personalizados. O valor pode ter até 128 bytes e não pode começar com um caractere especial. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
RequestId |
String |
25818875-5F78-4A13-BEF6-D7393642CA58 |
ID da requisição. |
|
JobId |
String |
2a0697e35a7342859f733a9190c4**** |
ID do job de análise de fingerprint de mídia. Recomendamos guardar este ID para chamadas de operações subsequentes. |
Parâmetros de notificação assíncrona
|
Parâmetro |
Tipo |
Descrição |
|
Type |
String |
Tipo da mensagem. |
|
FpShotJobNotify |
AliyunFpShotJobNotify |
Notificação dos resultados do job de análise de fingerprint de mídia. Para mais informações, veja a seção "AliyunFpShotJobNotify" do tópico Tipos de dados. |
|
UserData |
String |
Dados personalizados. |
Exemplos
Exemplos de requisições
http(s)://mts.cn-shanghai.aliyuncs.com/?Action=SubmitFpShotJob
&Input={"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"}
&PipelineId=88c6ca184c0e47098a5b665e2a12****
&FpShotConfig={"PrimaryKey":"12345****", "SaveType": "save"}
&UserData=testid-****
&<Common request parameters>Exemplos de respostas de sucesso
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<SubmitFpShotJobResponse>
<RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
<JobId>2a0697e35a7342859f733a9190c4****</JobId>
</SubmitFpShotJobResponse>Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "25818875-5F78-4A13-BEF6-D7393642CA58",
"JobId" : "2a0697e35a7342859f733a9190c4****"
}Códigos de erro
Para obter uma lista de códigos de erro, visite o API Error Center.