All Products
Search

This Product

    Intelligent Media Services:ListTemplates

    Document Center

    Intelligent Media Services:ListTemplates

    Last Updated:Mar 21, 2026

    Mengambil daftar templat yang memenuhi kondisi tertentu. Anda dapat mengambil templat berdasarkan informasi seperti status templat dan sumber pembuatannya.

    Deskripsi operasi

    Templat adalah enkapsulasi dari timeline suatu pekerjaan editing dan produksi media. Anda dapat mendefinisikan timeline umum sebagai templat. Ketika memiliki kebutuhan yang sama, Anda hanya perlu menentukan parameter dan material utama untuk menghasilkan video.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ice:ListTemplates

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Type

    string

    No

    Jenis templat.

    Nilai yang valid:

    • Timeline

    • VETemplate

    Valid values:

    • Timeline :

      Timeline

    • VETemplate :

      VETemplate

    Timeline
    Status

    string

    No

    Status templat.

    Nilai yang valid:

    • UploadFailed: Gagal mengunggah video.

    • ProcessFailed: Gagal memproses templat advanced.

    • Available: Templat tersedia.

    • Uploading: Video sedang diunggah.

    • Created: Templat telah dibuat tetapi belum siap digunakan.

    • Processing: Templat advanced sedang diproses.

    Valid values:

    • UploadFailed :
    • ProcessFailed :
    • Available :
    • Uploading :
    • Created :
    • Processing :

    Available
    CreateSource

    string

    No

    Sumber pembuatan templat.

    Nilai yang valid:

    • AliyunConsole

    • WebSDK

    • OpenAPI

    Valid values:

    • AliyunConsole :
    • WebSDK :
    • OpenAPI :

    OpenAPI
    Keyword

    string

    No

    Kata kunci pencarian. Anda dapat menggunakan ID templat atau judul sebagai kata kunci untuk mencari templat.

    ****20b48fb04483915d4f2cd8ac****
    SortType

    string

    No

    Parameter pengurutan. Secara default, hasil kueri diurutkan berdasarkan waktu pembuatan secara descending.

    Nilai yang valid:

    • CreationTime:Asc: diurutkan berdasarkan waktu pembuatan secara ascending.

    • CreationTime:Desc: diurutkan berdasarkan waktu pembuatan secara descending.

    Valid values:

    • CreationTime:ASC :
    • CreationTime:Desc :

    CreationTime:Desc

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    RequestId

    string

    ID permintaan.

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

    integer

    Jumlah total entri yang dikembalikan.

    100
    Templates

    array<object>

    Templat yang ditanyakan.

    object

    Informasi templat.

    TemplateId

    string

    ID templat.

    ****20b48fb04483915d4f2cd8ac****
    Name

    string

    Nama templat.

    云剪辑模板
    Type

    string

    Jenis templat.

    Nilai yang valid:

    • Timeline: templat reguler.

    • VETemplate: templat advanced.

    Valid values:

    • Timeline :
    • VETemplate :

    Timeline
    Config

    string

    Konfigurasi templat.

    参考Timeline模板配置详解
    PreviewMedia

    string

    Aset media pratinjau.

    ****20b48fb04483915d4f2cd8ac****
    Status

    string

    Status templat.

    Nilai yang valid:

    • UploadFailed: Gagal mengunggah video.

    • ProcessFailed: Gagal memproses templat advanced.

    • Available: Templat tersedia.

    • Uploading: Video sedang diunggah.

    • Created: Templat telah dibuat tetapi belum siap digunakan.

    • Processing: Templat advanced sedang diproses.

    Valid values:

    • UploadFailed :
    • ProcessFailed :
    • Available :
    • Uploading :
    • Created :
    • Processing :

    Available
    CreateSource

    string

    Sumber pembuatan templat.

    Nilai yang valid:

    • AliyunConsole

    • WebSDK

    • OpenAPI

    Valid values:

    • AliyunConsole :
    • WebSDK :
    • OpenAPI :

    OpenAPI
    ModifiedSource

    string

    Sumber modifikasi templat.

    Nilai yang valid:

    • AliyunConsole

    • WebSDK

    • OpenAPI

    Valid values:

    • AliyunConsole :
    • WebSDK :
    • OpenAPI :

    OpenAPI
    PreviewMediaStatus

    string

    Status aset media pratinjau.

    Nilai yang valid:

    • PrepareFail

    • Init

    • Normal

    • Preparing

    Valid values:

    • PrepareFail :
    • Init :
    • Normal :
    • Preparing :

    Normal
    CreationTime

    string

    Waktu pembuatan templat.

    2020-12-26T04:11:10Z
    ModifiedTime

    string

    Waktu terakhir templat dimodifikasi.

    2020-12-26T04:11:10Z
    CoverURL

    string

    URL gambar mini.

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg
    ClipsParam

    string

    Parameter klip.

    {"Media1":"mediaId","Text1":"text"}

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "TotalCount": 100,
  "Templates": [
    {
      "TemplateId": "****20b48fb04483915d4f2cd8ac****",
      "Name": "云剪辑模板",
      "Type": "Timeline",
      "Config": "参考Timeline模板配置详解",
      "PreviewMedia": "****20b48fb04483915d4f2cd8ac****",
      "Status": "Available",
      "CreateSource": "OpenAPI",
      "ModifiedSource": "OpenAPI",
      "PreviewMediaStatus": "Normal",
      "CreationTime": "2020-12-26T04:11:10Z",
      "ModifiedTime": "2020-12-26T04:11:10Z",
      "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/cover.jpg",
      "ClipsParam": "{\"Media1\":\"mediaId\",\"Text1\":\"text\"}"
    }
  ]
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.