Tous les produits
Search
Centre de documentation

:SubmitDynamicImageJob

Dernière mise à jour :Aug 07, 2026

Soumet une tâche de génération d'image dynamique.

Description de l'opération

Il s'agit d'une interface asynchrone. Lorsque vous soumettez une tâche, vous recevez immédiatement un identifiant de tâche tandis que la tâche est mise en file d'attente pour une exécution asynchrone en arrière-plan. Le résultat final est envoyé via une notification de rappel, ou vous pouvez interroger l'état de la tâche en consultant les détails de la tâche d'image dynamique.

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

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

Name

string

Non

Le nom de la tâche.

SampleJob

Input

object

Oui

L'entrée de la tâche.

Type

string

Oui

Le type d'entrée de la tâche. Valeurs valides :

  • OSS : URL de fichier Object Storage Service (OSS).

  • Media : Identifiant de ressource média.

Valeurs valides :

  • Media :

    Un identifiant de ressource média.

  • OSS :

    Une URL OSS.

OSS

Media

string

Oui

La ressource média d'entrée.

  • Si Type est défini sur OSS, spécifiez l'URL OSS du fichier d'entrée.

  • Si Type est défini sur Media, spécifiez l'identifiant de la ressource média.

Une URL OSS doit être dans l'un des formats suivants :

  1. oss://bucket/object

  2. http(s)://bucket.oss-[RegionId].aliyuncs.com/object

Dans ces formats, bucket est le nom d'un compartiment OSS dans la même région que le projet actuel, et object est le chemin d'accès au fichier.

Remarque

Le compartiment OSS spécifié doit être enregistré dans la gestion du stockage IMS.

oss://bucket/object.mp4

Output

object

Oui

La sortie de la tâche.

Type

string

Oui

Le type de sortie de la tâche. Valeurs valides :

  • OSS : La sortie est un fichier OSS.

  • Media : La sortie est une nouvelle ressource média.

Valeurs valides :

  • Media :

    Une nouvelle ressource média est créée.

  • OSS :

    Un fichier OSS.

Media

Media

string

Oui

L'URL OSS de destination pour le fichier de sortie. Ce paramètre est requis lorsque Type est défini sur OSS. L'URL doit être dans l'un des formats suivants :

  • oss://bucket/object

  • http(s)://bucket.oss-[regionId].aliyuncs.com/object

Dans ces formats, bucket est le nom d'un compartiment OSS dans la même région que le projet actuel, et object est le chemin d'accès au fichier.

Remarque

Le compartiment OSS spécifié doit être enregistré dans la gestion du stockage IMS.

****96e8864746a0b6f3****

TemplateConfig

object

Oui

La configuration du modèle d'instantané.

TemplateId

string

Oui

L'identifiant du modèle.

****96e8864746a0b6f3****

OverwriteParams

object

Non

Les paramètres de remplacement.

Format

string

Non

Le format de l'image animée. Valeurs valides :

  • gif

  • webp

Valeurs valides :

  • gif :

    gif.

  • webp :

    webp.

gif

Width

integer

Non

La largeur de l'image animée de sortie. Plage valide : [128, 4096].

1024

Height

integer

Non

La hauteur de l'image animée de sortie. Plage valide : [128, 4096].

720

Fps

integer

Non

La fréquence d'images. Plage valide : [1, 60].

15

ScanMode

string

Non

Le mode de balayage. Valeurs valides :

  • interlaced : Balayage entrelacé.

  • progressive : Balayage progressif. Il s'agit de la valeur par défaut.

Valeurs valides :

  • progressive :

    Balayage progressif.

  • interlaced :

    Balayage entrelacé.

progressive

LongShortMode

boolean

Non

Indique si l'orientation adaptative doit être activée en fonction des bords long et court de la vidéo. Valeurs valides :

  • true : Active l'orientation adaptative.

  • false : Désactive l'orientation adaptative.

Valeur par défaut : true.

Remarque

Lorsqu'il est activé, ce mode définit la largeur de sortie sur le bord long de la vidéo source et la hauteur de sortie sur son bord court. Pour une vidéo au format portrait, sa hauteur est traitée comme le bord long et sa largeur comme le bord court.

Valeurs valides :

  • true :

    true.

  • false :

    false.

false

TimeSpan

object

Non

Spécifie la plage de temps de la vidéo à traiter pour l'image animée.

Seek

string

Non

The start time of the video segment to be processed.

  • Format: hh:mm:ss[.SSS] or sssss[.SSS].

  • Valid range: [00:00:00.000,23:59:59.999] or [0.000,86399.999].

01:59:59.999 or 32000.23

Duration

string

Non

The duration of the video segment to be processed.

  • Format: hh:mm:ss[.SSS] or sssss[.SSS].

  • Valid range: [00:00:00.000,23:59:59.999] or [0.000,86399.999].

01:59:59.999 or 32000.23

End

string

Non

The end time of the video segment to be processed. If this parameter is set, the Duration parameter is ignored.

  • Format: hh:mm:ss[.SSS] or sssss[.SSS].

  • Valid range: [00:00:00.000,23:59:59.999] or [0.000,86399.999].

01:59:59.999 or 32000.23

ScheduleConfig

object

Non

La configuration de la planification.

PipelineId

string

Non

L'identifiant du pipeline.

****96e8864746a0b6f3****

Priority

integer

Non

La priorité de la tâche. Plage valide : [1, 10]. Une valeur plus élevée indique une priorité plus haute. Valeur par défaut : 6.

6

UserData

string

Non

Les données définies par l'utilisateur.

{"SampleKey": "SampleValue"}

Éléments de réponse

Élément

Type

Description

Exemple

object

PlainResponse.

RequestId

string

L'identifiant de la requête.

******11-DB8D-4A9A-875B-275798******

JobId

string

L'identifiant de la tâche.

****20b48fb04483915d4f2cd8ac****

Exemples

JSON format

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

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.