全部产品
Search
文档中心

ApsaraVideo Live:UpdateLiveAISubtitle

更新时间:Dec 16, 2025

Memperbarui template subtitle.

Deskripsi operasi

Catatan Penggunaan

Anda dapat menggunakan operasi ini untuk mengubah parameter template caption tertentu.

Penting

Fitur caption real-time berada dalam pratinjau undangan. Maksimal 300 template caption dapat ditambahkan per pengguna.

Batas QPS

Batas permintaan per detik (QPS) untuk operasi ini adalah 60 panggilan per detik per pengguna. Panggilan API yang melebihi batas ini akan dikenai Pengendalian aliran, yang dapat memengaruhi bisnis Anda. Rencanakan panggilan API Anda secara tepat. Untuk informasi selengkapnya, 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

create

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

No

ID wilayah.

cn-shanghai

SubtitleName

string

No

Nama templat caption. Nama hanya boleh terdiri dari angka, huruf, dan tanda hubung (-). Nama tidak boleh diawali dengan tanda hubung.

live AI subtitle template

SrcLanguage

string

No

Bahasa sumber. Nilai yang valid:

  • en-US: English

  • zh-CN: Chinese

  • ru-RU: Russian

zh-CN

DstLanguage

string

No

Bahasa target untuk translation. Nilai yang valid:

  • en-US: English

  • zh-CN: Chinese

  • es-ES: Spanish

  • ru-RU: Russian

zh-CN

FontColor

string

No

Warna font, ditentukan sebagai nilai RGBA.

0xFFFFFF

FontName

string

No

Font. Nilai yang valid:

  • KaiTi (default)

  • AlibabaPuHuiTi-Regular

  • AlibabaPuHuiTi-Bold

  • AlibabaPuHuiTi-Light

  • NotoSansHans-Regular

  • NotoSansHans-Bold

  • NotoSansHans-Light

KaiTi

BgColor

string

No

Warna latar belakang caption, ditentukan sebagai nilai RGBA.

0xFF0000

PositionNormalized

array

No

Posisi caption.

number

No

Posisi caption, direpresentasikan oleh koordinat x dan y. Titik origin (0,0) berada di pojok kiri bawah layar.

[0.32,0.27]

ShowSourceLan

boolean

No

Menentukan apakah bahasa sumber ditampilkan. Nilai default: false.

true

MaxLines

integer

No

Jumlah baris yang ditampilkan.

2

WordPerLine

integer

No

Jumlah karakter per baris. Nilainya harus berupa bilangan bulat antara 1 hingga 500.

20

FontSizeNormalized

number

No

Ukuran font. Nilainya harus berada di antara 0 dan 1.

0.037

BorderWidthNormalized

number

No

Lebar border font. Nilainya harus berada di antara 0 dan 1.

0.05

BgWidthNormalized

number

No

Lebar area latar belakang. Nilainya harus berada di antara 0 dan 1.

0.09

SubtitleId

string

Yes

ID templat caption.

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

Description

string

No

Deskripsi kustom templat caption. Deskripsi dapat berisi huruf, angka, dan karakter khusus. Panjang maksimum adalah 128 karakter.

live AI subtitle template

Width

string

No

Lebar jendela pratinjau dalam piksel.

1280

Height

string

No

Tinggi jendela pratinjau dalam piksel.

Jendela pratinjau hanya mendukung resolusi berikut (lebar × tinggi):

  • 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, resolusi ultra-tinggi (1080p): 1920 × 1080

  • Portrait, resolusi 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.