All Products
Search
Document Center

Intelligent Media Services:GetCustomTemplate

Last Updated:Jun 11, 2026

Mengkueri informasi tentang template pemrosesan media yang ditentukan pengguna.

Deskripsi operasi

Anda dapat memanggil operasi ini untuk mengkueri informasi tentang template dengan TemplateId yang ditentukan, atau mengkueri informasi tentang template default. Jika TemplateId tidak kosong, parameter lain diabaikan dan informasi tentang template dengan TemplateId yang ditentukan akan dikueri. Jika TemplateId kosong, template default pengguna dikueri berdasarkan parameter lain. Dalam hal ini, Type wajib diisi.

Jenis template (Type):

  1. 1: template transcoding

  2. 2: template snapshot

  3. 3: template gambar animasi

  4. 4: template watermark gambar

  5. 5: template watermark teks

  6. 6: template subtitle

  7. 7: moderasi konten berbasis AI

  8. 8: sampul cerdas berbasis AI

  9. 9: penghapusan cerdas berbasis AI

Subjenis template transcoding (Subtype):

  1. 1: template transcoding normal (Normal)

  2. 2: template transcoding audio (AudioTranscode)

  3. 3: remux (Remux)

  4. 4: Narrowband HD 1.0 (NarrowBandV1)

  5. 5: Narrowband HD 2.0 (NarrowBandV2)

Subjenis template snapshot (Subtype):

  1. 1: snapshot normal/statis (Normal)

  2. 2: sprite (Sprite)

  3. 3: snapshot WebVtt (WebVtt)

Subjenis template moderasi AI (Subtype):

  1. 1: moderasi video (Video)

  2. 2: moderasi audio (Audio)

  3. 3: moderasi gambar (Image)

Subjenis template penghapusan cerdas AI (Subtype):

  1. 1: penghapusan logo (VideoDelogo)

  2. 2: penghapusan subtitle (VideoDetext)

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

get

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

TemplateId

string

No

ID template.

****96e8864746a0b6f3****

Type

integer

No

ID jenis template yang digunakan saat mengkueri template default. Parameter ini wajib diisi jika TemplateId dibiarkan kosong.

1

Subtype

integer

No

Subjenis template.

1

Elemen respons

Element

Type

Description

Example

object

Schema of Response

RequestId

string

ID permintaan.

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

CustomTemplate

object

Informasi template.

TemplateId

string

ID template.

****20b48fb04483915d4f2cd8ac****

TemplateName

string

Nama template.

测试截图模板

Type

integer

ID jenis template.

2

TypeName

string

Nama jenis template.

SnapshotTemplate

Subtype

integer

ID subjenis template.

1

SubtypeName

string

Nama subjenis template.

Normal

Status

string

Status template.

Normal

IsDefault

boolean

Menunjukkan apakah template adalah template default.

true

TemplateConfig

string

Parameter template.

{"Type":"Normal","FrameType":"normal","Time":0,"Count":10}

CreateTime

string

Waktu saat template dibuat.

2022-01-01T10:00:00Z

ModifiedTime

string

Waktu saat template dimodifikasi.

2022-01-01T11:00:00Z

FrontendHint

object

TranscodeTemplateHint

object

BitrateControlType

string

Contoh

Respons sukses

JSONformat

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "CustomTemplate": {
    "TemplateId": "****20b48fb04483915d4f2cd8ac****",
    "TemplateName": "测试截图模板",
    "Type": 2,
    "TypeName": "SnapshotTemplate",
    "Subtype": 1,
    "SubtypeName": "Normal",
    "Status": "Normal",
    "IsDefault": true,
    "TemplateConfig": "{\"Type\":\"Normal\",\"FrameType\":\"normal\",\"Time\":0,\"Count\":10}",
    "CreateTime": "2022-01-01T10:00:00Z",
    "ModifiedTime": "2022-01-01T11:00:00Z\n",
    "FrontendHint": {
      "TranscodeTemplateHint": {
        "BitrateControlType": ""
      }
    }
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.