Wan2.6 mendukung input multi-gambar, pengeditan gambar, dan keluaran teks-gambar interleaved.
Ikhtisar model
Model | Deskripsi | Spesifikasi gambar output |
|---|---|---|
wan2.6-image | Mengedit gambar dan menghasilkan output teks-gambar interleaved. | Format gambar: PNG Resolusi dan dimensi gambar dikonfigurasi melalui parameter size. |
Sebelum memanggil API, periksa daftar model dan harga yang didukung di setiap wilayah.
Prasyarat
Dapatkan Kunci API dan ekspor Kunci API sebagai Variabel lingkungan.
HTTP sinkron
Mengembalikan hasil dalam satu permintaan. Direkomendasikan untuk sebagian besar skenario.
- Singapura
- AS (Virginia)
- China (Beijing)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generationSaat melakukan panggilan, ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.Cakupan penerapan global (wilayah Frankfurt) hanya mendukung pemanggilan asinkron.
Parameter permintaan |
|
Request headers | |
Content-Type string (Wajib)Tipe konten permintaan. Harus berupa application/json. | |
Authorization string (Wajib)Mengautentikasi permintaan dengan kunci API Model Studio. Contoh: Bearer sk-xxxx. | |
X-DashScope-SSE string (Opsional)Mengaktifkan keluaran streaming.
| |
Request body | |
model string (Wajib)Nama model. Tetapkan ke wan2.6-image. | |
input object (Wajib)Konfigurasi input.
Properties messages array (Wajib)Array konten permintaan. Hanya percakapan satu giliran yang didukung — berikan satu pasangan role-content.
Properties role string (Wajib)Peran pesan. Tetapkan ke user.content array (Wajib)Array konten pesan.
Properties text string (Wajib)Prompt positif yang menjelaskan konten, gaya, dan komposisi gambar yang diinginkan.Mendukung bahasa Tiongkok dan Inggris. Maksimal 2.000 karakter (setiap karakter Tiongkok, huruf, angka, atau simbol dihitung sebagai satu). Akan dipotong otomatis jika melebihi batas.Contoh: Hasilkan tumis tomat dan telur berdasarkan gaya gambar ini.Catatan: Array content harus berisi tepat satu objek dengan bidang text.image string (Opsional)URL atau string gambar yang dikodekan dalam Base64.Batasan gambar:
| |
parameters object (Opsional)Parameter generasi.
Properties negative_prompt string (Opsional)Prompt negatif yang menggambarkan hal yang tidak Anda inginkan dalam gambar.Mendukung bahasa Tiongkok dan Inggris. Panjang maksimum 500 karakter. Karakter berlebih akan dipotong secara otomatis.Contoh: Resolusi rendah, kualitas rendah, anggota tubuh terdistorsi, jari cacat, warna terlalu jenuh, tampilan seperti lilin, tidak ada detail wajah, permukaan terlalu halus, tampilan hasil AI. Komposisi kacau. Teks buram atau terdistorsi.size string (Opsional)Resolusi gambar output. Mendukung dua metode: merujuk pada proporsi gambar input atau langsung menentukan dimensi.Saat enable_interleave=false (mode pengeditan gambar):
enable_interleave=true (mode output teks-gambar interleaved):
Resolusi yang direkomendasikan untuk rasio aspek umum
bool (Opsional)Mengontrol mode generasi gambar:
integer (Opsional)Jumlah gambar yang akan dihasilkan. Perilaku bergantung pada enable_interleave:
integer (Opsional)Hanya berlaku dalam mode teks-gambar interleaved (enable_interleave=true).
bool (Opsional)Hanya berlaku dalam mode pengeditan gambar (enable_interleave = false).Mengaktifkan penulisan ulang prompt cerdas. Hanya mengoptimalkan prompt positif; prompt negatif tetap tidak berubah.
bool (Opsional)Mengaktifkan keluaran streaming. Wajib (atur ke true) saat enable_interleave=true.
bool (Opsional)Menambahkan label watermark di pojok kanan bawah gambar dengan teks tetap "AI Generated".
integer (Opsional)Seed angka acak. Rentang valid: [0,2147483647].Menggunakan seed yang sama menghasilkan output yang serupa. Jika dihilangkan, algoritma menggunakan seed acak.Catatan: Generasi gambar bersifat probabilistik. Bahkan dengan seed yang sama, hasilnya dapat bervariasi. |
Parameter respons |
Data tugas (status tugas dan URL gambar) hanya disimpan selama 24 jam, lalu secara otomatis dipurge. Segera simpan gambar yang dihasilkan. |
output objectOutput tugas.
Properties choices array of objectKonten output yang dihasilkan model.
Properties finish_reason stringAlasan penghentian tugas.Skema keluaran non-streaming: Berhenti secara alami dengan stop.Skema keluaran streaming: Parameter ini menunjukkan apakah aliran data telah selesai ditransmisikan.
objectPesan yang dikembalikan oleh model.
Properties role stringPeran pesan, tetap sebagai assistant.content array
Properties type stringJenis output. Nilai enumerasi: text, image.text stringTeks yang dihasilkan.image stringURL gambar yang dihasilkan dalam format PNG.Tautan kedaluwarsa setelah 24 jam. Segera unduh dan simpan gambarnya.boolFlag penyelesaian permintaan.
| |
usage objectStatistik output. Hanya menghitung hasil yang berhasil.
Properties image_count integerJumlah gambar yang dihasilkan.size stringResolusi gambar yang dihasilkan. Contoh: 1376*768.input_tokens integerDitagih berdasarkan jumlah gambar.
integerDitagih berdasarkan jumlah gambar.
integerDitagih berdasarkan jumlah gambar.
| |
request_id stringIdentifier unik permintaan untuk pelacakan dan troubleshooting. | |
code stringKode error. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error. | |
message stringPesan error detail. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error. |
HTTP asinkron
Proses: Buat tugas → Poll hasil
Langkah 1: Buat tugas dan dapatkan ID tugas
- Singapura
- AS (Virginia)
- China (Beijing)
- Jerman (Frankfurt)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generationSaat memanggil, ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.- Setelah tugas dibuat, gunakan
task_idyang dikembalikan untuk menanyakan hasilnya.task_idberlaku selama 24 jam. Jangan membuat tugas duplikat. Sebagai gantinya, gunakan polling untuk mengambil hasilnya. - Untuk panduan pemula, lihat Panggil API dengan Postman atau cURL.
Parameter permintaan | |
Header permintaan | |
Content-Type string (Wajib)Tipe konten permintaan. Harus application/json. | |
Authorization string (Wajib)Mengautentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx. | |
X-DashScope-Asyncstring(Wajib)Sakelar mode asinkron. Harus ditetapkan ke enable. | |
Body permintaan | |
model string (Wajib)Nama model.Contoh: wan2.6-image | |
input object (Wajib)Konfigurasi input.
Properti messages array (Wajib)Array konten permintaan. Hanya percakapan satu putaran yang didukung — berikan satu pasangan role-content. Percakapan multi-putaran tidak didukung.
Properti role string (Wajib)Peran pesan. Tetapkan ke user.contentarray (Wajib)Array konten pesan.
Properti text string(Wajib)Prompt positif yang menjelaskan konten, gaya, dan komposisi gambar yang diinginkan.Mendukung bahasa Mandarin dan Inggris. Maksimal 2.000 karakter (setiap karakter Mandarin, huruf, angka, atau simbol dihitung sebagai satu). Dipotong otomatis jika melebihi batas.Contoh: Generate a tomato and egg stir-fry based on this image style.Catatan: Array content harus berisi tepat satu objek dengan bidang text.imagestring(Opsional)URL atau string Base64 dari gambar input.Batasan gambar:
| |
parameters object (Opsional)Parameter generasi.
Properti negative_prompt string (opsional)Prompt negatif yang menjelaskan apa yang tidak Anda inginkan dalam gambar.Mendukung bahasa Mandarin dan Inggris. Panjang maksimum 500 karakter. Karakter berlebih dipotong otomatis.Contoh: Resolusi rendah, kualitas rendah, anggota tubuh terdistorsi, jari cacat, warna terlalu jenuh, penampilan seperti lilin, tanpa detail wajah, permukaan terlalu halus, tampilan hasil AI. Komposisi kacau. Teks buram atau terdistorsi.size string (Opsional)Resolusi gambar output. Mendukung dua metode: merujuk proporsi gambar input atau langsung menentukan dimensi.Saat enable_interleave=false (mode pengeditan gambar):
enable_interleave=true (mode output teks-gambar interleaved):
Resolusi yang direkomendasikan untuk rasio aspek umum
bool (Opsional)Mengontrol mode generasi gambar:
integer (Opsional)Jumlah gambar yang akan dihasilkan. Perilaku bergantung pada enable_interleave:
integer (Opsional)Hanya efektif dalam mode teks-gambar interleaved (enable_interleave=true).
bool (Opsional)Hanya efektif dalam mode pengeditan gambar (enable_interleave = false).Mengaktifkan penulisan ulang prompt cerdas. Hanya mengoptimalkan prompt positif; prompt negatif tetap tidak berubah.
bool (Opsional)Menambahkan label watermark di pojok kanan bawah gambar dengan teks tetap "AI Generated".
integer (opsional)Bibit angka acak. Rentang valid: [0,2147483647].Menggunakan seed yang sama menghasilkan output serupa. Jika diabaikan, algoritma menggunakan seed acak.Catatan: Generasi gambar bersifat probabilistik. Bahkan dengan seed yang sama, hasilnya mungkin berbeda. |
Parameter respons |
Simpan task_id untuk menanyakan status dan hasil tugas. |
output objectOutput tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
| |
request_id stringIdentifier permintaan unik untuk pelacakan dan troubleshooting. | |
code stringKode error. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error. | |
message stringPesan error detail. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error. |
Langkah 2: Tanyakan hasil menggunakan ID tugas
- Singapura
- AS (Virginia)
- China (Beijing)
- Jerman (Frankfurt)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Saat memanggil, ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.- Rekomendasi polling: Generasi gambar memakan waktu. Gunakan mekanisme polling dengan interval yang masuk akal, 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 permintaan |
Ganti {task_id} dengan nilai task_id yang dikembalikan oleh panggilan API sebelumnya. task_id berlaku untuk kueri selama 24 jam, Ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya. |
Header permintaan | |
Authorization string (Wajib)Mengautentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx. | |
Parameter path URL | |
task_id string (Wajib)ID tugas. |
Parameter respons |
Data tugas (status tugas dan URL gambar) hanya disimpan selama 24 jam, lalu secara otomatis dihapus. Segera simpan gambar yang dihasilkan. |
output objectInformasi 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.finished boolFlag penyelesaian permintaan.
array of objectKonten output yang dihasilkan model.
Properti finish_reason stringAlasan penghentian tugas. Berhenti secara alami dengan stop.message objectPesan yang dikembalikan oleh model.
Properti role stringPeran pesan, tetap sebagai assistant.contentarray
Properti type stringTipe output. Nilai enumerasi: text, image.text stringTeks yang dihasilkan.image stringURL gambar yang dihasilkan dalam format PNG.Tautan kedaluwarsa setelah 24 jam. Unduh dan simpan gambar segera. | |
usage objectStatistik output. Hanya menghitung hasil yang berhasil.
Properti image_count integerJumlah gambar yang dihasilkan.size stringResolusi gambar yang dihasilkan. Contoh: 1376×768.input_tokens integerJumlah token input. Ditagih per jumlah gambar. Saat ini tetap 0.output_tokens integerJumlah token output. Ditagih per jumlah gambar. Saat ini tetap 0.total_tokensintegerJumlah total token. Ditagih per jumlah gambar. Saat ini tetap 0. | |
request_id stringIdentifier permintaan unik untuk pelacakan dan troubleshooting. | |
code stringKode error. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error. | |
message stringPesan error detail. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error. |
DashScope Python SDK
Parameter SDK sejalan dengan antarmuka HTTP, disesuaikan sesuai konvensi bahasa.
SDK menangani pemanggilan asinkron secara internal dan mendukung pemanggilan sinkron maupun asinkron.
Durasi aktual bervariasi tergantung panjang antrian dan beban layanan.Parameter
base_url dan Kunci API bersifat spesifik wilayah. Contoh panggilan dari wilayah Singapura:
- Singapura
- AS (Virginia)
- China (Beijing)
- Jerman (Frankfurt)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Saat melakukan panggilan, ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.Cakupan penerapan global (wilayah Frankfurt) hanya mendukung pemanggilan asinkron.
Pengeditan gambar
- Sinkron
- Asinkron
Contoh permintaan
Contoh respons
URL kedaluwarsa setelah 24 jam. Unduh gambar segera.
usage tingkat atas, pada level yang sama dengan output. Baca sebagai response.usage["image_count"]. Objek output tidak membawa statistik: response.output.usage dikembalikan sebagai {} dan tidak berisi image_count.Output teks-gambar interleaved
- Sinkron (streaming saja)
- Asinkron
Contoh permintaan
Contoh respons
URL kedaluwarsa setelah 24 jam. Unduh gambar segera.
DashScope Java SDK
Parameter SDK sejalan dengan antarmuka HTTP, dikemas sesuai konvensi bahasa.
SDK menangani pemanggilan asinkron secara internal dan mendukung pemanggilan sinkron maupun asinkron.
Durasi aktual bergantung pada panjang antrian dan beban layanan.Parameter
base_url dan Kunci API tidak dapat saling dipertukarkan antar wilayah. Contoh untuk wilayah Singapura:
- Singapura
- AS (Virginia)
- China (Beijing)
- Jerman (Frankfurt)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Saat melakukan panggilan, ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.Cakupan penerapan global (wilayah Frankfurt) hanya mendukung pemanggilan asinkron.
Pengeditan gambar
- Sinkron
- Asinkron
Contoh permintaan
Contoh respons
URL kedaluwarsa setelah 24 jam. Unduh gambar segera.
Output teks-gambar interleaved
- Pemanggilan sinkron (streaming saja)
- Pemanggilan asinkron
Contoh permintaan
Contoh respons
URL kedaluwarsa setelah 24 jam. Unduh gambar segera.
Batasan
- Validitas data:
task_iddanurlgambar hanya disimpan selama 24 jam. Setelah periode ini, mereka tidak dapat ditanyakan atau diunduh. - Moderasi konten: Baik
promptinput maupun gambar output menjalani moderasi konten. Konten yang tidak sesuai mengembalikan errorIPInfringementSuspectatauDataInspectionFailed. Lihat Kode error.
Penagihan dan pembatasan laju
- Kuota gratis dan harga: Harga model.
- Untuk batas laju model, lihat Wanxiang.
- Anda ditagih per gambar yang berhasil dihasilkan. Pemanggilan yang gagal tidak dikenai biaya dan tidak menghabiskan kuota gratis.