AddLiveAISubtitle - ApsaraVideo Live

Anda dapat memanggil operasi AddLiveAISubtitle untuk menambahkan templat caption.

Deskripsi operasi

Catatan Penggunaan

Operasi ini digunakan untuk menambahkan templat caption siaran langsung yang mencakup konten caption, tata letak, dan informasi terkait lainnya.
Setelah menambahkan templat caption, Anda harus memanggil operasi AddLiveAIProduceRules untuk menambahkan aturan caption. Caption akan muncul dalam aliran pemutaran setelah Anda melakukan restart stream ingest.
Fitur caption real-time hanya tersedia di wilayah China (Beijing), China (Shanghai), Singapura, Indonesia (Jakarta), dan Arab Saudi (Riyadh).

Penting

Fitur caption real-time sedang dalam pratinjau publik. Setiap pengguna dapat menambahkan maksimal 300 templat caption. Fitur ini gratis selama masa pratinjau publik, dan biaya akan dikenakan setelah masa pratinjau berakhir. Tanggal berakhirnya masa pratinjau akan diumumkan secara terpisah.

Batas QPS

Batas permintaan per detik (QPS) untuk operasi ini adalah 60 panggilan per detik per pengguna. Jika batas tersebut dilampaui, panggilan API Anda akan mengalami pengendalian aliran, yang dapat memengaruhi bisnis Anda. Rencanakan panggilan API Anda secara sesuai. 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

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah.	cn-shanghai
SubtitleName	string	Yes	Nama templat caption. Nama hanya boleh terdiri dari angka, huruf kapital, huruf kecil, dan tanda hubung (-). Tanda hubung tidak boleh menjadi karakter pertama.	sub01
SrcLanguage	string	Yes	Bahasa sumber. Nilai yang valid: en-US: English zh-CN: Chinese ru-RU: Russian	zh-CN
DstLanguage	string	No	Bahasa tujuan untuk translation. Nilai yang valid: en-US: English zh-CN: Chinese es-ES: Spanish ru-RU: Russian	zh-CN
FontColor	string	No	Warna font dalam format RGBA.	0xFFFFFF
FontName	string	No	Font. Nilai yang valid: KaiTi: Font KaiTi. Ini adalah nilai default. AlibabaPuHuiTi-Regular: Alibaba PuHuiTi Regular AlibabaPuHuiTi-Bold: Alibaba PuHuiTi Bold AlibabaPuHuiTi-Light: Alibaba PuHuiTi Light NotoSansHans-Regular: Noto Sans CJK SC Regular NotoSansHans-Bold: Noto Sans CJK SC Bold NotoSansHans-Light: Noto Sans CJK SC Light	KaiTi
BgColor	string	No	Warna latar belakang caption dalam format RGBA.	0xFF0000
PositionNormalized	array	Yes	Posisi caption.
	number	No	Posisi caption. Koordinat didasarkan pada sumbu x dan y, dengan origin (0,0) berada di pojok kiri bawah layar. Catatan Koordinat x dan y harus dinormalisasi. Nilai aktual dihitung dengan mengalikan nilai ternormalisasi dengan tinggi video. Misalnya, jika tinggi video adalah 720p dan Anda mengatur PositionNormalized ke [0.1,0.5], posisi aktual caption berada di x = 72 dan y = 360.	[0.32,0.27]
ShowSourceLan	boolean	No	Menentukan apakah bahasa sumber ditampilkan. Nilai default adalah false.	true
MaxLines	integer	No	Jumlah baris yang ditampilkan.	2
WordPerLine	integer	Yes	Jumlah karakter yang ditampilkan per baris. Nilai yang valid: 1 hingga 500.	20
FontSizeNormalized	number	Yes	Ukuran font. Nilai yang valid: 0 hingga 1.	0.037
BorderWidthNormalized	number	No	Ketebalan font. Nilai yang valid: 0 hingga 1.	0.05
BgWidthNormalized	number	No	Ukuran latar belakang caption. Nilai yang valid: 0 hingga 1.	0.09
CopyFrom	string	No	Templat caption tempat menyalin pengaturan. Tetapkan parameter ini ke nama templat sumber.	sub01
Description	string	No	Deskripsi kustom untuk templat caption. Deskripsi dapat berisi karakter Tionghoa, huruf Inggris, angka, dan karakter khusus. Panjang deskripsi maksimal 128 karakter.	live AI subtitle template
Width	string	No	Lebar video pratinjau, dalam piksel.	1280
Height	string	No	Tinggi video pratinjau, dalam piksel. Resolusi video pratinjau (Width × Height) harus salah satu dari berikut: Landscape LD (360p): 640 × 360 Portrait LD (360p): 360 × 640 Landscape SD (480p): 854 × 480 Portrait SD (480p): 480 × 854 Landscape HD (720p): 1280 × 720 Portrait HD (720p): 720 × 1280 Landscape FHD (1080p): 1920 × 1080 Portrait FHD (1080p): 1080 × 1920	720

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	5c6a2a0df228-4a64-af62-20e91b96****
SubtitleId	string	ID templat caption.	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	Description
400	InvalidParameter	%s.	Parameter error
400	MissingParameter	%s.	Missing parameter
400	InvalidParameter.Malformed	There are invalid parameters: %s.	There are invalid parameters: %s.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.