wan2.7-image
wan2.7 Pembuatan & Pengeditan Gambar
- Seri gambar Wan2.7: mendukung text-to-image, pengeditan gambar, pengeditan interaktif, pembuatan sekuensial, dan referensi multi-gambar
- Mode pemrosesan asinkron — kirim tugas dan polling hasil menggunakan task_id yang dikembalikan
- Mendukung resolusi 1K / 2K / 4K; wan2.7-image-pro mendukung hingga 4K untuk text-to-image
- Penagihan didasarkan pada jumlah gambar yang berhasil dibuat, terlepas dari resolusi atau rasio aspek
POST
Otorisasi
string
wajib
Semua permintaan memerlukan autentikasi Bearer Token.Kunjungi halaman Manajemen API Key untuk memperoleh API Key Anda, lalu tambahkan ke header permintaan:
Model yang Tersedia
Penagihan didasarkan pada gambar yang berhasil dibuat × harga satuan. Input tidak ditagih. Resolusi dan rasio aspek tidak memengaruhi harga. Permintaan yang gagal tidak dikenakan biaya.
Body
string
wajib
Nama model pembuatan gambar.
wan2.7-image-pro— Edisi profesional, hingga 4K untuk text-to-imagewan2.7-image— Edisi standar, lebih cepat, hingga 2K
boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas gambar dikirim.
true: periksa prompt dan gambar input denganomni-moderation-latestfalseatau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
string
Deskripsi teks untuk pembuatan gambar, hingga 5000 karakter.
- Text-to-image (tanpa
image_urls): wajib - Pengeditan gambar (dengan
image_urls): opsional tetapi direkomendasikan
"Toko bunga dengan jendela indah, pintu kayu cantik, dan bunga yang dipajang"array<string>
Array URL gambar input untuk skenario pengeditan dan referensi multi-gambar.Menyediakan bidang ini akan mengalihkan permintaan ke mode pengeditan gambar.Format yang didukung: URL HTTP/HTTPS;
data:image/...;base64,... Base64Batasan: Hingga 9 gambar; JPEG / PNG / WEBP / BMP; 240–8000 px, rasio aspek 1:8 ~ 8:1; ≤ 20MB per gambarRasio aspek output otomatis mengikuti gambar input terakhir. Mode pengeditan hanya mendukung hingga 2K — 4K tidak tersedia.
integer
default:"1"
Jumlah gambar yang akan dibuat.
- Mode standar: 1–4 (default 1)
- Mode sekuensial (
enable_sequential: true): 1–12 (default 1)
Ditagih per gambar yang berhasil dibuat. Dikenakan biaya di muka berdasarkan
n.string
Resolusi output atau rasio aspek. Mendukung tiga format:① Kata kunci resolusi (direkomendasikan):
1K / 2K (default) / 4K (wan2.7-image-pro khusus text-to-image)② Rasio aspek: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 (default ke tier 2K)③ Dimensi piksel: 1024x1024 atau 1024*1024string
Kata kunci tier resolusi:
1K / 2K / 4K. Dapat digabungkan dengan size (rasio aspek).string
Prompt negatif yang menjelaskan elemen yang perlu dihindari. Contoh:
"buram, terdistorsi, kualitas rendah"boolean
default:"false"
Apakah akan menambahkan watermark “AI Generated” di sudut kanan bawah.
integer
Seed acak, range 0–2147483647. Seed yang sama dengan parameter identik menghasilkan hasil yang konsisten secara visual.
boolean
default:"true"
Aktifkan mode penalaran yang ditingkatkan untuk memperbaiki kualitas gambar dengan konsekuensi waktu pembuatan lebih lama.
Hanya efektif saat mode sekuensial dinonaktifkan dan tidak ada input gambar yang diberikan.
boolean
default:"false"
Aktifkan mode pembuatan gambar sekuensial — membuat beberapa gambar yang koheren secara tematik dalam satu permintaan. Ideal untuk storyboard dan seri.
- Maksimum
nis 12 when enabled thinking_modedancolor_palettediabaikan dalam mode sekuensialwan2.7-image-promendukung hingga 2K dalam mode sekuensial (4K tidak didukung)
array
Bounding box untuk pengeditan interaktif — menentukan wilayah persis yang akan diedit atau disisipkan konten.Structure:
[[[x1, y1, x2, y2], ...], ...]- Panjang array luar harus sama dengan panjang
image_urls - Berikan
[]untuk gambar tanpa bounding box - Maksimum 2 box per gambar; koordinat adalah nilai piksel absolut, origin (0,0) berada di kiri atas
[[], [[989, 515, 1138, 681]]]array<object>
Tema warna kustom. Hanya mode standar (bukan mode sekuensial).
- 3–10 entri (8 direkomendasikan); setiap entri memerlukan
hexdanratio - Semua nilai
ratioharus berjumlah tepat100.00%
Respons
string
Status respons. Mengembalikan
"success" saat berhasil.array
Contoh
Teks-ke-Gambar (minimal)
Teks-ke-Gambar (dengan resolusi)
Teks-ke-Gambar (palet warna kustom)
Sequential Pembuatan Gambar
Pengeditan Satu Gambar
Referensi Multi-Gambar / Fusi Elemen
Pengeditan Interaktif (Bounding Box)
bbox_list berkorespondensi 1-ke-1 dengan image_urls. Berikan [] untuk gambar tanpa pilihan.
Mengueri HasilPembuatan gambar bersifat asinkron. Polling endpoint Status Tugas menggunakan
task_id hingga status == completed.