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:
Model gambar tunggal: seedream-5-0-pro hanya menghasilkan 1 gambar per permintaan (kecuali dekomposisi layer). Parameter berikut ditolak (HTTP 400, tanpa tugas, tanpa biaya):
  • n > 1
  • sequential_image_generation (pembuatan grup tidak didukung)
  • stream (streaming tidak didukung)
  • tools (pencarian web tidak didukung)
  • lebih dari 10 item di image_urls

Pengeditan interaktif

Gunakan koordinat <point> / <bbox> dalam prompt, atau unggah gambar dengan anotasi gambar tangan, untuk menentukan lokasi pengeditan secara presisi.
  • Koordinat titik: <point>x y</point> (menentukan satu titik; model menentukan area yang terpengaruh)
  • Koordinat kotak pembatas: <bbox>x1 y1 x2 y2</bbox> (menentukan koordinat kiri atas dan kanan bawah untuk mengontrol ukuran area pengeditan secara presisi)

Dekomposisi layer

Pisahkan satu gambar menjadi gambar dasar dan hingga 16 layer PNG transparan, lengkap dengan informasi posisi dan urutan tumpukan.

Body

string
default:"seedream-5-0-pro"
wajib
Nama model pembuatan gambar
  • seedream-5-0-pro (direkomendasikan)
  • Juga diterima: seedream-5.0-pro
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 gambarOpsional ketika layer_decomposition: true; jika dihilangkan, model otomatis mengenali dan memisahkan elemen utama dalam gambar.Selain bahasa Mandarin dan Inggris, pembuatan teks native mendukung bahasa Rusia, Arab, Filipina, Thai, Turki, Korea, Melayu, Spanyol, Portugis, Indonesia, Prancis, Jerman, Vietnam, dan Jepang.
Tips: batasi hingga 600 kata bahasa Inggris; deskripsi terlalu panjang dapat kehilangan detail.
string
default:"1K"
Tingkat resolusi (huruf kecil diterima). Ini adalah ekstensi API Mart yang setara dengan menuliskan tingkat secara langsung di size.
  • 1K (default)
  • 1.5K (harga sama dengan 1K, kualitas lebih baik — utamakan 1.5K kecuali ada alasan lain)
  • 2K
Tingkat yang tidak didukung seperti 3K / 4K mengembalikan 400.Jika size berbentuk tingkat dan resolution sama-sama diberikan, size diprioritaskan.
Saat size adalah nilai piksel tepat (mis. 2048x1024), bidang ini diabaikan dan dimensi hanya dari size.
string
default:"auto"
Kata kunci tingkat, rasio aspek, auto, atau dimensi piksel yang tepat.

Format ①: tingkat resolusi (disarankan)

Tingkat dapat dituliskan langsung di size, atau diberikan melalui kolom ekstensi API Mart resolution:
Kedua format ini setara. Jika hanya tingkat yang ditentukan, jelaskan tata letak yang diinginkan dalam prompt (misalnya, “poster potret” atau “sampul lanskap”) dan biarkan model memilih rasio aspek.

Format ②: tingkat + rasio aspek

Digunakan bersama resolution. Rasio yang didukung:
  • 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 2:1, 1:2, 21:9
  • Juga menerima pemisah x gaya 16x9
  • 2x1 setara dengan 2:1, dan 1x2 setara dengan 1:2. Huruf x harus kecil dan spasi tidak diperbolehkan.
  • auto (default): hanya tingkat resolusi; rasio akhir dari prompt / referensi
Rasio di luar daftar (mis. 9:21) mengembalikan 400 — tanpa fallback senyap ke 1:1.Tingkat × rasio → piksel keluaran:

Format ③: piksel tepat

Saat size adalah widthxheight, piksel dipakai apa adanya dan resolution tidak berlaku. Menerima 2048X1024 / 2048×1024.
Batas berlaku pada hasil kali lebar dan tinggi, bukan tiap sisi sendiri. Contoh: 512×512 terlalu kecil (400); 2048×1024 valid.
string
default:"opaque"
Mode latar belakang keluaran:
  • opaque: latar belakang solid (default)
  • transparent: latar belakang transparan
transparent hanya tersedia untuk permintaan gambar-ke-gambar dengan tepat satu gambar input yang sudah memiliki kanal alfa; output_format: "png" juga wajib.
boolean
default:"false"
Menentukan apakah gambar akan didekomposisi menjadi layer. Jika diaktifkan, model mengembalikan satu gambar dasar dan hingga 16 layer PNG dengan kanal alfa.Diperlukan tepat satu gambar PNG atau JPEG. Jumlah pikselnya harus berada dalam [262144, 36000000] dan ukurannya tidak boleh lebih dari 30 MB. size hanya menerima 1K, 1.5K, 2K, atau auto, dengan default auto. output_format hanya mengontrol format gambar dasar; layer hasil dekomposisi selalu PNG.
object
default:"{\"mode\":\"standard\"}"
Mode pengoptimalan prompt:
  • standard: mode standar dengan kualitas lebih baik (default)
Format datar "optimize_prompt_options.mode": "standard" juga diterima.
integer
default:"1"
Jumlah gambar yang akan dibuat. Hanya 1 yang didukung; gunakan seedream-5-0-lite untuk pembuatan gambar berkelompok.
array
Daftar URL gambar referensi untuk image-to-image satu / multi-referensi, maksimal 10Dua format:1. URL publik
  • http:// atau https://
  • Contoh: https://example.com/image.jpg
2. Base64 (Data URI)
  • Format: data:image/<format>;base64,<data><format> harus huruf kecil
  • Contoh: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
Batas per gambar:
  • Format: jpeg / png / webp / bmp / tiff / gif / heic / heif
  • Rasio aspek (l/t): [1/16, 16]
  • Tiap sisi > 14 px
  • Ukuran ≤ 30 MB
  • Total piksel ≤ 6000×6000 (36.000.000)
Penagihan: gambar referensi pertama gratis; setiap gambar tambahan dikenai biaya tetap.
string
default:"jpeg"
Format gambar keluaran
  • jpeg (default)
  • png
Kompatibilitas: response_format setara dengan output_format; nilai lain diperlakukan sebagai jpeg.
boolean
default:"false"
Apakah menambahkan watermark “AI generated” di kanan bawah
  • true: tambahkan watermark
  • false: tanpa watermark (default)

Contoh permintaan

Text-to-image (tingkat + rasio)

Text-to-image (piksel tepat)

Multi-referensi

Direkomendasikan: 1.5K harga sama, kualitas lebih baik

Dekomposisi layer

Anda juga dapat menggunakan koordinat <bbox> yang dinormalisasi ke 0–1000 untuk menentukan elemen yang akan diekstrak secara presisi:

Pengeditan interaktif

Jelaskan anotasi gambar tangan pada gambar menggunakan bahasa alami:
Atau tentukan lokasi dengan tepat menggunakan <point> / <bbox>:

Pengeditan kanal alfa

Contoh lengkap: kirim tugas dan ambil gambar

Skrip berikut menunjukkan alur lengkap: mengirim tugas asinkron, memeriksa statusnya, menangani status kegagalan, dan membaca URL gambar akhir. Ganti YOUR_API_KEY sebelum menjalankannya.
Python
Jika berhasil, endpoint kueri tugas mengembalikan:
Gambar yang dikembalikan disalin ke penyimpanan yang dikelola platform. Anda tetap harus segera mengunduh dan menyimpannya secara permanen di sistem sendiri; jangan menganggap URL hasil sebagai penyimpanan permanen.

Skenario cURL lengkap

Komposisi multi-gambar (hingga 10 referensi)

Piksel tepat, pengoptimalan prompt, dan watermark

Dekomposisi dan edit layer transparan secara terpisah

Pertama, dekomposisi gambar sumber:
Kemudian ambil URL salah satu layer transparan dan edit secara terpisah:

Respons dan rekonstruksi dekomposisi layer

Array url, sizes, output_formats, dan layers saling bersesuaian berdasarkan indeks; indeks 0 selalu merupakan gambar dasar:
Gabungkan layer dalam urutan z_index menaik. Untuk merekonstruksinya pada gambar dasar keluaran dengan koordinat absolut:
Untuk merekonstruksinya pada kanvas W × H apa pun, gunakan koordinat yang dinormalisasi:
Dekomposisi layer ditagih per gambar. Hingga 17 gambar dipraotorisasi saat tugas dikirim. Setelah selesai, setiap keluaran diberi tingkat berdasarkan jumlah piksel aktual dan diselesaikan secara terpisah; kelebihan praotorisasi dikembalikan otomatis. Saldo Anda harus cukup untuk praotorisasi 17 gambar, dan size: "auto" dipraotorisasi pada tingkat 2K.

Catatan penagihan

Keluaran dihargai berdasarkan total piksel aktual (~2.61M = 2,601,124):
  • 1.5K harganya sama dengan 1K ($0.045).
  • Dengan piksel tepat di size, penagihan memakai luas keluaran aktual; resolution tidak memengaruhi (mis. size: "2048x2048" → $0.09).
  • Gambar referensi pertama gratis; setiap tambahan dikenai biaya.
  • Tugas gagal diganti penuh secara otomatis.

Praotorisasi dan penyelesaian dekomposisi layer

Karena jumlah dan dimensi akhir layer belum diketahui saat tugas dikirim, praotorisasi menggunakan aturan konservatif berdasarkan permintaan:
  • Piksel tepat: tingkat ditentukan berdasarkan area piksel yang diminta.
  • 1K / 1.5K: dipraotorisasi pada tingkat 1K.
  • 2K: dipraotorisasi pada tingkat 2K.
  • auto: dapat menghasilkan hingga 2K, sehingga dipraotorisasi pada tingkat 2K.
Setelah selesai, gambar dasar dan setiap layer aktual ditentukan tingkatnya dan dijumlahkan satu per satu berdasarkan area piksel sebenarnya. Kelebihan praotorisasi dikembalikan otomatis. Layer biasanya jauh lebih kecil daripada gambar dasar, sehingga tugas yang dipraotorisasi pada tingkat 2K pun dapat diselesaikan sepenuhnya pada tingkat 1K.
Contoh: input 1080×1080 didekomposisi menjadi 10 gambar. Tugas dipraotorisasi sebagai 17 gambar × tingkat 2K. Jika kesepuluh gambar akhir tidak melebihi 2,61 juta piksel, penyelesaian menggunakan 10 gambar × tingkat 1K dan sisa kredit dikembalikan otomatis.

Kesalahan umum

⏱️ Pembuatan lebih lambat: sekitar 90 detik untuk 1K dan 160 detik untuk 2K (mengutamakan kualitas). Periksa Status Tugas setiap 5–10 detik dan atur batas waktu klien menjadi 5 menit. Segera simpan hasil yang dibuat.

Respons

integer
Kode status respons
array
Array data respons