Bagaimana cara menggunakan versi baru GetObject untuk memproses gambar? - Object Storage Service

Anda dapat menentukan parameter Pemrosesan Gambar (IMG) dalam permintaan GetObject untuk memproses objek gambar di Object Storage Service (OSS). Sebagai contoh, Anda dapat menambahkan watermark pada gambar atau mengonversi format gambar.

Parameter IMG

OSS memungkinkan Anda menggunakan satu atau lebih parameter untuk memproses gambar. Anda juga dapat mengenkapsulasi beberapa parameter IMG dalam gaya dan menggunakan gaya tersebut untuk memproses gambar. Untuk informasi lebih lanjut tentang gaya gambar, lihat Gaya gambar.

Jika Anda menentukan beberapa parameter IMG, OSS akan memproses gambar berdasarkan parameter dalam urutan yang ditentukan. Tabel berikut menjelaskan parameter IMG.

Operasi	Parameter	Deskripsi
Mengubah ukuran	resize	Mengubah ukuran gambar.
Menambahkan watermark	watermark	Menambahkan watermark gambar atau watermark teks ke gambar.
Pemotongan kustom	crop	Memotong gambar persegi panjang berdasarkan ukuran tertentu.
Penyesuaian kualitas gambar	quality	Menyesuaikan kualitas gambar dalam format JPG dan WebP.
Konversi format	format	Mengonversi format gambar ke format yang ditentukan.
Kompresi tingkat lanjut untuk gambar HEIF atau AVIF	format	Mengonversi format gambar ke HEIF atau AVIF yang menyediakan efisiensi kompresi tinggi
Kueri informasi gambar	info	Mendapatkan informasi gambar, termasuk informasi dasar dan informasi Format File Gambar yang Dapat Ditukar (EXIF).
Orientasi otomatis	auto-orient	Memutar gambar secara otomatis.
Pemotongan lingkaran	circle	Memotong gambar menjadi lingkaran dengan ukuran tertentu berdasarkan titik tengah gambar.
Potongan indeks	indexcrop	Memotong gambar sepanjang sumbu horizontal atau vertikal tertentu dan memilih salah satu dari gambar tersebut.
Persegi panjang dengan sudut membulat	rounded-corners	Memotong gambar menjadi persegi panjang dengan sudut membulat berdasarkan radius bulat yang ditentukan.
Blur	blur	Memburamkan gambar.
Rotasi	rotate	Memutar gambar searah jarum jam dengan sudut tertentu.
Tampilan bertahap	interlace	Mengonfigurasi tampilan bertahap untuk gambar JPG.
Kueri rata-rata warna	average-hue	Meminta rata-rata warna gambar.
Penyesuaian kecerahan	bright	Menyesuaikan kecerahan gambar.
Peningkatan ketajaman	sharpen	Memperjelas gambar.
Penyesuaian kontras	contrast	Menyesuaikan kontras gambar.

Sebagai contoh, jika Anda menambahkan parameter resize dan quality untuk memproses gambar example.jpg, URL gambar tersebut adalah 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 balik ke asal CDN Alibaba Cloud untuk menyaring atau mempertahankan parameter IMG yang terkandung dalam URL gambar yang ingin Anda ambil. Dengan cara ini, Anda dapat mengambil gambar sumber atau gambar yang diproses menggunakan parameter IMG.

Ambil gambar sumber
Anda dapat mengaktifkan fitur penyaringan parameter CDN Alibaba Cloud untuk menyaring semua parameter setelah tanda tanya (?) dalam URL gambar yang ingin Anda ambil. Dalam contoh ini, gambar sumber example.jpg diambil.
Ambil gambar yang diproses
Anda dapat mengaktifkan fitur penyimpanan parameter CDN Alibaba Cloud untuk mempertahankan semua parameter setelah tanda tanya (?) dalam URL gambar yang ingin Anda ambil. Dalam contoh ini, gambar yang diproses diambil.

Untuk informasi lebih lanjut tentang aturan balik ke asal CDN Alibaba Cloud, lihat Abaikan parameter.

Metode IMG

Anda dapat menggunakan URL objek, operasi API, dan SDK untuk memproses gambar. Untuk informasi lebih lanjut, lihat Mode implementasi IMG.

Batasan

Item	Deskripsi
Format gambar	Hanya gambar JPG, PNG, BMP, GIF, WebP, TIFF, HEIC, dan AVIF yang didukung. Hanya pengubahan ukuran, pemotongan, rotasi, dan penambahan watermark yang didukung untuk gambar dinamis, seperti gambar GIF. Jika Anda ingin mengkodekan atau mendekode gambar dinamis dalam format WebP, submit a ticket.
Ukuran gambar	Ukuran gambar sumber tidak boleh melebihi 20 MB.
Lebar dan tinggi gambar	Untuk operasi rotasi, tinggi atau lebar gambar sumber tidak boleh melebihi 4.096 piksel. Untuk operasi lainnya, lebar atau tinggi gambar sumber tidak boleh melebihi 30.000 piksel, dan jumlah total piksel gambar sumber tidak boleh melebihi 250 juta. Jumlah total piksel gambar dinamis, seperti gambar GIF, dihitung berdasarkan rumus berikut: `Lebar × Tinggi × Jumlah frame gambar`. Jumlah total piksel gambar statis, seperti gambar PNG, dihitung berdasarkan rumus berikut: `Lebar × Tinggi`.
Kompresi gambar	Lebar atau tinggi gambar yang dikompresi tidak boleh melebihi 16.384 piksel. Jumlah total piksel gambar yang dikompresi tidak boleh melebihi 16.777.216.
Kompresi gambar tingkat lanjut	Jumlah piksel gambar HEIC yang dikompresi tidak boleh melebihi 4.096 × 4.096. Jumlah piksel gambar AVIF yang dikompresi tidak boleh melebihi 4.096 × 2.304.
Gaya gambar	Anda dapat membuat hingga 50 gaya gambar untuk setiap bucket. Jika bisnis Anda memerlukan lebih dari 50 gaya untuk sebuah bucket, submit a ticket. Catatan Anda dapat menyertakan beberapa parameter IMG dalam gaya gambar untuk melakukan operasi kompleks pada gambar yang disimpan dalam bucket. Untuk informasi lebih lanjut, lihat Gaya gambar.
Kemampuan pemrosesan	Throughput pemrosesan per detik (berdasarkan gambar sumber) Throughput maksimum pemrosesan gambar adalah 20 MB/s untuk wilayah berikut: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), dan China (Shenzhen). Throughput maksimum pemrosesan gambar untuk wilayah lainnya adalah 2 MB/s. Queries per second (QPS) Batas QPS adalah 50 untuk China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), dan China (Shenzhen). Batas QPS untuk wilayah lainnya adalah 5. Catatan Anda mungkin ingin melampaui batas-batas di atas dalam aplikasi bisnis yang intensif komputasi, seperti mengkodekan gambar WebP, AVIF, atau HEIF dengan resolusi lebih tinggi dari 1080p. Untuk meningkatkan batas, hubungi technical support.

Penagihan

Anda akan dikenakan biaya berikut saat menggunakan IMG:

Biaya panggilan operasi API
Permintaan GetObject dihasilkan setiap kali Anda menggunakan IMG untuk memproses gambar. Anda akan dikenakan biaya berdasarkan jumlah permintaan yang dihasilkan. Untuk informasi lebih lanjut, lihat Biaya permintaan.
Biaya trafik
Anda akan dikenakan biaya untuk trafik keluar melalui Internet berdasarkan ukuran gambar yang diproses. Untuk informasi lebih lanjut, lihat Biaya trafik.

Versi IMG

IMG menyediakan dua versi operasi API. Topik ini menjelaskan versi baru dari operasi API. Dukungan pembaruan tidak lagi disediakan untuk versi lama. Untuk informasi lebih lanjut tentang kompatibilitas versi baru dan lama operasi API, lihat Perbedaan antara versi lama dan baru IMG.