AddTemplate - - Centre de documentation Alibaba Cloud

Crée un modèle pour la production multimédia intelligente, qui prend en charge la fonctionnalité de clip vidéo basée sur des modèles standard et avancés. Vous pouvez appeler AddTemplate pour créer un modèle.

Description de l'opération

Notes d'utilisation

Pour utiliser des modèles standard, reportez-vous à Démarrage rapide pour les modèles standard.
Pour utiliser des modèles avancés, reportez-vous à Créer et utiliser des modèles avancés.

Limites

Une fois qu'un modèle avancé est créé, il nécessite un temps d'analyse et son état est Processing. Pendant cette période, le modèle n'est pas disponible. Vous ne pouvez utiliser le modèle que lorsque son état passe à Available. Le temps d'analyse dépend de la taille du fichier de modèle et varie généralement de 10 secondes à 5 minutes.

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:AddTemplate

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Name	string	Non	Le nom du modèle.	TemplateName
Type	string	Non	Le type de modèle. Valeurs valides : Timeline : modèle standard. Il est créé en fonction de la chronologie d'un projet de clip vidéo, où plusieurs matériaux sont assemblés sur plusieurs couches. Il prend en charge des effets tels que la conversion de texte en vidéo, les albums photo, les introductions et génériques de fin, et les filigranes par défaut. VETemplate : modèle avancé. Il est créé à partir d'effets Adobe After Effects (AE) pour obtenir des effets multimédias avancés avec des graphiques animés complexes. BatchEditing : modèle de génération de vidéo en un clic. Il prend en charge des paramètres tels que les filigranes d'autocollants, la musique de fond, les images d'arrière-plan, les styles de sous-titres de voix off, les styles de sous-titres de titre et la résolution de sortie. Ces paramètres sont automatiquement appliqués lorsqu'un nœud de génération de vidéo en un clic est validé. Valeurs valides : Timeline : Modèle standard. VETemplate : Modèle avancé.	Timeline
Config	string	Non	Le paramètre Config pour les modèles standard est une encapsulation basée sur la chronologie d'édition cloud. Les configurations de modèles personnalisés sont plus flexibles. Si vous avez des exigences spécifiques, familiarisez-vous avec la structure Config et personnalisez le modèle. Pour plus d'informations, consultez Détails de Config pour les modèles standard. Pour plus d'exemples de Config, consultez Exemples courants de Config pour les modèles standard. Pour les paramètres Config des modèles de génération de vidéo en un clic, consultez Description des métriques pour la configuration des modèles de génération de vidéo en un clic.	See Config documentation
CoverUrl	string	Non	L'URL de la couverture du modèle.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg
PreviewMedia	string	Non	L'identifiant de la ressource multimédia de la vidéo d'aperçu du modèle.	**01bf24bf41c78b2754cb3187**
Status	string	Non	L'état du modèle. Valeurs valides : Available : Normal. Created : Créé mais indisponible. Uploading : En cours de téléchargement. Processing : Analyse du modèle avancé en cours. UploadFailed : Échec du téléchargement. ProcessFailed : Échec de l'analyse du modèle avancé. Valeurs valides : UploadFailed : Échec du téléchargement. ProcessFailed : Échec de l'analyse du modèle avancé. Available : Normal. Uploading : En cours de téléchargement. Created : Créé mais indisponible. Processing : Analyse du modèle avancé en cours.	Available
Source	string	Non	La source à partir de laquelle le modèle est créé. Valeurs valides : OpenAPI : Créé en appelant une opération d'API. AliyunConsole : Créé dans la console de gestion Alibaba Cloud. WebSDK : Créé en utilisant WebSDK. Valeurs valides : AliyunConsole : Créé dans la console de gestion Alibaba Cloud. WebSDK : Créé en utilisant WebSDK. OpenAPI : Créé en appelant une opération d'API.	OpenAPI
RelatedMediaids	string	Non	Les ressources multimédias associées au modèle. Ce paramètre est utilisé par l'éditeur de modèles standard.	{"video":["1805a0c6ca544fb395a06ca683619655"]}

Éléments de réponse

Élément	Type	Description	Exemple
	object	Schéma de la réponse.
RequestId	string	L'identifiant de la requête.	**2876-6263-4B75-8F2C-CD0F7FCF**
Template	object	Les informations du modèle.
TemplateId	string	L'identifiant du modèle.	**01bf24bf41c78b2754cb3187**
Name	string	Le nom du modèle.	TemplateName
Type	string	Le type de modèle. Valeurs valides : Timeline : Modèle standard. VETemplate : Modèle avancé.	Timeline
Config	string	La configuration du modèle.	See Config documentation
CoverUrl	string	L'URL de la couverture du modèle.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg
PreviewMedia	string	L'identifiant de la ressource multimédia de la vidéo d'aperçu.	**01bf24bf41c78b2754cb3187**
Status	string	L'état du modèle. Valeurs valides : UploadFailed : Échec du téléchargement. ProcessFailed : Échec de l'analyse du modèle avancé. Available : Normal. Uploading : En cours de téléchargement. Created : Créé mais indisponible. Processing : Analyse du modèle avancé en cours.	Available
CreateSource	string	La source à partir de laquelle le modèle a été créé. Valeurs valides : AliyunConsole : Créé dans la console de gestion Alibaba Cloud. WebSDK : Créé en utilisant WebSDK. OpenAPI : Créé en appelant une opération d'API.	OpenAPI
ModifiedSource	string	La source à partir de laquelle le modèle a été modifié. Valeurs valides : AliyunConsole : Créé dans la console de gestion Alibaba Cloud. WebSDK : Créé en utilisant WebSDK. OpenAPI : Créé en appelant une opération d'API.	OpenAPI

Exemples

JSON format

{
  "RequestId": "****2876-6263-4B75-8F2C-CD0F7FCF****",
  "Template": {
    "TemplateId": "****01bf24bf41c78b2754cb3187****",
    "Name": "Nom du modèle",
    "Type": "Timeline",
    "Config": "Consultez la documentation de Config",
    "CoverUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg",
    "PreviewMedia": "****01bf24bf41c78b2754cb3187****",
    "Status": "Available",
    "CreateSource": "OpenAPI",
    "ModifiedSource": "OpenAPI"
  }
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.