Stitch Gambar Secara Batch dalam Skala Besar melalui CreateImageSplicingTask-IMM-Alibaba Cloud - Intelligent Media Management

Menggabungkan beberapa gambar menjadi satu gambar berdasarkan aturan yang ditentukan dan menyimpan hasilnya ke alamat objek OSS yang ditentukan.

Deskripsi operasi

Sebelum menggunakan operasi ini, pastikan Anda telah memahami penagihan Intelligent Media Management (IMM). Untuk informasi selengkapnya, lihat Penagihan.
Sebelum memanggil operasi ini, pastikan Proyek tersedia di Wilayah saat ini. Untuk informasi selengkapnya, lihat Manajemen proyek.
Operasi ini mendukung penggabungan hingga 10 gambar. Panjang setiap sisi gambar tidak boleh melebihi 32.876 piksel, dan jumlah total piksel tidak boleh melebihi 1 miliar.
Ini adalah operasi asinkron. Setelah Tugas dimulai, informasi Tugas hanya disimpan selama 7 hari. Setelah 7 hari, informasi Tugas tidak dapat lagi diambil. Panggil GetTask atau ListTasks untuk mengkueri informasi Tugas menggunakan TaskId yang dikembalikan. Anda juga dapat mengonfigurasi Notifikasi untuk menerima informasi Tugas melalui notifikasi Paket.

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

create

*Project

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ProjectName	string	Yes	Nama Proyek. Untuk informasi tentang cara mendapatkan nama Proyek, lihat CreateProject.	test-project
Sources	array<object>	Yes	Daftar gambar input. Pesanan penggabungan mengikuti Pesanan URI dalam daftar input.
	object	No	Informasi gambar input.
URI	string	Yes	Alamat OSS gambar sumber. Alamat OSS mengikuti format oss://${Bucket}/${Object}, di mana `${Bucket}` adalah nama bucket OSS di wilayah yang sama dengan proyek saat ini, dan `${Object}` adalah jalur lengkap file termasuk ekstensi nama file. Format gambar yang didukung: JPG dan PNG.	oss://examplebucket/sampleobject.jpg
Rotate	integer	No	Sudut rotasi gambar. Nilai valid: 0 (default) 90 180	90
TargetURI	string	Yes	Alamat OSS untuk menyimpan gambar output. Alamat OSS mengikuti format oss://${bucketname}/${objectname}, di mana ${bucketname} adalah nama Bucket OSS di Wilayah yang sama dengan Proyek saat ini, dan ${objectname} adalah jalur file termasuk nama file.	oss://examplebucket/outputImage.jpg
ImageFormat	string	No	Format kompresi gambar output. Nilai valid: jpg (default) png webp. Valid values: jpg : jpg. png : png. webp : webp.	jpg
Quality	integer	No	Kualitas kompresi gambar output. Parameter ini hanya berlaku untuk format gambar JPG dan WebP. Nilai valid: 0 hingga 100. Nilai default: 80.	80
Direction	string	No	Metode penggabungan gambar. Nilai valid: vertical (default): Memperluas secara vertikal. Semua gambar yang akan digabungkan harus disejajarkan berdasarkan lebar. horizontal: Memperluas secara horizontal. Semua gambar yang akan digabungkan harus disejajarkan berdasarkan tinggi.	vertical
ScaleType	string	No	Metode penskalaan yang digunakan saat menyelaraskan lebar atau tinggi gambar yang akan digabungkan. Nilai valid: fit (default): Menskalakan secara proporsional tanpa menambahkan batas hitam. stretch: Meregangkan untuk mengisi.	stretch
Align	integer	No	Nilai piksel tempat lebar atau tinggi gambar yang akan digabungkan disejajarkan. Nilai valid: 1 hingga 4096. Jika parameter Direction diatur ke `vertical`, parameter ini menentukan nilai piksel untuk penyelarasan lebar. Jika parameter Direction diatur ke `horizontal`, parameter ini menentukan nilai piksel untuk penyelarasan tinggi. Catatan Jika parameter ini tidak ditentukan (default), lebar atau tinggi gambar pertama dalam penggabungan akan digunakan.	192
Padding	integer	No	Jarak antar sub-gambar dalam gambar gabungan. Nilai default: 0. Unit: px.	2
Margin	integer	No	Margin kosong pada gambar gabungan. Nilai default: 0. Unit: px.	2
BackgroundColor	string	No	Warna isian untuk area yang sesuai dengan parameter Padding dan Margin. Parameter ini mendukung format `#FFFFFF` dan kata kunci preset seperti `red` dan `alpha`.	red
UserData	string	No	Informasi kustom yang dikembalikan dalam notifikasi Paket asinkron untuk membantu Anda mengaitkan notifikasi Paket dalam sistem Anda. Panjang maksimum: 2.048 byte.	test-data
CredentialConfig	CredentialConfig	No	Konfigurasi otorisasi China. Untuk informasi selengkapnya, lihat Otorisasi China untuk mengakses resource entitas lain.
Tags	object	No	Tag kustom yang digunakan untuk mencari dan memfilter tugas asinkron.	{ "User": "Jane" }
Notification	Notification	No	Konfigurasi notifikasi Paket. Untuk informasi selengkapnya, klik Notifikasi. Untuk informasi tentang format notifikasi Paket asinkron, lihat Format notifikasi Paket asinkron.

Elemen respons

Element	Type	Description	Example
	object	Hasil penggabungan gambar.
RequestId	string	ID permintaan.	94D6F994-E298-037E-8E8B-0090F27*****
EventId	string	ID event.	10C-1R6p7Km0H5Ieg38LKXTIvw*****
TaskId	string	ID tugas.	ImageSplicing-537cc157-7645-444a-a631-c8db4d02*****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "94D6F994-E298-037E-8E8B-0090F27*****",
  "EventId": "10C-1R6p7Km0H5Ieg38LKXTIvw*****",
  "TaskId": "ImageSplicing-537cc157-7645-444a-a631-c8db4d02*****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.