Skip to main content
POST

Otorisasi

string
wajib
Semua endpoint API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header permintaan:

Body

string
default:"seedream-4.0"
wajib
Nama model pembuatan gambarModel yang didukung: seedream-4.0, seedream-4-0, Seedream-4.0Contoh: "seedream-4.0"
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
wajib
Deskripsi teks untuk pembuatan gambarMaksimum 1000 characters
string
default:"1:1"
Rasio aspek gambarRasio aspek yang didukung:
  • 1:1 - Persegi (default)
  • 4:3 - Lanskap 4:3
  • 3:4 - Potret 3:4
  • 16:9 - Lanskap layar lebar
  • 9:16 - Potret vertikal
  • 3:2 - Lanskap 3:2
  • 2:3 - Potret 2:3
  • 2:1 - Lanskap memanjang
  • 1:2 - Potret memanjang
  • 21:9 - Ultra-lebar
  • 9:21 - Ultra-tinggi
  • auto - Otomatis mencocokkan rasio aspek gambar referensi (memerlukan image_urls)
2x1 setara dengan 2:1, dan 1x2 setara dengan 1:2. Huruf x harus kecil dan spasi tidak diperbolehkan.
string
default:"2K"
Resolusi gambarResolusi yang didukung:
  • 1K - Resolusi dasar
  • 2K - Resolusi standar (default)
  • 4K - Definisi tinggi
Ukuran referensi resolusi:
integer
Jumlah gambar yang akan dibuatRentang: 1-15 (minimum 1, maksimum 15)Default: 1Catatan:
  • Harus memasukkan angka biasa (misalnya 1), jangan gunakan tanda kutip karena akan menyebabkan error
Biaya akan dipotong di muka berdasarkan jumlah tersebut
Jumlah gambar referensi dalam image_urls + jumlah akhir gambar yang dihasilkan sesuai n harus ≤ 15.
array
Daftar URL gambar referensi untuk image-to-image atau pengeditan gambarDua format didukung:1. URL gambar lengkap
  • URL gambar yang dapat diakses publik (http:// atau https://)
  • Contoh: https://example.com/image.jpg
2. Format berenkode Base64
  • Harus menggunakan format Data URI lengkap
  • Format: data:image/{format};base64,{base64-data}
  • Format gambar yang didukung: jpeg, png
  • Contoh: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Catatan: Harus menyertakan prefiks data:image/jpeg;base64,
Batass:
  • Format gambar: jpeg, png
  • Rentang rasio aspek (lebar/tinggi): [1/3, 3]
  • Lebar dan tinggi (px) > 14
  • Ukuran: tidak melebihi 10MB
  • Total piksel: tidak melebihi 6000×6000 px
Jumlah gambar referensi dalam image_urls + jumlah akhir gambar yang dihasilkan sesuai n harus ≤ 15.
string
default:"standard"
Mode optimasi prompt
  • standard: Mode standar, menghasilkan konten berkualitas lebih tinggi dengan waktu pemrosesan lebih lama
  • fast: Mode cepat, menghasilkan konten lebih cepat dengan kualitas reguler
Default: standard
string
default:"disabled"
Mode pembuatan gambar sekuensial (fitur khusus Doubao)Mengatur apakah akan membuat beberapa gambar:
  • disabled: Nonaktifkan mode sekuensial, hanya membuat 1 gambar meskipun ada beberapa gambar referensi (default)
  • auto: Aktifkan mode sekuensial, dapat membuat beberapa gambar
Catatan Penggunaan:
  • ✅ Harus menyediakan image_urls - minimal 1 gambar referensi diperlukan
  • ✅ Set n: 3 atau use sequential_image_generation: "auto" + max_images: 3
  • ✅ Ini akan membuat 3 gambar berbeda berdasarkan gambar referensi
  • ⚠️ Saat n > 1, nilainya akan otomatis diatur ke auto
Batasan:
  • Text-to-image murni (tanpa image_urls) tidak dapat membuat beberapa gambar - ini adalah batasan API Doubao
object
Sequential pembuatan gambar optionsTersedia saat sequential_image_generation diatur ke autoProperti:
  • max_images (integer): Tentukan jumlah gambar yang akan dibuat, Rentang: 1-15
Contoh:
boolean
default:"false"
Apakah akan menambahkan watermark ke gambar yang dihasilkan
  • true: Tambahkan watermark
  • false: Tanpa watermark (default)

Respons

integer
Kode status respons
array
Array data respons