Pemrosesan untuk objek gambar - Image Processing - Object Storage Service

Anda dapat memproses gambar yang disimpan di Object Storage Service (OSS) dengan menambahkan parameter pemrosesan ke permintaan GetObject, seperti menambahkan Watermark atau mengonversi format.

Parameter pemrosesan

Anda dapat memproses gambar yang disimpan di Object Storage Service (OSS) menggunakan satu atau beberapa parameter, atau membungkus beberapa parameter dalam gaya gambar untuk memprosesnya secara Batch. Untuk informasi selengkapnya tentang gaya gambar, lihat Gaya gambar.

Jika Anda menentukan beberapa parameter pemrosesan, OSS menerapkannya sesuai urutan yang diberikan. Tabel berikut menjelaskan parameter pemrosesan tersebut.

Tindakan	Parameter	Deskripsi
Ubah ukuran	resize	Mengubah ukuran gambar ke dimensi yang ditentukan.
Watermarking	watermark	Menambahkan Watermark berupa gambar atau teks ke gambar.
Pemotongan kustom	crop	Memotong gambar menjadi persegi panjang dengan dimensi yang ditentukan.
Penyesuaian kualitas	quality	Menyesuaikan kualitas gambar dalam format JPG dan WebP.
Konversi format	format	Mengonversi format gambar.
Kompresi lanjutan untuk gambar HEIF atau AVIF	format	Mengonversi gambar ke format HEIF atau AVIF, yang memberikan rasio kompresi tinggi.
Kueri informasi gambar	info	Mengambil informasi gambar, termasuk data dasar dan EXIF.
Orientasi otomatis	auto-orient	Secara otomatis memutar gambar berdasarkan parameter orientasinya.
Pemotongan lingkaran	circle	Memotong area berbentuk lingkaran dengan ukuran tertentu dari pusat gambar.
Irisan terindeks	indexcrop	Memotong gambar menjadi bagian-bagian dengan ukuran tertentu sepanjang sumbu x atau y dan mengembalikan salah satu bagiannya.
Persegi panjang dengan sudut membulat	rounded-corners	Memotong gambar menjadi persegi panjang dengan sudut membulat sesuai radius yang ditentukan.
Efek buram	blur	Memberikan efek buram pada gambar.
Rotasi	rotate	Memutar gambar searah jarum jam sesuai sudut yang ditentukan.
Tampilan bertahap	interlace	Mengaktifkan tampilan progresif untuk gambar JPG.
Kueri rata-rata warna	average-hue	Mengambil rata-rata warna gambar.
Penyesuaian kecerahan	bright	Menyesuaikan kecerahan gambar.
Pengasahan	sharpen	Mempertajam gambar.
Penyesuaian kontras	contrast	Menyesuaikan kontras gambar.

Sebagai contoh, setelah Anda menambahkan parameter resize untuk mengubah ukuran gambar dan quality untuk menyesuaikan kualitas pada gambar sumber example.jpg, URL file-nya menjadi https://oss-console-img-demo-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_300/quality,q_90. Anda dapat mengonfigurasi aturan berbeda agar Alibaba Cloud CDN mengambil gambar sumber atau gambar yang telah diproses selama proses back-to-origin.

Ambil gambar sumber

Setelah Anda mengaktifkan penyaringan parameter di Alibaba Cloud CDN, semua parameter setelah tanda tanya (?) dihapus dari URL permintaan, sehingga permintaan langsung mengakses gambar sumber example.jpg.
Ambil gambar yang telah diproses

Aktifkan retensi parameter di Alibaba Cloud CDN untuk menyimpan semua parameter setelah tanda tanya (?) dalam URL permintaan. Permintaan back-to-origin kemudian akan mengambil gambar yang telah diproses.

Untuk informasi selengkapnya tentang cara mengonfigurasi aturan back-to-origin untuk Alibaba Cloud CDN, lihat Abaikan parameter.

Metode pemrosesan gambar

Anda dapat memproses gambar menggunakan URL objek, Operasi API, atau SDK. Untuk informasi selengkapnya, lihat Metode pemrosesan gambar.

Batasan

Parameter	Deskripsi
Format gambar	Gambar sumber harus dalam salah satu format berikut: JPG, PNG, BMP, GIF, WebP, TIFF, HEIC, atau AVIF. Untuk gambar dinamis, seperti GIF, hanya operasi mengubah ukuran, memotong, rotasi, dan watermarking yang didukung. Untuk encode atau decode gambar WebP dinamis, submit a ticket untuk mengaktifkan fitur ini.
Ukuran gambar	Gambar sumber tidak boleh melebihi 20 MB.
Lebar dan tinggi gambar	Lebar atau tinggi maksimum gambar sumber adalah 4.096 px untuk rotasi. Untuk semua operasi lainnya, maksimumnya adalah 30.000 px, dan jumlah total piksel tidak boleh melebihi 250 juta. Jumlah total piksel untuk gambar dinamis, seperti gambar GIF, dihitung sebagai `width * height * number of frames`. Jumlah total piksel untuk gambar statis, seperti gambar PNG, dihitung sebagai `width * height`. Catatan Saat Anda mengonversi gambar ke format WebP, lebar dan tinggi gambar sumber masing-masing tidak boleh melebihi 16.383 px. Jika tidak, konversi akan gagal.
Kompresi gambar	Setelah mengubah ukuran, lebar atau tinggi gambar output tidak boleh melebihi 16.384 px, dan jumlah total piksel tidak boleh melebihi 16.777.216.
Kompresi gambar lanjutan	Setelah mengubah ukuran, dimensi gambar HEIC tidak boleh melebihi 4.096 × 4.096 px, dan dimensi gambar AVIF tidak boleh melebihi 4.096 × 2.304 px.
Gaya gambar	Anda dapat membuat hingga 50 gaya gambar per bucket. Jika bisnis Anda memerlukan lebih banyak gaya, kirimkan Tiket. Catatan Anda dapat menyertakan beberapa parameter pemrosesan dalam satu gaya gambar untuk melakukan transformasi gambar kompleks. Untuk informasi selengkapnya, lihat Gaya gambar.
Kemampuan pemrosesan	Throughput (berdasarkan ukuran gambar sumber) China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), dan China (Shenzhen): 20 MB/s. Wilayah lain: 2 MB/s. permintaan per detik (QPS) China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), dan China (Shenzhen): 50. Wilayah lain: 5. Catatan Untuk skenario intensif komputasi, seperti encode gambar WebP, AVIF, atau HEIF dengan resolusi di atas 1080p, atau jika Anda perlu melebihi batas ini, hubungi technical support untuk mengevaluasi kebutuhan penggunaan spesifik Anda.

Penagihan

Biaya berikut berlaku untuk layanan Pemrosesan Gambar (IMG):

Biaya permintaan

Setiap operasi pemrosesan gambar menghasilkan satu permintaan GetObject, dan penagihan didasarkan pada jumlah total permintaan. Untuk informasi selengkapnya, lihat Biaya permintaan.
Biaya traffic

Anda dikenai biaya untuk lalu lintas outbound melalui internet berdasarkan ukuran gambar yang telah diproses. Untuk informasi selengkapnya, lihat Biaya traffic.

Versi

Pemrosesan Gambar (IMG) menyediakan dua versi API. Topik ini menjelaskan versi API baru. Versi API lama tidak lagi diperbarui. Untuk informasi selengkapnya tentang kompatibilitas antara kedua versi tersebut, lihat Perbedaan antara versi lama dan baru IMG.