Tous les produits
Search

Ce produit

    Intelligent Media Services:Segmentation intelligente

    Centre de documentation

    Intelligent Media Services:Segmentation intelligente

    Dernière mise à jour :Aug 11, 2026

    Appelez l'opération SubmitSegmentationJob pour découper une vidéo en segments, puis l'opération GetSmartHandleJob pour récupérer les résultats. Pour plus de détails sur la facturation, consultez la rubrique Facturation de la segmentation intelligente.

    Important

    • Remarque : La région spécifiée dans l'URL OSS d'un média doit correspondre à celle de l'endpoint OpenAPI appelé.

    • Régions prises en charge : Chine (Shanghai), Chine (Pékin), Chine (Hangzhou), Chine (Shenzhen), États-Unis (Ouest) et Singapour.

    Notes d'utilisation

    Paramètres JobParams

    Configurez JobParams pour définir la politique de segmentation des plans vidéo.

    Paramètre

    Type

    Description

    Obligatoire

    Mode

    String

    Mode de segmentation. Valeurs valides :

    • UserDefined : segmentation personnalisée. La vidéo est découpée selon les plages horaires définies dans Ranges.

    • BasicClipSplit : segmentation basique des plans. Le découpage s'effectue automatiquement lors des changements de scène.

    Oui

    Ranges

    List<Range>

    Plages temporelles pour la segmentation personnalisée. Ce paramètre est requis lorsque Mode est défini sur UserDefined.

    Non

    Paramètres Range

    Paramètre

    Type

    Description

    Obligatoire

    In

    Float

    Instant de début du segment. Unité : secondes. Exemple : 0.

    Oui

    Out

    Float

    Instant de fin du segment. Unité : secondes. Exemple : 10.

    Oui

    Exemple de paramètre

    {
  "Mode": "UserDefined",
  "Ranges": [
    {
      "In": 0,
      "Out": 10
    },
    {
      "In": 20,
      "Out": 30
    }
  ]
}

    Paramètres InputConfig

    Configurez InputConfig pour spécifier la vidéo source.

    Paramètre

    Type

    Description

    Obligatoire

    Type

    String

    Type de média. Choisissez l'une des options suivantes :

    • OSS : URL d'un objet OSS.

    • Media : ID d'un média.

    Oui

    Media

    String

    • Si Type est défini sur OSS, les URL OSS et HTTP sont acceptées. Les noms de domaine personnalisés ne sont pas pris en charge. Exemples : oss://test-bucket/test.mp4 ou http://test-bucket.oss-cn-beijing.aliyuncs.com/test.mp4

    • Si Type est défini sur Media, indiquez l'ID du média. Exemple : c5c62d8f0cab312dce8e77dc6d.

    Oui

    Exemple de paramètre

    {
  "Type": "Media",
  "Media": "c5c62d8f0*********12dce8e77dc6d"
}

    Paramètres OutputConfig

    Configurez OutputConfig pour définir l'emplacement de sortie et les conventions de nommage.

    Paramètre

    Type

    Description

    Obligatoire

    Exemple

    OutputMediaTarget

    String

    Type cible du fichier de sortie.

    • oss-object (objet OSS dans votre bucket Alibaba Cloud OSS).

    Oui

    oss-object

    Endpoint

    String

    Endpoint compatible avec le protocole S3.

    • Pour OSS, la région doit être identique à celle du service auquel vous accédez.

    La valeur par défaut correspond à l'endpoint OSS de la même région.

    Non

    https://oss-cn-shanghai.aliyuncs.com

    Bucket

    String

    Bucket de stockage conforme au protocole S3.

    • Votre propre bucket de stockage OSS.

    Oui

    test-output

    ObjectKey

    String

    Nom de l'objet respectant le protocole S3.

    Espace réservé pris en charge :

    • {index} : cet espace réservé doit figurer dans le chemin d'accès au fichier.

    Oui

    dir/to/testOutput_{index}.mp4

    ExportAsNewMedia

    Boolean

    Indique s'il faut exporter la sortie en tant que nouveau média.

    Ce paramètre n'est valide que si OutputMediaTarget est défini sur oss-object.

    Non. La valeur par défaut est false.

    false

    Width

    Integer

    Largeur de la vidéo de sortie. Unité : px. Si ce paramètre n'est pas spécifié, la largeur de la vidéo source est conservée.

    Non

    1280

    Height

    Integer

    Hauteur de la vidéo de sortie. Unité : px. Si ce paramètre n'est pas spécifié, la hauteur de la vidéo source est conservée.

    Non

    720

    Video

    JSONObject

    Paramètres du flux vidéo de sortie, tels que Crf et Codec.

    Non

    {

    "Bitrate": 3000

    }

    Exemple de paramètre

     {
    "OutputMediaTarget": "oss-object",
    "Endpoint": "https://oss-cn-shanghai.aliyuncs.com",
    "Bucket": "test-output",
    "ObjectKey": "dir/to/testOutput_{index}.mp4",
    "ExportAsNewMedia": false,
    "Width": 1280,
    "Height": 720,
    "Video": {
      "Bitrate": 3000
    }
  }

    Paramètres de réponse GetSmartHandleJob

    Appelez l'opération GetSmartHandleJob pour obtenir les résultats de la segmentation. La section suivante détaille les paramètres AiResult :

    Paramètres AiResult

    {
  "SegmentationResult": {
    "OutputEndpoint": "http://oss-cn-shanghai.aliyuncs.com", // The endpoint that complies with the S3 protocol
    "OutputBucket": "test-output", // The bucket that complies with the S3 protocol
    "OutputObjectResults": [ // The results after shot segmentation
      {
        "ObjectKey": "testOutput_0.mp4", // The object name that complies with the S3 protocol
        "MediaId": "xxx1" // The ID of the media asset generated after shot segmentation
      },
       {
        "ObjectKey": "testOutput_0.mp4",
        "MediaId": "xxx2"
      }
    ]
  }
}

    Références