Soumet une tâche de création d’image animée et lance le traitement asynchrone.
La capture d’un extrait vidéo et la génération d’images animées ne sont possibles que si la vidéo se trouve dans l’état UploadSucces, Transcoding, Normal, Checking ou Blocked.
Les frais de génération d’images animées sont inclus dans les frais de transcodage vidéo. Ces deux services sont facturés en fonction de la résolution et de la durée.
Débogage
Paramètres de la requête
| Paramètre | Type | Obligatoire | Exemple | Description |
| Action | String | Oui | SubmitDynamicImageJob |
Nom de l’opération à effectuer. Définissez la valeur sur SubmitDynamicImageJob.
|
| DynamicImageTemplateId | String | Oui | 1a443dc52e*f10abc4794d70 |
ID du modèle d’image animée.
|
| VideoId | String | Oui | 7d2fbc3e273441*bdb0e08e55f |
ID de la vidéo.
|
| OverrideParams | String | Non | {"Watermarks":[{"Content":"User ID: 66666","WatermarkId":"8ca03c884944bd0*5efccc312367"}]} |
Paramètres de substitution au format JSON. Pour plus d’informations, consultez la section « OverrideParams » de la rubrique Paramètres de traitement des médias. Ces paramètres remplacent ceux définis dans le modèle d’image animée. Pour plus d’informations, consultez la rubrique Types de données de base.
|
Paramètres de la réponse
| Paramètre | Type | Exemple | Description |
| DynamicImageJob | Struct | |
Informations sur la tâche d’image animée.
|
| JobId | String | ad90a501b1b*fb72374ad005046 |
ID de la tâche d’image animée.
|
| RequestId | String | 25818875-5F78*BEF6-D7393642CA58 |
ID de la requête.
|
Exemples
Exemple de requête
https://vod.{ApiRegion}.aliyuncs.com/?Action=SubmitDynamicImageJob
&DynamicImageTemplateId=1a443dc52e*****f10abc4794d70
&VideoId=7d2fbc3e273441*****bdb0e08e55f
&<Common request parameters>Exemple de réponse réussie
Format XML
<SubmitDynamicImageJobResponse>
<RequestId>25818875-5F78*****BEF6-D7393642CA58</RequestId>
<DynamicImageJob>
<JobId>ad90a501b1b*****fb72374ad005046</JobId>
</DynamicImageJob>
</SubmitDynamicImageJobResponse>Format JSON
{
"RequestId": "25818875-5F78*****BEF6-D7393642CA58",
"DynamicImageJob": {
"JobId": "ad90a501b1b*****fb72374ad005046"
}
}Codes d’erreur
Pour obtenir la liste des codes d’erreur, consultez le Centre d’erreurs de l’API.
Erreurs courantes
Le tableau suivant décrit les erreurs courantes renvoyées par cette opération.
| Code d’erreur | Message d’erreur | Code d’état HTTP | Description |
|
InvalidVideo.NotFound
|
The video does not exist.
|
404
|
Ce message indique que la vidéo n’existe pas.
|
|
NoSuchResource
|
The specified resource %s does not exist.
|
404
|
Ce message indique que la ressource associée à l’utilisateur n’existe pas. %s contient les détails de la ressource.
|
|
Forbidden.IllegalStatus
|
Status of the video is illegal.
|
400
|
Ce message indique que l’état de la vidéo est invalide. La capture d’un extrait vidéo et la génération d’images animées ne sont possibles que si la vidéo se trouve dans l’état UploadSucces, Transcoding, Normal, Checking ou Blocked.
|