Anda dapat memproses gambar yang disimpan di Object Storage Service (OSS) dengan menyertakan parameter Image Processing (IMG) dalam permintaan GetObject, misalnya untuk menambahkan watermark atau mengonversi format gambar.
Parameter IMG
Anda dapat memproses gambar di OSS menggunakan satu atau beberapa parameter. Beberapa parameter tersebut juga dapat digabungkan ke dalam gaya gambar untuk memproses gambar secara Batch. Untuk informasi selengkapnya tentang gaya gambar, lihat Gaya gambar.
Jika Anda menentukan beberapa parameter IMG, OSS akan memproses gambar sesuai dengan urutan parameter yang ditentukan. Tabel berikut menjelaskan parameter IMG tersebut.
Tindakan | Parameter | Deskripsi |
resize | Mengubah ukuran gambar sesuai dimensi yang ditentukan. | |
watermark | Menambahkan watermark berupa gambar atau teks ke gambar. | |
crop | Memotong gambar menjadi persegi panjang dengan ukuran tertentu. | |
quality | Menyesuaikan kualitas gambar JPG dan WebP. | |
format | Mengonversi format gambar. | |
format | Mengonversi gambar ke format kompresi tinggi, seperti HEIF atau AVIF. | |
info | Mengambil informasi gambar, seperti properti dasar dan data Exchangeable Image File Format (EXIF). | |
auto-orient | Secara otomatis memutar gambar berdasarkan metadata orientasinya. | |
circle | Memotong gambar menjadi bentuk lingkaran dengan ukuran tertentu, berpusat pada gambar asli. | |
indexcrop | Memotong gambar menjadi beberapa bagian sepanjang sumbu x atau y dan memilih salah satu irisannya. | |
rounded-corners | Memotong gambar menjadi persegi panjang dengan sudut membulat berjari-jari tertentu. | |
blur | Menerapkan efek buram pada gambar. | |
rotate | Memutar gambar searah jarum jam dengan sudut tertentu. | |
interlace | Mengaktifkan rendering progresif untuk gambar dalam format JPG. | |
average-hue | Mengambil rata-rata warna gambar. | |
bright | Menyesuaikan kecerahan gambar. | |
sharpen | Menerapkan efek penajaman pada gambar. | |
contrast | Menyesuaikan kontras gambar. |
Sebagai contoh, jika Anda menambahkan parameter resize untuk mengubah ukuran gambar dan parameter quality untuk menyesuaikan kualitas pada gambar sumber example.jpg, URL-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 CDN mengambil gambar sumber atau gambar yang telah diproses selama permintaan back-to-origin.
Back-to-origin untuk gambar sumber
Mengaktifkan penyaringan parameter pada CDN akan menghapus semua parameter setelah tanda tanya (?) dalam URL permintaan, sehingga permintaan langsung mengakses gambar sumber
example.jpg.Back-to-origin untuk gambar yang telah diproses
Jika Anda mengonfigurasi CDN untuk mempertahankan parameter, permintaan back-to-origin akan menyertakan semua parameter setelah tanda tanya (?), sehingga CDN mengambil gambar yang telah diproses.
Untuk informasi selengkapnya tentang cara mengonfigurasi aturan back-to-origin CDN, lihat Abaikan parameter.
Metode IMG
Anda dapat memproses gambar melalui URL objek, operasi API, atau SDK. Untuk informasi selengkapnya, lihat Metode pemrosesan gambar.
Batasan
Item | Deskripsi |
Format gambar |
|
Ukuran gambar | Gambar sumber tidak boleh melebihi 20 MB. |
Dimensi gambar sumber | Untuk rotasi, lebar atau tinggi gambar sumber tidak boleh melebihi 4.096 px. Untuk semua operasi lainnya, lebar atau tinggi tidak boleh melebihi 30.000 px, dan jumlah total piksel tidak boleh melebihi 250 juta. Jumlah total piksel untuk gambar dinamis, seperti gambar GIF, adalah |
Dimensi gambar hasil |
|
Ubah ukuran gambar | Setelah diubah ukurannya, lebar atau tinggi gambar tidak boleh melebihi 16.384 px, dan jumlah total piksel tidak boleh melebihi 16.777.216. |
Gaya gambar | Anda dapat membuat maksimal 50 gaya gambar per bucket. Jika bisnis Anda memerlukan lebih banyak gaya, submit a ticket. Catatan Anda dapat menyertakan beberapa parameter IMG dalam satu gaya gambar untuk melakukan operasi kompleks secara efisien. Untuk informasi selengkapnya, lihat Gaya gambar. |
Kapasitas pemrosesan |
Catatan Untuk skenario yang membutuhkan daya komputasi tinggi, seperti encode gambar WebP, AVIF, atau HEIF dengan resolusi di atas 1080p, atau jika beban kerja Anda melebihi batas ini, hubungi technical support untuk mengevaluasi batas spesifik sesuai kasus penggunaan Anda. |
Penagihan
Penggunaan IMG dikenai biaya sebagai berikut:
Biaya permintaan
Setiap operasi pemrosesan gambar menghasilkan satu permintaan GetObject, yang dikenai biaya per permintaan. Untuk informasi selengkapnya, lihat Biaya permintaan.
Biaya traffic
Biaya traffic keluar dihitung berdasarkan ukuran gambar yang telah diproses. Untuk informasi selengkapnya, lihat Biaya traffic.
Versi IMG
Layanan Image Processing (IMG) menyediakan versi API baru dan lama. Dokumen ini menjelaskan versi API baru karena versi lama tidak lagi diperbarui. Untuk informasi selengkapnya tentang kompatibilitas antara kedua versi tersebut, lihat Versi baru dan lama IMG serta kompatibilitasnya.