All Products
Search
Document Center

ApsaraVideo Live:UpdateLiveAISubtitle

Last Updated:Jun 23, 2026

Memperbarui templat subtitle dengan memanggil UpdateLiveAISubtitle.

Deskripsi operasi

Deskripsi operasi

Operasi ini memperbarui parameter templat subtitle tertentu.

Penting Fitur subtitle real-time saat ini berada dalam pratinjau undangan. Setiap pengguna dapat menambahkan hingga 300 templat subtitle.
.

Batas QPS

Batas QPS pengguna tunggal untuk operasi ini adalah 60 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi, yang dapat memengaruhi bisnis Anda. Panggil operasi ini dengan tepat. Untuk informasi lebih lanjut, lihat Batas QPS.

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

update

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

No

ID wilayah.

cn-shanghai

SubtitleName

string

No

Nama templat subtitle. Nama hanya dapat berisi angka, huruf, dan tanda hubung (-). Nama tidak dapat diawali dengan tanda hubung.

live AI subtitle template

SrcLanguage

string

No

Bahasa sumber. Nilai valid:

  • en-US: English

  • zh-CN: Chinese

  • ru-RU: Russian.

zh-CN

DstLanguage

string

No

Bahasa target untuk terjemahan. Nilai valid:

  • en-US: English

  • zh-CN: Chinese

  • es-ES: Spanish

  • ru-RU: Russian.

zh-CN

FontColor

string

No

Warna font. Nilai dalam format RGBA.

0xFFFFFF

FontName

string

No

Font. Nilai valid:

  • KaiTi: KaiTi (default)

  • AlibabaPuHuiTi-Regular: Alibaba PuHuiTi Regular

  • AlibabaPuHuiTi-Bold: Alibaba PuHuiTi Bold

  • AlibabaPuHuiTi-Light: Alibaba PuHuiTi Light

  • NotoSansHans-Regular: Noto Sans Hans Regular

  • NotoSansHans-Bold: Noto Sans Hans Bold

  • NotoSansHans-Light: Noto Sans Hans Light.

KaiTi

BgColor

string

No

Warna latar belakang subtitle. Nilai dalam format RGBA.

0xFF0000

PositionNormalized

array

No

Posisi subtitle, ditentukan sebagai koordinat x dan y dengan sudut kiri bawah layar sebagai titik asal.

[0.32,0.27]

number

No

Nilai koordinat posisi subtitle.

0.32

ShowSourceLan

boolean

No

Apakah akan menampilkan bahasa sumber. Nilai default: false.

true

MaxLines

integer

No

Jumlah baris yang ditampilkan.

2

WordPerLine

integer

No

Jumlah karakter per baris. Nilai valid: bilangan bulat dalam rentang [1, 500].

20

FontSizeNormalized

number

No

Ukuran font. Nilai valid: [0, 1].

0.037

BorderWidthNormalized

number

No

Bobot font. Nilai valid: [0, 1].

0.05

BgWidthNormalized

number

No

Ukuran latar belakang subtitle. Nilai valid: [0, 1].

0.09

SubtitleId

string

Yes

ID templat subtitle.

597991f3-6ef9-4100-9238-82951de1****

Description

string

No

Deskripsi kustom subtitle. Deskripsi dapat berisi karakter Mandarin, huruf, angka, dan karakter khusus, serta tidak boleh melebihi 128 karakter.

live AI subtitle template

Width

string

No

Lebar layar pratinjau. Unit: px.

1280

Height

string

No

Tinggi layar pratinjau. Unit: px.

Lebar × tinggi layar pratinjau hanya mendukung spesifikasi berikut:

  • Landscape definisi rendah 360P: 640 × 360

  • Portrait definisi rendah 360P: 360 × 640

  • Landscape definisi standar 480P: 854 × 480

  • Portrait definisi standar 480P: 480 × 854

  • Landscape definisi tinggi 720P: 1280 × 720

  • Portrait definisi tinggi 720P: 720 × 1280

  • Landscape definisi ultra tinggi 1080P: 1920 × 1080

  • Portrait definisi ultra tinggi 1080P: 1080 × 1920.

720

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

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

Contoh

Respons sukses

JSONformat

{
  "RequestId": "String\t5c6a2a0df228-4a64- af62-20e91b96****"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 MissingParameter %s.
400 InvalidParameter %s.
400 InvalidParameter.Malformed There are invalid parameters: %s.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.