Lindungi Privasi Image dengan Mosaic & Blur melalui AddImageMosaic - Intelligent Media Management - Alibaba Cloud - Intelligent Media Management

Menambahkan pola mosaik, Gaussian blur, atau blok warna solid dalam berbagai bentuk ke satu atau beberapa area tertentu pada gambar, dan menyimpan gambar yang telah diproses ke alamat objek file OSS yang ditentukan. Fitur ini terutama digunakan untuk perlindungan privasi.

Deskripsi operasi

Sebelum menggunakan operasi ini, pastikan Anda sudah memahami penagihan Intelligent Media Management dan harganya.
Sebelum memanggil operasi ini, pastikan project tersedia di region saat ini. Untuk informasi lebih lanjut, lihat Manajemen project.
Operasi ini mendukung gambar input dalam format JPG dan PNG. Panjang maksimum satu sisi adalah 30.000 piksel, dan jumlah total piksel tidak boleh melebihi 250 juta.

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

imm:AddImageMosaic

none

*Project

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ProjectName	string	Yes	Nama project. Untuk informasi tentang cara mendapatkan nama project, lihat Membuat project.	test-project
SourceURI	string	Yes	URI OSS dari gambar sumber. URI OSS mengikuti format oss://${Bucket}/${Object}, di mana `${Bucket}` adalah nama bucket OSS di region yang sama dengan project saat ini, dan `${Object}` adalah path lengkap file termasuk ekstensi nama file. Format gambar yang didukung: JPG, PNG, TIFF, JP2, dan BMP.	oss://examplebucket/sampleobject.jpg
TargetURI	string	Yes	URI OSS untuk menyimpan gambar output. URI OSS mengikuti format oss://${Bucket}/${Object}, di mana `${Bucket}` adalah nama bucket OSS di region yang sama dengan project saat ini, dan `${Object}` adalah path lengkap file termasuk ekstensi nama file.	oss://examplebucket/outputImage.jpg
ImageFormat	string	No	Format encoding untuk menyimpan gambar. Nilai yang valid: jpg, png, dan webp. Nilai default: format yang sama dengan gambar input. Valid values: jpg : jpg png : png webp : webp	jpg
Quality	integer	No	Kualitas kompresi gambar output. Parameter ini hanya berlaku untuk format JPG dan WebP. Nilai yang valid: 0 hingga 100. Nilai default: 80.	80
Targets	array<object>	Yes	Array parameter area pemrosesan dan tipe operasi.
	array<object>	No	Parameter area pemrosesan dan tipe operasi.
Type	string	Yes	Tipe mosaik yang akan ditambahkan. Nilai yang valid: square: mosaik persegi diamond: mosaik berbentuk berlian hexagon: mosaik heksagonal beraturan blur: Gaussian blur pure: blok warna solid.	square
Boundary	object	Yes	Informasi posisi area pemrosesan.
ReferPos	string	No	Posisi referensi area pemrosesan pada gambar. Nilai yang valid: topright: sudut kanan atas topleft (default): sudut kiri atas bottomright: sudut kanan bawah bottomleft: sudut kiri bawah.	topleft
X	number	Yes	Offset horizontal area pemrosesan relatif terhadap titik referensi. Arti bervariasi berdasarkan nilainya: Bilangan bulat non-negatif: jarak horizontal dari posisi referensi, dalam px. Desimal: rasio jarak horizontal dalam piksel terhadap lebar keseluruhan gambar. Nilai yang valid: [0,1).	0
Y	number	Yes	Offset vertikal area pemrosesan relatif terhadap titik referensi. Arti bervariasi berdasarkan nilainya: Bilangan bulat non-negatif: jarak vertikal dari posisi referensi, dalam px. Desimal: rasio jarak vertikal dalam piksel terhadap tinggi keseluruhan gambar. Nilai yang valid: [0,1).	0
Height	number	Yes	Tinggi area pemrosesan. Arti bervariasi berdasarkan nilainya: Bilangan bulat non-negatif: tinggi area pemrosesan, dalam px. Desimal: rasio panjang vertikal dalam piksel terhadap tinggi keseluruhan gambar. Nilai yang valid: [0,1).	200
Width	number	Yes	Lebar area pemrosesan. Arti bervariasi berdasarkan nilainya: Bilangan bulat non-negatif: lebar area pemrosesan, dalam px. Desimal: rasio panjang horizontal dalam piksel terhadap lebar keseluruhan gambar. Nilai yang valid: [0,1).	200
MosaicRadius	integer	No	Radius blok mosaik. Nilai default: 5. Satuan: px. Catatan Parameter ini tidak berlaku untuk Gaussian blur atau blok warna solid.	5
BlurRadius	integer	No	Radius blur untuk Gaussian blur. Nilai yang valid: 1 hingga 50. Nilai default: 3. Satuan: px. Catatan Parameter ini hanya berlaku saat Gaussian blur diterapkan.	3
Sigma	integer	No	Standar deviasi untuk Gaussian blur. Nilainya harus lebih besar dari 0. Nilai default: 5. Catatan Parameter ini hanya berlaku saat Gaussian blur diterapkan.	5
Color	string	No	Warna blok warna solid. Mendukung format `#FFFFFF` dan kata kunci preset seperti `red` dan `white`. Nilai default: #FFFFFF (putih). Catatan Parameter ini hanya berlaku saat blok warna solid diterapkan.	#FFFFFF
CredentialConfig	CredentialConfig	No	Biarkan parameter ini kosong kecuali Anda memiliki persyaratan khusus. Konfigurasi otorisasi China. Parameter ini bersifat opsional. Untuk informasi lebih lanjut, lihat Menggunakan otorisasi berantai untuk mengakses sumber daya entitas lain.

Elemen respons

Element	Type	Description	Example
	object	Skema Respons
RequestId	string	ID permintaan.	CA995EFD-083D-4F40-BE8A-BDF75FF*****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "CA995EFD-083D-4F40-BE8A-BDF75FF*****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.