All Products
Search

This Product

    Intelligent Media Services:Segmentasi cerdas

    Document Center

    Intelligent Media Services:Segmentasi cerdas

    Last Updated:Dec 16, 2025

    Topik ini menjelaskan cara menggunakan operasi SubmitSegmentationJob untuk melakukan segmentasi cerdas, serta parameter respons yang dikembalikan saat memanggil operasi GetSmartHandleJob guna mengambil hasil pekerjaan segmentasi cerdas. Untuk informasi selengkapnya mengenai penagihan, lihat Penagihan segmentasi cerdas.

    Penting

    • Catatan: Wilayah yang ditentukan dalam URL OSS suatu aset media harus sama dengan wilayah titik akhir OpenAPI yang Anda panggil.

    • Wilayah yang didukung: Tiongkok (Shanghai), Tiongkok (Beijing), Tiongkok (Hangzhou), Tiongkok (Shenzhen), AS (Barat), dan Singapura.

    Catatan penggunaan

    Parameter JobParams

    Anda dapat mengonfigurasi JobParams untuk menentukan kebijakan segmentasi shot video.

    Parameter

    Tipe

    Deskripsi

    Wajib

    Mode

    String

    Mode segmentasi. Nilai yang valid:

    • UserDefined: Custom segmentation. Video disegmentasi berdasarkan rentang waktu yang ditentukan dalam Ranges.

    • BasicClipSplit: Segmentasi shot dasar. Video disegmentasi berdasarkan perubahan scene.

    Ya

    Ranges

    List<Range>

    Rentang waktu untuk custom segmentation. Parameter ini wajib ditentukan ketika Mode diatur ke UserDefined.

    Tidak

    Parameter Range

    Parameter

    Tipe

    Deskripsi

    Wajib

    In

    Float

    Waktu mulai segmen. Satuan: detik. Contoh: 0.

    Ya

    Out

    Float

    Waktu akhir segmen. Satuan: detik. Contoh: 10.

    Ya

    Contoh parameter

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

    Parameter InputConfig

    Anda dapat mengonfigurasi InputConfig untuk menentukan materi video sumber.

    Parameter

    Tipe

    Deskripsi

    Wajib

    Type

    String

    Tipe media. Pilih salah satu tipe berikut:

    • OSS: URL objek OSS.

    • Media: ID aset media.

    Ya

    Media

    String

    • Jika Type diatur ke OSS, URL OSS dan URL HTTP didukung. Nama domain kustom tidak didukung. Contoh: oss://test-bucket/test.mp4 atau http://test-bucket.oss-cn-beijing.aliyuncs.com/test.mp4

    • Jika Type diatur ke Media, tentukan ID media. Contoh: c5c62d8f0******cab312dce8e77dc6d.

    Ya

    Contoh parameter

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

    Parameter OutputConfig

    Anda dapat mengonfigurasi OutputConfig untuk menentukan parameter seperti alamat output dan aturan penamaan.

    Parameter

    Tipe

    Deskripsi

    Wajib

    Contoh

    OutputMediaTarget

    String

    Tipe target file output.

    • oss-object (objek OSS di bucket OSS Alibaba Cloud Anda).

    Ya

    oss-object

    Endpoint

    String

    Titik akhir yang sesuai dengan protokol S3.

    • Untuk OSS, wilayah harus sama dengan wilayah layanan yang Anda akses.

    Nilai default adalah titik akhir OSS dari wilayah yang sama.

    Tidak

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

    Bucket

    String

    Bucket penyimpanan yang sesuai dengan protokol S3.

    • Bucket penyimpanan OSS Anda sendiri.

    Ya

    test-output

    ObjectKey

    String

    Nama objek yang sesuai dengan protokol S3.

    Placeholder yang didukung:

    • {index}: Placeholder ini harus disertakan dalam path file.

    Ya

    dir/to/testOutput_{index}.mp4

    ExportAsNewMedia

    Boolean

    Menentukan apakah output diekspor sebagai aset media baru.

    Parameter ini hanya berlaku ketika OutputMediaTarget diatur ke oss-object.

    Tidak. Nilai default adalah false.

    false

    Width

    Integer

    Lebar video output. Satuan: px. Jika Anda tidak menentukan parameter ini, lebar video sumber akan digunakan.

    Tidak

    1280

    Height

    Integer

    Tinggi video output. Satuan: px. Jika Anda tidak menentukan parameter ini, tinggi video sumber akan digunakan.

    Tidak

    720

    Video

    JSONObject

    Konfigurasi aliran video output, seperti Crf dan Codec.

    Tidak

    {

    "Bitrate": 3000

    }

    Contoh parameter

     {
    "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
    }
  }

    Parameter respons GetSmartHandleJob

    Anda dapat memanggil operasi GetSmartHandleJob untuk mengambil hasil pekerjaan segmentasi cerdas. Bagian berikut menjelaskan parameter dalam AiResult:

    Parameter AiResult

    {
  "SegmentationResult": {
    "OutputEndpoint": "http://oss-cn-shanghai.aliyuncs.com", // Titik akhir yang sesuai dengan protokol S3
    "OutputBucket": "test-output", // Bucket yang sesuai dengan protokol S3
    "OutputObjectResults": [ // Hasil setelah segmentasi shot
      {
        "ObjectKey": "testOutput_0.mp4", // Nama objek yang sesuai dengan protokol S3
        "MediaId": "xxx1" // ID aset media yang dihasilkan setelah segmentasi shot
      },
       {
        "ObjectKey": "testOutput_0.mp4",
        "MediaId": "xxx2"
      }
    ]
  }
}

    Referensi