Soumettez une tâche d'analyse d'empreintes multimédias pour rechercher, dans une bibliothèque d'empreintes, des fichiers multimédias présentant des empreintes identiques ou similaires à celles d'un fichier multimédia d'entrée.
Notes d'utilisation
Appelez cette opération pour soumettre une tâche d'analyse d'empreintes vidéo ou textuelles.
Cette opération soumet la tâche de manière asynchrone. Les résultats de la requête peuvent ne pas être générés au moment du renvoi de la réponse. Une fois les résultats générés, un message asynchrone est renvoyé.
-
Vous pouvez soumettre une tâche d'analyse d'empreintes textuelles uniquement dans la région Chine (Shanghai). Le fichier d'entrée de la tâche doit respecter l'un des formats suivants :
Formats d'image : JPEG, PNG et BMP.
Formats vidéo : MP4, AVI, MKV, MPG, TS, MOV, FLV, MXF.
Formats d'encodage vidéo : MPEG2, MPEG4, H264, HEVC et WMV.
Limite de QPS
Vous pouvez appeler cette opération jusqu'à 150 fois par seconde par compte. Si le nombre d'appels par seconde dépasse cette limite, une limitation du débit est déclenchée, ce qui peut affecter votre activité. Nous vous recommandons de prendre en compte cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la rubrique Limite de QPS.
Débogage
Paramètres de requête
| Paramètre | Type | Obligatoire | Exemple | Description |
| Action | String | Oui | SubmitFpShotJob | Opération à effectuer. Définissez la valeur sur SubmitFpShotJob. |
| Input | String | Oui | {"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"} | URL Object Storage Service (OSS) de l'entrée de la tâche. La valeur est un objet JSON. Vous pouvez consulter l'URL OSS dans la console OSS ou MPS (ApsaraVideo Media Processing). Pour plus d'informations, reportez-vous à la section « InputFile » de la rubrique Détails des paramètres. Remarque Le bucket OSS doit se trouver dans la même région que la région MPS spécifiée. |
| PipelineId | String | Non | 88c6ca184c0e47098a5b665e2a12**** | ID de la file d'attente MPS. Cet ID permet d'associer la tâche à une méthode de notification. Pour afficher l'ID de la file d'attente MPS, connectez-vous à la console MPS et choisissez Global Settings > Pipelines dans le volet de navigation de gauche. |
| FpShotConfig | String | Oui | {"PrimaryKey":"12345****", "SaveType": "save"} | Configuration de la tâche d'analyse d'empreintes multimédias. La valeur est un objet JSON. Pour plus d'informations, reportez-vous à la section « FpShotConfig » de la rubrique Détails des paramètres. |
| UserData | String | Non | testid-**** | Données personnalisées. La valeur peut atteindre 128 octets et ne doit pas commencer par un caractère spécial. |
Paramètres de réponse
|
Paramètre |
Type |
Exemple |
Description |
|
RequestId |
String |
25818875-5F78-4A13-BEF6-D7393642CA58 |
ID de la requête. |
|
JobId |
String |
2a0697e35a7342859f733a9190c4**** |
ID de la tâche d'analyse d'empreintes multimédias. Nous vous recommandons de conserver cet ID pour les appels d'opérations ultérieurs. |
Paramètres de notification asynchrone
|
Paramètre |
Type |
Description |
|
Type |
String |
Type du message. |
|
FpShotJobNotify |
AliyunFpShotJobNotify |
Notification des résultats de la tâche d'analyse d'empreintes multimédias. Pour plus d'informations, reportez-vous à la section « AliyunFpShotJobNotify » de la rubrique Types de données. |
|
UserData |
String |
Données personnalisées. |
Exemples
Exemples de requêtes
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>Exemples de réponses réussies
Format XML
HTTP/1.1 200 OK
Content-Type:application/xml
<SubmitFpShotJobResponse>
<RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
<JobId>2a0697e35a7342859f733a9190c4****</JobId>
</SubmitFpShotJobResponse>Format JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "25818875-5F78-4A13-BEF6-D7393642CA58",
"JobId" : "2a0697e35a7342859f733a9190c4****"
}Codes d'erreur
Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.