Aktifkan subtitle AI real-time dengan AddLiveAISubtitle - ApsaraVideo Live - Alibaba Cloud - ApsaraVideo Live

Menambahkan templat subtitle dengan memanggil AddLiveAISubtitle.

Deskripsi operasi

Operasi ini memungkinkan Anda menambahkan konfigurasi templat subtitle live. Konfigurasi templat menjelaskan konten subtitle, tata letak, dan informasi lainnya.
Setelah Anda menambahkan templat subtitle, panggil operasi AddLiveAIProduceRules untuk menambahkan aturan subtitle. Subtitle berlaku di stream hanya setelah Anda melakukan ingest ulang stream.
Subtitle real-time hanya didukung di wilayah Beijing, Shanghai, Singapura, Indonesia, dan Arab Saudi.

Penting Fitur subtitle real-time sedang dalam pratinjau publik. Setiap pengguna dapat menambahkan hingga 300 templat subtitle. Fitur ini gratis selama pratinjau publik. Setelah pratinjau publik berakhir, penagihan standar berlaku. Tanggal spesifik akan diumumkan secara terpisah.

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

create

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah.	cn-shanghai
SubtitleName	string	Yes	Nama templat subtitle. Nama hanya boleh berisi angka, huruf, dan tanda hubung (-). Nama tidak boleh diawali dengan tanda hubung.	sub01
SrcLanguage	string	Yes	Bahasa sumber. Nilai yang valid: Inggris: en-US Tionghoa: zh-CN Rusia: ru-RU.	zh-CN
DstLanguage	string	No	Bahasa target untuk terjemahan. Nilai yang valid: Inggris: en-US Tionghoa: zh-CN Spanyol: es-ES Rusia: ru-RU.	zh-CN
FontColor	string	No	Warna font. Tentukan nilai dalam format RGBA.	0xFFFFFF
FontName	string	No	Font. Nilai yang valid: KaiTi: KaiTi (default) AlibabaPuHuiTi-Regular: Alibaba PuHuiTi Regular AlibabaPuHuiTi-Bold: Alibaba PuHuiTi Bold AlibabaPuHuiTi-Light: Alibaba PuHuiTi Light NotoSansHans-Regular: Noto Sans SC Regular NotoSansHans-Bold: Noto Sans SC Bold NotoSansHans-Light: Noto Sans SC Light.	KaiTi
BgColor	string	No	Warna latar belakang subtitle. Tentukan nilai dalam format RGBA.	0xFF0000
PositionNormalized	array	Yes	Posisi subtitle. Nilainya adalah koordinat x,y dengan sudut kiri bawah layar sebagai titik asal. Catatan Nilai x dan y harus dinormalisasi. Nilai aktual dikalikan dengan tinggi video. Misalnya, jika tinggi video adalah 720p dan PositionNormalized diatur ke [0.1, 0.5], posisi aktual subtitle adalah x = 72 dan y = 360.	[0.32,0.27]
	number	No	Nilai koordinat posisi subtitle.	0.32
ShowSourceLan	boolean	No	Menentukan apakah akan menampilkan bahasa sumber. Nilai default: false.	true
MaxLines	integer	No	Jumlah baris yang ditampilkan.	2
WordPerLine	integer	Yes	Jumlah karakter per baris. Nilai yang valid: bilangan bulat dalam rentang [1, 500].	20
FontSizeNormalized	number	Yes	Ukuran font. Nilai yang valid: [0, 1].	0.037
BorderWidthNormalized	number	No	Ketebalan font. Nilai yang valid: [0, 1].	0.05
BgWidthNormalized	number	No	Ukuran latar belakang subtitle. Nilai yang valid: [0, 1].	0.09
CopyFrom	string	No	Templat subtitle yang akan disalin. Atur parameter ini ke nilai SubtitleName.	sub01
Description	string	No	Deskripsi kustom subtitle. Deskripsi dapat berisi karakter Tionghoa, huruf, angka, dan karakter khusus, serta panjangnya hingga 128 karakter.	live AI subtitle template
Width	string	No	Lebar layar pratinjau. Satuan: px.	1280
Height	string	No	Tinggi layar pratinjau. Satuan: px. Lebar × tinggi layar pratinjau hanya mendukung spesifikasi berikut: Lanskap definisi rendah 360P: 640 × 360 Potret definisi rendah 360P: 360 × 640 Lanskap definisi standar 480P: 854 × 480 Potret definisi standar 480P: 480 × 854 Lanskap definisi tinggi 720P: 1280 × 720 Potret definisi tinggi 720P: 720 × 1280 Lanskap definisi ultra-tinggi 1080P: 1920 × 1080 Potret definisi ultra-tinggi 1080P: 1080 × 1920.	720

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	5c6a2a0df228-4a64-af62-20e91b96****
SubtitleId	string	ID templat subtitle.	445409ec-7eaa-461d-8f29-4bec2eb9****

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidParameter	%s.
400	MissingParameter	%s.
400	InvalidParameter.Malformed	There are invalid parameters: %s.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.