SubmitSmarttagJob - - Centre de documentation Alibaba Cloud

Soumet une tâche de balisage intelligent.

Description de l'opération

Prérequis

Avant de soumettre une tâche de balisage intelligent, vous devez configurer les types d'analyse dans un modèle. Pour plus d'informations, consultez CreateCustomTemplate.

Limites

La fonctionnalité de balisage intelligent n'est disponible que dans les régions Chine (Pékin), Chine (Shanghai) et Chine (Hangzhou).
La concurrence par défaut pour le pipeline de balisage intelligent est de 2. Pour demander une limite de concurrence plus élevée, soumettez un ticket.
Les tâches de balisage intelligent et leurs résultats sont conservés pendant 180 jours, après quoi ils sont automatiquement supprimés.

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.

ice:SubmitSmarttagJob

create

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Title	string	Non	Le titre de la vidéo peut contenir des caractères chinois, des lettres anglaises, des chiffres et des traits d'union (-). Il ne peut pas commencer par un caractère spécial et ne doit pas dépasser 256 octets.	example-title-****
Content	string	Non	La description du contenu vidéo peut contenir des caractères chinois, des lettres anglaises, des chiffres et des traits d'union (-). Elle ne peut pas commencer par un caractère spécial et ne doit pas dépasser 1 Ko.	example content ****
ContentType	string	Non	Obsolète.
ContentAddr	string	Non	Obsolète.
Params	string	Non	Paramètres de requête supplémentaires, spécifiés sous forme de chaîne JSON. Par exemple : `{"needAsrData":true, "needOcrData":false}`. `needAsrData` : Indique si les résultats bruts de la reconnaissance automatique de la parole (ASR) doivent être inclus dans la sortie d'analyse. La valeur par défaut est `false`. `needOcrData` : Indique si les résultats bruts de la reconnaissance optique de caractères (OCR) doivent être inclus dans la sortie d'analyse. La valeur par défaut est `false`. `needMetaData` : Indique si les métadonnées doivent être incluses dans la sortie d'analyse. La valeur par défaut est `false`. `nlpParams` : Un objet JSON qui spécifie les paramètres d'entrée pour l'opérateur de traitement du langage naturel (NLP). S'il est laissé vide, l'opérateur n'est pas utilisé. Pour plus de détails, consultez le tableau `nlpParams` ci-dessous.	{"needAsrData":true, "needOcrData":false, "nlpParams":{"sourceLanguage":"cn"}}
NotifyUrl	string	Non	L'URL de rappel. Seules les URL HTTP et HTTPS sont prises en charge.	https://example.com/endpoint/aliyun/ai?id=76401125000***
UserData	string	Non	Données personnalisées à inclure dans le rappel. Si vous utilisez Message Service (MNS) pour les rappels, ces données sont incluses dans le message. La longueur maximale est de 1 Ko.	{“a”:"test"}
Input	object	Non	Le fichier d'entrée pour la tâche.
Type	string	Non	Le type du fichier multimédia d'entrée. Valeurs valides : OSS Media URL	Media
Media	string	Non	Si vous définissez le paramètre `Type` sur `OSS`, spécifiez l'URL OSS du fichier multimédia. Exemple : `OSS://test-bucket/video/202208/test.mp4`. Si vous définissez le paramètre `Type` sur `Media`, spécifiez l'identifiant du média. Exemple : `c5c62d8f0361337cab312dce8e77dc6d`. Si vous définissez le paramètre `Type` sur `URL`, spécifiez l'URL HTTP ou HTTPS du fichier multimédia. Exemple : `https://zc-test.oss-cn-shanghai.aliyuncs.com/test/unknowFace.mp4`.	c5c62d8f0361337cab312dce8e77dc6d
TemplateId	string	Non	L'identifiant du modèle qui spécifie les algorithmes d'analyse à utiliser.	39f8e0bc005e4f309379701645f4
ScheduleConfig	object	Non	Les configurations de planification.
PipelineId	string	Non	L'identifiant du pipeline. Les pipelines séparent les charges de travail métier et lient les notifications de messages. Si vous ne spécifiez pas ce paramètre, le pipeline par défaut est utilisé. Le pipeline par défaut a une concurrence de 2. Pour augmenter la concurrence, soumettez un ticket.	acdbfe4323bcfdae
Priority	string	Non	La priorité de la tâche. Cette fonctionnalité n'est pas encore implémentée. Vous pouvez laisser ce paramètre vide ou spécifier n'importe quelle valeur.	4
TemplateConfig	string	Non	Paramètres dynamiques pour la tâche, qui remplacent ou complètent temporairement le modèle de base spécifié par `TemplateId`. Le service fusionne les paramètres dynamiques et du modèle pour générer la configuration finale pour la tâche en cours et la valide avant l'exécution. Règles de fusion : Les valeurs de la requête remplacent les valeurs correspondantes dans le modèle. Les champs de la requête qui n'existent pas dans le modèle sont ajoutés à la configuration. Champs dynamiques actuellement pris en charge : `FaceCategoryIds` : Une liste d'identifiants de bibliothèques de visages pour la reconnaissance, séparés par des virgules (,). Vous pouvez inclure à la fois des identifiants de bibliothèques système et personnalisées. Remarque : Ces paramètres dynamiques n'affectent que la tâche en cours et ne modifient pas le modèle lui-même.	{"FaceCategoryIds":"custom_face_lib1"}

nlpParams

Fonctionnalité	Paramètre	Type	Obligatoire	Description	Exemple
	nlpParams	object	Oui	Contient tous les paramètres liés au traitement NLP. Ce paramètre est obligatoire si les types d'analyse dans le modèle incluent le NLP. Sinon, la tâche échoue.	{"sourceLanguage":"cn"}
Transcription	sourceLanguage	string	Oui	Le modèle de langue source pour la transcription. Valeurs valides : `cn` (chinois), `en` (anglais), `yue` (cantonais), `fspk` (mélange de chinois et d'anglais) et `ja` (japonais). Si l'audio contient plusieurs langues, vous pouvez définir ce paramètre sur `multilingual` pour reconnaître le texte dans chaque langue. Utilisez ce paramètre avec `languageHints`. Seul l'audio à 16 kHz est pris en charge.	"cn"
	languageHints	list[string]	Non	Spécifie les langues à reconnaître lorsque `sourceLanguage` est défini sur `multilingual`. Valeurs valides (plusieurs peuvent être sélectionnées) : `cn` (chinois), `en` (anglais), `yue` (cantonais), `ja` (japonais), `ko` (coréen), `de` (allemand), `fr` (français) et `ru` (russe). Ce paramètre restreint la portée de la détection de langue et empêche l'identification erronée de langues non pertinentes. Il ne prend effet que lorsque `sourceLanguage` est défini sur `multilingual`.	['cn', 'en', 'yue']
	transcriptionModel	string	Non	Spécifie le modèle de transcription à utiliser. Valeur valide : `fun-asr`. Ce modèle doit être utilisé avec `sourceLanguage` défini sur `multilingual`.	fun-asr
	diarizationEnabled	boolean	Non	Indique si la diarisation du locuteur doit être activée. La valeur par défaut est `false`.	true
	speakerCount	integer	Non	Configure le nombre de locuteurs pour la diarisation du locuteur. `0` : Le nombre de locuteurs est automatiquement détecté. `2` : Diarise l'audio pour deux locuteurs.	2
Mot-clé	phraseId	string	Non	L'identifiant du vocabulaire des mots-clés.	ce9c2a34b6d847bf92a77d0a196f***
Extraction et synthèse de PPT	pptExtractionEnabled	boolean	Non	Indique si l'extraction et la synthèse de PPT doivent être activées. Si cette option est activée, le service extrait les diapositives PPT de la vidéo et génère un résumé. La valeur par défaut est `false`.	true
Synthèse	summarizationEnabled	boolean	Non	Indique si la synthèse doit être activée. Si cette option est activée, le service peut générer un résumé du texte complet, un résumé par locuteur et d'autres résultats.	true
	summarizationTypes	string	Non	Lorsque la synthèse est activée, vous devez spécifier les types de synthèse souhaités. Valeurs valides : `Paragraph` (résumé du texte complet), `Conversational` (résumé par locuteur), `QuestionsAnswering` (résumé des questions-réponses) et `MindMap` (carte mentale).	"Paragraph,Conversational,QuestionsAnswering,MindMap"
Traduction	translationEnabled	boolean	Non	Indique si la traduction doit être activée.	true
	targetLanguages	string	Non	Les langues cibles pour la traduction. Ce paramètre est obligatoire si la traduction est activée. Valeurs valides : `cn` (chinois), `en` (anglais), `yue` (cantonais) et `fspk` (mélange de chinois et d'anglais).	"en,cn"
Détection de chapitres	autoChaptersEnabled	boolean	Non	Indique si la génération automatique de chapitres doit être activée. La sortie inclut les titres et les résumés des chapitres.	true
Assistance aux réunions	meetingAssistanceEnabled	boolean	Non	Indique si la fonctionnalité d'assistance aux réunions doit être activée. La sortie inclut les catégories, les mots-clés, les phrases clés et les éléments d'action.	true

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	****11-DB8D-4A9A-875B-275798****
JobId	string	L'identifiant de la tâche de balisage intelligent. Conservez cet identifiant pour les appels d'API ultérieurs.	**d80e4e4044975745c14b**

Exemples

JSON format

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "JobId": "****d80e4e4044975745c14b****"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.