SubmitFpShotJob - - Centre de documentation Alibaba Cloud

Description de l'opération

Utilisez cette opération pour soumettre des tâches d'analyse ADN de vidéos, d'audios, d'images et de textes.
Il s'agit d'une API asynchrone. Après la soumission d'une tâche, l'opération renvoie un identifiant de tâche. Le service place ensuite la tâche en file d'attente pour un traitement en arrière-plan. Une fois la tâche terminée, ApsaraVideo Media Processing envoie une notification de rappel avec les résultats. Vous pouvez également appeler l'opération QueryFpShotJob pour vérifier l'état de la tâche.
Les fonctionnalités d'analyse ADN sont disponibles dans les régions Chine (Pékin), Chine (Shanghai), Chine (Hangzhou), Asie-Pacifique Sud-Est 1 (Singapour) et Arabie saoudite (Riyad). Le service dans la région Arabie saoudite (Riyad) est exploité par un partenaire. Ces fonctionnalités ne sont pas disponibles dans les autres régions. La fonctionnalité d'analyse ADN de texte n'est prise en charge que dans la région Chine (Shanghai).
Les formats de fichiers d'entrée suivants sont pris en charge :
- Formats d'image : JPEG, PNG et BMP.
- Formats vidéo : MP4, AVI, MKV, MPG, TS, MOV, FLV et MXF.
- Codecs vidéo : MPEG-2, MPEG-4, H.264, HEVC et WMV.
Pour l'analyse ADN de texte, la bibliothèque ADN ne prend en charge que les longues chaînes de texte ajoutées avec TextType défini sur Text. L'entrée de recherche doit être un résultat de reconnaissance automatique de la parole (ASR) avec TextType défini sur ASR. Le résultat ASR doit être un tableau JSON d'objets contenant les champs start, end et text.

Limite de QPS

Cette opération est limitée à 100 requêtes par seconde (QPS) par utilisateur. Les appels qui dépassent cette limite sont soumis à une limitation du débit, ce qui peut affecter votre activité. Planifiez vos appels en conséquence. Pour plus d'informations, consultez Limites de QPS.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

mts:SubmitFpShotJob

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Input	string	Oui	Le fichier d'entrée pour la tâche. Vous pouvez spécifier le fichier en utilisant une URL OSS, une URL HTTP ou un élément média ApsaraVideo VOD. URL OSS : une chaîne JSON contenant le triplet OSS. Exemple : `{"Bucket":"test-bucket","Location":"oss-cn-shanghai","Object":"test.mp4"}` URL HTTP : une URL accessible publiquement. Exemple : `http://example-test-**.mp4`. Élément média ApsaraVideo VOD : une chaîne JSON contenant l'identifiant de l'élément média. Exemple : `{"MediaId":"99238321"}` Remarque* La région du compartiment OSS et la région de stockage de l'élément média doivent être identiques à la région dans laquelle vous utilisez le service ApsaraVideo Media Processing.	{"Bucket":"example-bucket-**","Location":"oss-cn-shanghai","Object":"example-**.flv"}
PipelineId	string	Non	L'identifiant du pipeline utilisé pour les notifications de messages. Vous pouvez trouver l'identifiant du pipeline sous Paramètres globaux > Pipelines dans la console ApsaraVideo Media Processing.	88c6ca184c0e47098a5b665e2a12****
FpShotConfig	string	Oui	Les configurations de la tâche d'ADN vidéo. La valeur doit être un objet JSON. Pour plus d'informations, consultez FpShotConfig.	{ "PrimaryKey": "12345**", "SaveType": "save", "FpDBId": "417f2ada5999daf**" }
UserData	string	Non	Les données définies par l'utilisateur. La valeur peut comporter jusqu'à 128 octets et ne peut pas commencer par un caractère spécial.	testid-****

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	25818875-5F78-4A13-BEF6-D7393642CA58
JobId	string	L'identifiant de la tâche d'ADN vidéo. Nous vous recommandons d'enregistrer cet identifiant pour les appels ultérieurs aux opérations associées.	2a0697e35a7342859f733a9190c4****

Paramètres de notification asynchrone

Paramètre	Type	Description
Type	String	Le type de message.
FpShotJobNotify	AliyunFpShotJobNotify	Une tâche d'ADN vidéo. Pour plus d'informations, consultez le type de données AliyunFpShotJobNotify.
UserData	String	Les données définies par l'utilisateur.

Exemples

JSON format

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

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.