All Products
Search

This Product

    ApsaraVideo Live:AddLiveAIProduceRules

    Document Center

    ApsaraVideo Live:AddLiveAIProduceRules

    Last Updated:Jun 10, 2026

    Menambahkan aturan subtitle.

    Deskripsi operasi

    • After you add a subtitle template by calling the AddLiveAISubtitle operation, you can call this operation to add a subtitle rule.

    • To play a subtitle stream, append _{Subtitle template name} to the StreamName in the playback URL.

      • RTMP: rtmp://example.aliyundoc.com/app/stream_{Subtitle template name}?auth_key={access token}

      • FLV: http://example.aliyundoc.com/app/stream_{Subtitle template name}.flv?auth_key={access token}

      • M3U8: http://example.aliyundoc.com/app/stream_{Subtitle template name}.m3u8?auth_key={access token}

    Penting

    The real-time subtitle feature is in invitational preview. You can add up to 300 subtitle templates.

    QPS limits

    The queries per second (QPS) limit for this operation is 60 per user. If you exceed this limit, API calls are throttled. This may affect your business. Plan your calls accordingly.

    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

    live:AddLiveAIProduceRules

    create

    *Domain

    acs:cdn:*:{#accountId}:domain/{#DomainName}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    ID wilayah.

    cn-shanghai
    Domain

    string

    Yes

    Domain streaming.

    demo.aliyundoc.com
    App

    string

    Yes

    Nama aplikasi live aliran. Nama dapat memiliki panjang hingga 256 karakter dan dapat berisi digit, huruf besar dan kecil, tanda hubung (-), serta garis bawah (_). AppName harus sesuai dengan AppName di URL ingest agar templat dapat berlaku.

    AppName
    Suffix

    string

    No

    Sufiks yang akan dicocokkan.

    test01
    SubtitleName

    string

    No

    Nama templat subtitle.

    sub01
    StudioName

    string

    No

    Nama templat latar belakang virtual.

    sub02
    IsLazy

    boolean

    No

    Apakah aturan dipicu oleh penarikan aliran. Nilai valid:

    • true: Subtitle dibuat saat penarikan aliran dimulai. Jika tidak ada aliran yang ditarik selama 5 menit, pembuatan subtitle berhenti. Pembuatan subtitle dilanjutkan saat penarikan aliran dimulai kembali.

    • false: Subtitle dibuat saat pengambilan aliran dimulai, terlepas dari apakah aliran sedang ditarik atau tidak.

    true
    LiveTemplate

    string

    Yes

    Spesifikasi subtitle output. Nilai valid:

    • Definisi rendah lanskap 360p (640 × 360): lp_ld

    • Definisi rendah potret 360p (360 × 640): lp_ld_v

    • Definisi standar lanskap 480p (854 × 480): lp_sd

    • Definisi standar potret 480p (480 × 854): lp_sd_v

    • Definisi tinggi lanskap 720p (1280 × 720): lp_hd

    • Definisi tinggi potret 720p (720 × 1280): lp_hd_v

    • Definisi ultra tinggi lanskap 1080p (1920 × 1080): lp_ud

    • Definisi ultra tinggi potret 1080p (1080 × 1920): lp_ud_v.

    lp_ld
    Description

    string

    No

    Deskripsi aturan subtitle. Deskripsi dapat berisi karakter Mandarin dan Inggris, digit, serta karakter khusus. Panjangnya dapat mencapai 128 karakter.

    live AI subtitle template

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    5c6a2a0df228-4a64-af62-20e91b96****
    RulesId

    string

    The ID of the subtitle rule.

    445409ec-7eaa-461d-8f29-4bec2eb9****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "5c6a2a0df228-4a64-af62-20e91b96****",
  "RulesId": "445409ec-7eaa-461d-8f29-4bec2eb9****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 MissingParameter %s.
    400 InvalidParameter %s.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.