CreateHighlightTask - - Centre de documentation Alibaba Cloud

Crée une tâche de mise en évidence vidéo. Cette fonctionnalité est en avant-première sur invitation.

Description de l'opération

Avant d'appeler cette opération, assurez-vous de bien comprendre les méthodes de facturation et la tarification d'Intelligent Media Management (IMM). Des frais sont facturés pour l'extraction des mises en évidence et le traitement des médias.
Avant d'appeler cette opération, assurez-vous qu'un projet disponible existe dans la région actuelle. Pour plus d'informations, consultez Gestion des projets.
Important Les tâches asynchrones ne garantissent pas les délais de traitement.

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.

imm:CreateHighlightTask

create

*Projet.

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

Aucune

Syntaxe de la requête

POST  HTTP/1.1

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ProjectName	string	Oui	Le nom du projet.	immtest
Sources	array<object>	Oui	La liste des ressources multimédias à traiter. Vous pouvez spécifier jusqu'à 10 vidéos.
	object	Non	La ressource multimédia à traiter.
Duration	number	Non	La durée du clip multimédia. Unité : secondes. Valeur par défaut : 0, ce qui indique l'heure de fin de la vidéo. Ce paramètre n'est valide que lorsque Type est défini sur Concat.	0
StartTime	number	Non	L'heure de début de la ressource multimédia. Valeurs valides : [0, durée de la vidéo]. Ce paramètre n'est valide que lorsque Type est défini sur Concat. Unité : secondes.	0
URI	string	Oui	L'URI de la ressource multimédia, qui est une URI OSS. Seules les vidéos sont prises en charge.	oss://test-bucket/test-object
Mode	string	Non	Le mode de reconnaissance des mises en évidence. Valeurs valides : Scene : reconnaissance de scène et de trame Average : reconnaissance de clip moyenne Valeur par défaut : Average.	Average
Type	string	Oui	Le type de traitement. Valeurs valides : Retrieval : extraction des mises en évidence Concat : composition vidéo Compose : création de vidéo en un clic	Retrieval
Highlight	object	Non	La configuration des mises en évidence.
Content	string	Oui	Le contenu de la mise en évidence. Valeurs valides : Pet Person Sports Meeting La valeur ne peut pas dépasser 100 caractères.	character
Edit	object	Non	La configuration de montage.
BackgroundMusicMode	string	Non	Le mode de musique de fond. Valeurs valides : Random : musique de fond personnalisée, sélectionnée aléatoirement en fonction des poids Sequential : musique de fond personnalisée, appliquée en séquence Closed : aucune musique de fond Valeur par défaut : Closed.	Closed
BackgroundMusics	array<object>	Non	La musique de fond. Ce paramètre n'est valide que lorsque BackgroundMusicMode est défini sur Random ou Sequential. Le nombre maximum actuel de pistes de musique de fond est de 1.
	object	Non	La piste de musique de fond.
URI	string	Oui	L'URI de la musique de fond, qui est une URI OSS. Seuls les fichiers audio sont pris en charge.	oss://test-bucket/test-object/test.mp3
Volume	number	Non	Le volume de la musique de fond. Valeurs valides : [0, 10]. Valeur par défaut : 0,2. Une valeur de 1 indique le volume d'origine.	0.2
Mode	string	Oui	Le mode de montage. Valeurs valides : Sequential : mode séquentiel	Sequential
TransitionMode	string	Non	Le mode de transition. Valeurs valides : Auto : transition automatique Random : transition personnalisée, sélectionnée aléatoirement en fonction des poids Sequential : transition personnalisée, appliquée en séquence Closed : aucune transition Valeur par défaut : Closed.	Closed
Transitions	array<object>	Non	Les effets de transition. Ce paramètre n'est valide que lorsque TransitionMode est défini sur Random ou Sequential. Vous pouvez spécifier jusqu'à 10 effets de transition.
	object	Non
Duration	number	Non	La durée de la transition. Unité : secondes. Si la durée de la transition est supérieure à la durée du clip moins 1, l'effet de transition sur le clip ne prend pas effet. Valeurs valides : [0, 5].	0
Transition	string	Oui	L'effet de transition. Pour plus d'informations, consultez Effets de transition.	fade
Weight	integer	Non	Le poids de la transition. Valeurs valides : [1, 100]. Valeur par défaut : 50. Ce paramètre n'est valide que lorsque TransitionMode est défini sur Random.	50
VfxEffectMode	string	Non	Le mode d'effet visuel. Valeurs valides : Auto : effet visuel automatique Random : effet visuel personnalisé, sélectionné aléatoirement en fonction des poids Sequential : effet visuel personnalisé, appliqué en séquence Closed : aucun effet visuel Valeur par défaut : Closed.	Closed
VfxEffects	array<object>	Non	Les effets visuels. Ce paramètre n'est valide que lorsque VfxEffectMode est défini sur Random ou Sequential. Vous pouvez spécifier jusqu'à 10 effets visuels.
	object	Non
VfxEffect	string	Oui	L'effet visuel. Pour plus d'informations, consultez Effets visuels.	letterboxed
Weight	integer	Non	Le poids de l'effet visuel. Valeurs valides : [1, 100]. Valeur par défaut : 50. Ce paramètre n'est valide que lorsque VfxEffectMode est défini sur Random.	50
Output	object	Oui	La configuration de sortie.
Audio	TargetAudio	Non	Les paramètres de traitement audio. Important Si Audio est vide, le premier flux audio (le cas échéant) est directement copié dans le fichier de sortie.
Container	string	Non	Le type de conteneur multimédia. Ce paramètre est requis lorsque Type est défini sur Concat ou Compose. Valeurs valides : Conteneurs audio et vidéo : mp4, mkv, mov, asf, avi, mxf, ts et flv Important Vous devez spécifier à la fois Container et URI.	mp4
MaxDuration	number	Non	La durée maximale de la vidéo montée. Unité : secondes.	10.0
Segment	object	Non	Les paramètres de segmentation multimédia. Par défaut, la segmentation n'est pas effectuée.
Duration	number	Non	La longueur de chaque segment. Unité : secondes.	1
Format	string	Non	Le format de segmentation multimédia. Valeurs valides : hls dash	hls
StartNumber	integer	Non	Le numéro de départ. Ce paramètre n'est pris en charge que pour hls. Valeur par défaut : 0.	0
Speed	number	Non	Le multiplicateur de vitesse de lecture pour le média. Valeurs valides : [0,5, 1,0]. Valeur par défaut : 1,0. Remarque Le rapport entre la vitesse de lecture par défaut du fichier multimédia transcodé et celle du fichier multimédia source. Il ne s'agit pas d'un transcodage à vitesse ajustée.	1.0
TargetDuration	number	Non	La durée cible de la vidéo. Unité : secondes.	10.0
URI	string	Oui	L'URI du fichier de sortie.	oss://test-bucket/test-target-object.mp4
Video	TargetVideo	Non	Les paramètres de traitement vidéo. Important Si Video est vide, le premier flux vidéo (le cas échéant) est directement copié dans le fichier de sortie.
UserData	string	Non	Les données utilisateur personnalisées, qui sont renvoyées dans les notifications de messages asynchrones.	{"ID": "testuid","Name": "test-user","Avatar": "http://test.com/testuid"}
Tags	object	Non	Les balises personnalisées utilisées pour rechercher et filtrer les tâches asynchrones.	{"test":"val1"}
CredentialConfig	CredentialConfig	Non	La configuration d'autorisation chaînée. Laissez ce paramètre vide sauf indication contraire.
Notification	Notification	Non	La configuration de notification des messages. Pour plus d'informations, consultez Notification. Pour le format des messages de notification asynchrone, consultez Format des messages de notification asynchrone.

Éléments de réponse

Élément	Type	Description	Exemple
	object	Schéma de la réponse.
EventId	string	L'identifiant de l'événement.	0ED-1Bz8z71k5TtsUejT4UJ16Es****
RequestId	string	L'identifiant de la requête.	CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6
TaskId	string	L'identifiant de la tâche.	Highlight-4d51241b-04d4-4343-aa25-****

Exemples

JSON format

{
  "EventId": "0ED-1Bz8z71k5TtsUejT4UJ16Es****",
  "RequestId": "CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6",
  "TaskId": "Highlight-4d51241b-04d4-4343-aa25-****"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.