Wan2.7-Image mendukung text-to-image, text-to-image-set, image-to-image-set, pengeditan gambar, dan pembuatan referensi multi-gambar.
Ikhtisar model
Model | Description | Spesifikasi gambar output |
|---|---|---|
wan2.7-image-pro | Wan 2.7 image Pro. Mendukung output 4K untuk pembuatan text-to-image (tidak berlaku untuk image set). | Format gambar: PNG. Untuk resolusi dan dimensi gambar, lihat parameter size. |
wan2.7-image | Wan 2.7 image. Pembuatan lebih cepat. |
Prasyarat
Dapatkan Kunci API dan ekspor Kunci API sebagai Variabel lingkungan.
HTTP sinkron
Mengembalikan hasil dalam satu permintaan. Direkomendasikan untuk sebagian besar kasus penggunaan.
- Singapura
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generationGanti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.Parameter permintaan |
Model wan2.7-image-pro hanya mendukung resolusi 4K untuk pembuatan text-to-image. Pengeditan gambar dan pembuatan image set mendukung resolusi maksimal 2K. |
Header | |
Content-Type string (Wajib)Tipe konten permintaan. Harus application/json. | |
Authorization string (Wajib)Mengotentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx. | |
Body permintaan | |
model string (Wajib)Nama model. Nilai yang valid: wan2.7-image-pro, wan2.7-image. | |
input object (Wajib)Objek input.
Properti messages array (Wajib)Array konten permintaan. Hanya percakapan satu putaran yang didukung.
Properti role string (Wajib)Peran pesan. Harus user.content array (Wajib)Array konten pesan.
Properti text stringPrompt teks. Mendukung bahasa Tionghoa dan Inggris. Maksimal 5.000 karakter. Setiap karakter, huruf, angka, atau simbol dihitung sebagai satu. Karakter berlebih akan dipotong.image stringURL atau string Base64-encoded dari gambar input.Batasan gambar:
| |
parameters object (Opsional)Pengaturan parameter model.
Properti bbox_list List[List[List[int]]] (Opsional)Area Kotak pembatas untuk pengeditan interaktif.
boolean (Opsional)Mengontrol mode pembuatan gambar:
string (Opsional)Resolusi gambar output. Mendukung dua metode yang saling eksklusif:Model: wan2.7-image-pro
Nilai piksel gambar output mungkin memiliki sedikit perbedaan dari nilai yang ditentukan.n int (Opsional)
boolean (Opsional)Mengaktifkan mode thinking. Default: true. Parameter ini hanya berlaku ketika mode image set dinonaktifkan dan tidak ada input gambar. Saat diaktifkan, model meningkatkan kemampuan Inferensi untuk meningkatkan kualitas output, tetapi hal ini meningkatkan waktu pembuatan.color_palette array (Opsional)Tema warna kustom. Array objek, masing-masing dengan warna heksadesimal dan rasio. Harus mencakup 3 hingga 10 warna. Disarankan 8 warna.Hanya tersedia saat mode image set dinonaktifkan (enable_sequential=false).
Properti hex string (Wajib)Nilai warna dalam format heksadesimal (HEX).ratio string (Wajib)Presentase warna. Harus akurat hingga dua tempat desimal (seperti "25.00%"). Jumlah semua nilai rasio harus 100.00%.
Klik untuk melihat contoh input bool (Opsional)Menambahkan label watermark di pojok kanan bawah gambar dengan teks tetap "AI Generated".
integer (opsional)Seed bilangan acak. Rentang valid: [0,2147483647].Menggunakan seed yang sama menghasilkan output serupa. Jika dihilangkan, algoritma menggunakan seed acak.Catatan: Pembuatan gambar bersifat probabilistik. Bahkan dengan seed yang sama, hasilnya mungkin berbeda. |
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 choices arrayKonten output yang dihasilkan oleh model.
Properti finish_reason stringAlasan tugas berhenti. stop menunjukkan penyelesaian alami.message objectPesan yang dikembalikan oleh model.
Properti role stringPeran pesan. Selalu assistant.content array
Properti type stringNilai: image.image stringURL gambar yang dihasilkan. Format: PNG.Tautan berlaku selama 24 jam. Segera unduh gambar.booleanMenunjukkan apakah tugas telah selesai. Default: false. | |
usage objectStatistik penggunaan untuk permintaan. Hanya hasil yang berhasil yang dihitung.
Properti image_count integerJumlah gambar yang dihasilkan.size stringResolusi gambar yang dihasilkan. Contoh: 1376*768.input_tokens integerJumlah token input (tidak dikenai biaya). Penagihan berdasarkan jumlah gambar.output_tokens integerJumlah token output (tidak dikenai biaya). Penagihan berdasarkan jumlah gambar.total_tokens integerJumlah total token (tidak dikenai biaya). Penagihan berdasarkan jumlah gambar. | |
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. |
HTTP asinkron
Paling cocok untuk tugas berdurasi panjang. Kirim tugas, lalu polling status dan hasilnya.
Langkah 1: Buat tugas untuk mendapatkan ID tugas
- Singapura
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generationGanti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.Parameter permintaan |
Model wan2.7-image-pro hanya mendukung resolusi 4K untuk pembuatan text-to-image. Pengeditan gambar dan pembuatan image set mendukung resolusi maksimal 2K. |
Header | |
Content-Type string (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 permintaan | |
model string (Wajib)Nama model. Nilai yang valid: wan2.7-image-pro, wan2.7-image. | |
input object (Wajib)Objek input.
Properti messages array (Wajib)Array konten permintaan. Hanya percakapan satu putaran yang didukung.
Properti role string (Wajib)Peran pesan. Harus user.content array (Wajib)Array konten pesan.
Properti text stringPrompt teks. Mendukung bahasa Tionghoa dan Inggris. Maksimal 5.000 karakter. Setiap karakter, huruf, angka, atau simbol dihitung sebagai satu. Karakter berlebih akan dipotong.image stringURL atau string Base64-encoded dari gambar input.Batasan gambar:
| |
parameters object (Opsional)Pengaturan parameter model.
Properti bbox_list List[List[List[int]]] (Opsional)Area Kotak pembatas untuk pengeditan interaktif.
boolean (Opsional)Mengontrol mode pembuatan gambar:
string (Opsional)Resolusi gambar output. Mendukung dua metode yang saling eksklusif:Model: wan2.7-image-pro
Nilai piksel gambar output mungkin memiliki sedikit perbedaan dari nilai yang ditentukan.n int (Opsional)
boolean (Opsional)Mengaktifkan mode thinking. Default: true. Parameter ini hanya berlaku ketika mode image set dinonaktifkan dan tidak ada input gambar. Saat diaktifkan, model meningkatkan kemampuan Inferensi untuk meningkatkan kualitas output, tetapi hal ini meningkatkan waktu pembuatan.color_palette array (Opsional)Tema warna kustom. Array objek, masing-masing dengan warna heksadesimal dan rasio. Harus mencakup 3 hingga 10 warna. Disarankan 8 warna.Hanya tersedia saat mode image set dinonaktifkan (enable_sequential=false).
Properti hex string (Wajib)Nilai warna dalam format heksadesimal (HEX).ratio string (Wajib)Presentase warna. Harus akurat hingga dua tempat desimal (seperti "25.00%"). Jumlah semua nilai rasio harus 100.00%.
Klik untuk melihat contoh input bool (Opsional)Menambahkan label watermark di pojok kanan bawah gambar dengan teks tetap "AI Generated".
integer (opsional)Seed bilangan acak. Rentang valid: [0,2147483647].Menggunakan seed yang sama menghasilkan output serupa. Jika dihilangkan, algoritma menggunakan seed acak.Catatan: Pembuatan gambar bersifat probabilistik. Bahkan dengan seed yang sama, hasilnya mungkin berbeda. |
Parameter respons |
Simpan task_id untuk menanyakan status dan hasil tugas. |
output objectInformasi output 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 berdasarkan ID tugas
- Singapura
- Beijing
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Parameter permintaan |
Ganti {task_id} dengan nilai task_id yang dikembalikan oleh panggilan API sebelumnya. task_id berlaku untuk kueri selama 24 jam. |
Header | |
Authorization string (Wajib)Mengotentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx. | |
Parameter path | |
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 dikirim. Waktu dalam UTC+8 dan format YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringWaktu saat tugas dieksekusi. Waktu dalam UTC+8 dan format YYYY-MM-DD HH:mm:ss.SSS.end_time stringWaktu saat tugas selesai. Waktu dalam UTC+8 dan format YYYY-MM-DD HH:mm:ss.SSS.finished booleanMenunjukkan apakah tugas telah selesai. Default: false.choices arrayKonten output yang dihasilkan oleh model.
Properti finish_reason stringAlasan tugas berhenti. stop menunjukkan penyelesaian alami.message objectPesan yang dikembalikan oleh model.
Properti role stringPeran pesan. Selalu assistant.content array
Properti type stringNilai: text, image.text stringTeks yang dihasilkan.image stringURL gambar yang dihasilkan. Format: PNG.Tautan berlaku selama 24 jam. Segera unduh gambar. | |
usage objectStatistik penggunaan untuk permintaan. Hanya hasil yang berhasil yang dihitung.
Properti image_count integerJumlah gambar yang dihasilkan.size stringResolusi gambar yang dihasilkan. Contoh: 1376*768.input_tokens integerJumlah token input (tidak dikenai biaya). Penagihan berdasarkan jumlah gambar.output_tokens integerJumlah token output (tidak dikenai biaya). Penagihan berdasarkan jumlah gambar.total_tokens integerJumlah total token (tidak dikenai biaya). Penagihan berdasarkan jumlah gambar. | |
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. |
Python SDK
Nama parameter SDK sebagian besar konsisten dengan HTTP API.
Tugas pembuatan gambar bisa memakan waktu, sehingga SDK membungkus alur kerja asinkron HTTP. Panggilan sinkron dan asinkron didukung.
Durasi tugas bergantung pada panjang antrian dan status layanan.Baik
base_url maupun Kunci API bersifat spesifik wilayah. Contoh berikut menggunakan wilayah Singapura:
- Singapura
- China (Beijing)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Saat memanggil, ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.Image editing
- Panggilan sinkron
- Panggilan asinkron
Contoh permintaan
Contoh respons
URL berlaku selama 24 jam. Segera unduh gambar.
Image set generation
- Panggilan sinkron
- Panggilan asinkron
Contoh permintaan
Contoh respons
URL berlaku selama 24 jam. Segera unduh gambar.
Java SDK
Nama parameter SDK sebagian besar konsisten dengan HTTP API.
Tugas pembuatan gambar bisa memakan waktu, sehingga SDK membungkus alur kerja asinkron HTTP. Panggilan sinkron dan asinkron didukung.
- Singapura
- China (Beijing)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Saat memanggil, ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.Image editing
- Panggilan sinkron
- Panggilan asinkron
Contoh permintaan
Contoh respons
URL berlaku selama 24 jam. Simpan tepat waktu.
Image set generation
- Panggilan sinkron
- Panggilan asinkron
Contoh permintaan
Contoh respons
URL berlaku selama 24 jam. Simpan tepat waktu.
Penagihan dan pembatasan laju
- Untuk kuota gratis dan harga satuan model, lihat Harga model.
- Untuk pembatasan laju model, lihat Wanxiang.
- Detail penagihan: Anda ditagih berdasarkan jumlah gambar yang berhasil dihasilkan. Panggilan gagal dan error pemrosesan tidak dikenai biaya atau mengurangi kuota gratis untuk pengguna baru Anda.