Bangun Template Live AI Studio dengan API CreateLiveAIStudio - ApsaraVideo Live - Alibaba Cloud - ApsaraVideo Live

Membuat template studio virtual ringan.

Deskripsi operasi

Penting Fitur studio virtual ringan sedang dalam pratinjau publik. Setiap pengguna dapat membuat hingga 300 template. Fitur ini gratis selama pratinjau publik. Setelah pratinjau publik berakhir, biaya standar akan berlaku. Tanggal spesifik akan diumumkan secara terpisah.

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

create

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah.	cn-shanghai
StudioName	string	Yes	Nama template studio virtual. Nama harus unik.	stu02
Description	string	No	Deskripsi kustom.	template 1080
Width	integer	No	Lebar layar pratinjau. Satuan: px.	1920
Height	integer	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.	1080
BackgroundType	string	No	Jenis materi latar belakang. Nilai yang valid: VOD: video sesuai permintaan. PIC: gambar. LIVE: siaran langsung. Valid values: VOD : video sesuai permintaan. PIC : gambar. LIVE : siaran langsung.	VOD
BackgroundResourceId	string	No	ID sumber daya video sesuai permintaan dari materi latar belakang. Dapatkan nilai ini dari konsol ApsaraVideo VOD.	d0eb493192c771efba644531858c0102
BackgroundResourceUrl	string	No	URL akses materi latar belakang. Tentukan parameter ini atau ID sumber daya.	https://xxx.com/1.mp4
MediaType	string	No	Jenis materi multimedia. Nilai yang valid: VOD: video sesuai permintaan. PIC: gambar. LIVE: siaran langsung. Valid values: VOD : video sesuai permintaan. PIC : gambar. LIVE : siaran langsung.	VOD
MediaResourceId	string	No	ID sumber daya video sesuai permintaan dari materi multimedia. Dapatkan nilai ini dari konsol ApsaraVideo VOD.	d0eb493192c771efba644531858c0102
MediaResourceUrl	string	No	URL akses materi multimedia. Tentukan parameter ini atau ID sumber daya.	https://xxx.com/2.mp4
MediaLayout	object	No	Informasi posisi tata letak materi multimedia.
PositionX	number	No	Koordinat x posisi. Nilai yang valid: 0 hingga 1. Posisi materi didasarkan pada sudut kiri atas sebagai titik referensi.	0
PositionY	number	No	Koordinat y posisi. Nilai yang valid: 0 hingga 1. Posisi materi didasarkan pada sudut kiri atas sebagai titik referensi.	0
HeightNormalized	number	No	Tinggi material yang dinormalisasi, yaitu rasio tinggi material terhadap tinggi latar belakang. Nilai yang valid: 0 hingga 1.	0.5
MattingType	string	Yes	Jenis matting gambar. Nilai yang valid: green: matting layar hijau. blue: matting layar biru. complex: matting pemandangan nyata. Valid values: green : matting gambar dengan layar hijau. blue : matting layar biru. complex : matting pemandangan nyata.	complex
MattingLayout	object	Yes	Informasi posisi tata letak aliran sumber setelah matting gambar.
PositionX	number	No	Koordinat x posisi. Nilai yang valid: 0 hingga 1. Posisi materi didasarkan pada sudut kiri atas sebagai titik referensi.	0.3
PositionY	number	No	Koordinat y posisi. Nilai yang valid: 0 hingga 1. Posisi materi didasarkan pada sudut kiri atas sebagai titik referensi.	0.3
HeightNormalized	number	No	Tinggi material yang dinormalisasi, yaitu rasio tinggi material terhadap tinggi latar belakang. Nilai yang valid: 0 hingga 1.	0.5

Elemen respons

Element	Type	Description	Example
	object	Struktur respons.
RequestId	string	ID permintaan.	17D7526C-69AD-5761-8037-071C27358345
StudioId	string	ID template studio.	369ced1f-c33a-49e5-91da-bdaae3d6c1c2

Contoh

Respons sukses

JSONformat

{
  "RequestId": "17D7526C-69AD-5761-8037-071C27358345",
  "StudioId": "369ced1f-c33a-49e5-91da-bdaae3d6c1c2"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	LiveServiceNotFound	%s, please check and try again later.
400	InvalidParameter.PurchaseTime	%s, please check and try again later.
400	InvalidParameter.ExpireTime	%s, please check and try again later.
400	InvalidParameter	%s.
400	MissingParameter	%s.
400	InvalidChargeType.Malformed	%s, please check and try again later.
400	InvalidChargeType.PostSupport	%s, please check and try again later.
400	InvalidCasterTemplate.Malformed	%s, please check and try again later.
400	InvalidParameter.Malformed	There are invalid parameters: %s.
400	InvalidParameter.ChargeType	%s, please check and try again later.
400	InvalidPeriod.Malformed	%s, please check and try again later.
400	InvalidUserId.Malformed	%s, please check userId.
400	InvalidClientToken.Malformed	%s, please check and try again later.
400	IncorrectCasterStatus	%s, please check and try again later.
401	CasterNumberExceed	%s, please check and try again later.
403	PermissionDenied	%s, please check and try again later.
404	InvalidParameter.NormType	%s, please check and try again later.
404	InvalidConfiguration.NotFound	%s, please check and try again later.
408	CreateLiveAIStudio.Timeout	%s, please try again later.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.