Skip to main content
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-image
  • wan2.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 dengan omni-moderation-latest
  • false atau 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
Contoh: "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 gambar
Rasio 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*1024
string
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 n is 12 when enabled
  • thinking_mode dan color_palette diabaikan dalam mode sekuensial
  • wan2.7-image-pro mendukung 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
Contoh: [[], [[989, 515, 1138, 681]]]
array<object>
Tema warna kustom. Hanya mode standar (bukan mode sekuensial).
  • 3–10 entri (8 direkomendasikan); setiap entri memerlukan hex dan ratio
  • Semua nilai ratio harus berjumlah tepat 100.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.