Model Wanxiang General Image Editing wan2.5 mengedit dan menggabungkan gambar berdasarkan instruksi teks semata, menjaga konsistensi subjek sepanjang proses pengeditan.
Ikhtisar model
Kemampuan model | Contoh input | Gambar output |
|---|---|---|
Single-image editing | ![]() | ![]() Ganti gaun bunga dengan gaun renda bergaya vintage yang memiliki sulaman halus pada kerah dan manset. |
Multi-image fusion | ![]() | ![]() Letakkan jam alarm dari gambar 1 di samping vas di atas meja makan pada gambar 2. |
Nama model | Deskripsi model | Spesifikasi gambar output |
|---|---|---|
wan2.5-i2i-preview | Wanxiang 2.5 preview Mendukung single-image editing dan multi-image fusion | Format gambar: PNG. Resolusi gambar:
|
Prasyarat
Sebelum melakukan panggilan, dapatkan Kunci API dan ekspor Kunci API sebagai Variabel lingkungan. Untuk melakukan panggilan menggunakan SDK, instal DashScope SDK.
Panggilan HTTP API
Pengeditan gambar memerlukan waktu 1–2 menit, sehingga API menggunakan pemanggilan asinkron: Buat tugas → Poll hasil.
Waktu proses aktual bervariasi tergantung panjang antrian dan beban layanan.
Langkah 1: Buat tugas dan dapatkan ID tugas
Wilayah Singapura: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
Wilayah Beijing: POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.
- Setelah tugas dibuat, gunakan
task_idyang dikembalikan untuk mengkueri hasil.task_idberlaku selama 24 jam. Jangan membuat tugas duplikat. Sebagai gantinya, gunakan polling untuk mengambil hasil. - Untuk panduan pemula, lihat Panggil API dengan Postman atau cURL.
Parameter permintaanHeader permintaanContent-Typestring (Wajib)Tipe konten permintaan. Harus application/json.Authorization string (Wajib)Mengotentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx.X-DashScope-Async string (Wajib)Mengaktifkan pemrosesan asinkron. Permintaan HTTP hanya mendukung panggilan asinkron. Harus enable.Body permintaanmodelstring (wajib)Nama model. Model yang didukung dan harga.Nilai contoh: wan2.5-i2i-preview.input object (wajib)Bidang input seperti prompt dan gambar.
Properti prompt string (wajib)Prompt positif yang menggambarkan elemen dan fitur visual yang harus dimasukkan dalam gambar yang dihasilkan.Mendukung bahasa Mandarin dan Inggris. Maksimum: 2000 karakter (setiap karakter dihitung satu); kelebihan akan dipotong.Untuk tips penulisan prompt, lihat Panduan prompt text-to-image.Nilai contoh: Seekor kucing oranye ceria sedang duduk, realistis dan detail.images array of string (wajib)Array URL gambar.
string (opsional)Prompt negatif yang menggambarkan elemen yang harus dikecualikan dari gambar.Mendukung bahasa Mandarin dan Inggris. Maksimum: 500 karakter; kelebihan akan dipotong.Nilai contoh: low resolution, errors, worst quality, low quality, incomplete, extra fingers, poor proportions.object (opsional)Mengontrol resolusi, penulisan ulang prompt, dan watermark.
Properti size string (opsional)Atur resolusi gambar output dalam format width×height. Default: 1280×1280.
Resolusi dan rasio aspek yang direkomendasikan
size dihilangkan, default-nya adalah 1280×1280 piksel dengan rasio aspek perkiraan:
integer (opsional)Jumlah gambar yang akan dihasilkan. Rentang: 1–4. Default: 4. Atur ke 1 saat pengujian untuk mengontrol biaya.watermark boolean (opsional)Menambahkan watermark “AI Generated” di pojok kanan bawah.
boolean (opsional)Mengaktifkan penulisan ulang prompt berbasis LLM untuk meningkatkan kualitas gambar. Menambahkan latensi.
integer (opsional)Bilangan acak seed. Rentang valid: [0, 2147483647].Jika dihilangkan, seed acak akan dihasilkan. Jika ditentukan, seed berurutan akan diberikan ke masing-masing dari n gambar berdasarkan n. Misalnya, jika n=4, seed-nya adalah: seed, seed+1, seed+2, seed+3.Untuk meningkatkan reproduktibilitas, tetapkan nilai seed.Seed identik tidak menjamin output identik karena generasi probabilistik. |
Parameter responsoutputobjectInformasi output tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
stringIdentifier permintaan unik untuk pelacakan dan troubleshooting.code stringKode kesalahan. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan.message stringPesan kesalahan detail. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan. |
Simpan task_id untuk mengkueri status tugas dan hasilnya. |
Langkah 2: Kueri hasil menggunakan ID tugas
- Singapura
- China (Beijing)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Saat memanggil, ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.- Rekomendasi polling: Generasi gambar memakan waktu. Gunakan mekanisme polling dengan interval yang wajar, misalnya 10 detik.
- Transisi status tugas: PENDING → RUNNING → SUCCEEDED atau FAILED.
- Tautan hasil: Setelah tugas berhasil, URL gambar yang berlaku selama 24 jam dikembalikan. Unduh dan simpan gambar ke penyimpanan permanen, seperti OSS.
Parameter permintaanHeader permintaanAuthorizationstring (Wajib)Mengotentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx.Parameter path URLtask_idstring (Wajib)ID tugas. |
Ganti 86ecf553-d340-4e21-xxxxxxxxx dengan task_id aktual Anda.Kunci API berbeda untuk setiap wilayah. Untuk informasi lebih lanjut, lihat Dapatkan Kunci API. Jika Anda menggunakan model di wilayah China (Beijing), ganti |
Parameter responsoutputobjectInformasi output tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
stringWaktu saat tugas diajukan. Waktu dalam UTC+8 dan formatnya YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringWaktu saat tugas dieksekusi. Waktu dalam UTC+8 dan formatnya YYYY-MM-DD HH:mm:ss.SSS.end_time stringWaktu saat tugas selesai. Waktu dalam UTC+8 dan formatnya YYYY-MM-DD HH:mm:ss.SSS.results array of objectDaftar hasil tugas, termasuk URL gambar, prompt, dan detail kesalahan untuk kegagalan parsial.
Properti orig_prompt stringPrompt input asli, sesuai dengan parameter permintaan prompt.actual_prompt stringPrompt yang dioptimalkan yang digunakan saat penulisan ulang prompt diaktifkan. Tidak dikembalikan saat dinonaktifkan.url stringURL gambar yang dihasilkan.code stringKode kesalahan untuk gambar yang gagal. Dikembalikan hanya untuk kegagalan parsial.message stringPesan kesalahan untuk gambar yang gagal. Dikembalikan hanya untuk kegagalan parsial.objectStatistik hasil tugas.
Properti TOTAL integerJumlah total tugas.SUCCEEDED integerJumlah tugas yang berhasil.FAILED integerJumlah tugas yang gagal.stringKode kesalahan. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan.message stringPesan kesalahan detail. Dikembalikan hanya untuk permintaan yang gagal. Lihat Kode kesalahan.objectStatistik penggunaan. Hanya menghitung hasil yang berhasil.
Properti image_count integerJumlah gambar yang berhasil dihasilkan. Penagihan: Biaya = Jumlah gambar × Harga satuan.stringIdentifier permintaan unik untuk pelacakan dan troubleshooting. |
URL gambar hanya berlaku selama 24 jam dan kemudian secara otomatis dihapus. Segera simpan gambar yang dihasilkan. |
Panggilan DashScope SDK
Parameter SDK sesuai dengan panggilan HTTP API, dibungkus agar sesuai dengan setiap bahasa pemrograman.
Pengeditan gambar memerlukan waktu 30–60 detik. SDK membungkus alur HTTP asinkron, mendukung panggilan sinkron maupun asinkron.
Waktu proses aktual bervariasi tergantung panjang antrian dan beban layanan.
Panggilan SDK Python
- Panggilan sinkron
- Panggilan asinkron
Contoh permintaan
Contoh ini mendukung tiga metode input gambar: URL publik, encoding Base64, dan jalur file lokal.Contoh respons
URL gambar kedaluwarsa setelah 24 jam. Segera unduh gambar.
Panggilan SDK Java
- Panggilan sinkron
- Panggilan asinkron
Contoh permintaan
Contoh ini mendukung tiga metode input gambar: URL publik, encoding Base64, dan jalur file lokal.Contoh respons
URL gambar kedaluwarsa setelah 24 jam. Segera unduh gambar.
Batasan
- Retensi data: Baik ID tugas maupun URL gambar kedaluwarsa setelah 24 jam. Anda tidak dapat mengkueri atau mengunduhnya setelah kedaluwarsa.
- Moderasi konten: Semua prompt, gambar input, dan gambar output menjalani moderasi konten. Permintaan yang berisi konten terlarang mengembalikan error seperti “IPInfringementSuspect” atau “DataInspectionFailed”. Lihat Informasi error untuk detailnya.
Kode kesalahan
Jika panggilan model gagal dan mengembalikan pesan error, lihat Kode kesalahan untuk penyelesaiannya.
FAQ
T: Saya sebelumnya menggunakan General Image Editing 2.1. Apakah saya perlu mengubah panggilan SDK saya untuk menggunakan wan2.5?
J: Ya—desain parameternya berbeda antarversi:- General Image Editing 2.1: Memerlukan parameter
promptdanfunction. - General Image Editing 2.5: Hanya memerlukan
prompt. Gambarkan semua pengeditan dalam teks. Parameterfunctiontidak lagi didukung atau diperlukan.



