Seedream-5.0-Pro
Seedream-5.0-Pro Pembuatan Gambar
- Mode pemrosesan asinkron, mengembalikan ID tugas untuk kueri berikutnya
- Mendukung text-to-image, image-to-image satu gambar, dan multi-referensi (maksimal 10 gambar referensi)
- Mendukung tingkat resolusi 1K / 1.5K / 2K, atau piksel tepat melalui
size - Model gambar tunggal: satu gambar per permintaan; output PNG / JPEG
- Tautan gambar yang dihasilkan berlaku selama 72 jam; harap segera simpan
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 > 1sequential_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 denganomni-moderation-latestfalseatau 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
size berbentuk tingkat dan resolution sama-sama diberikan, size diprioritaskan.string
default:"auto"
Kata kunci tingkat, rasio aspek, 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.
auto, atau dimensi piksel yang tepat.Format ①: tingkat resolusi (disarankan)
Tingkat dapat dituliskan langsung disize, atau diberikan melalui kolom ekstensi API Mart resolution:Format ②: tingkat + rasio aspek
Digunakan bersamaresolution. 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
xgaya16x9 2x1setara dengan2:1, dan1x2setara dengan1:2. Hurufxharus kecil dan spasi tidak diperbolehkan.auto(default): hanya tingkat resolusi; rasio akhir dari prompt / referensi
9:21) mengembalikan 400 — tanpa fallback senyap ke 1:1.Tingkat × rasio → piksel keluaran:Format ③: piksel tepat
Saatsize adalah widthxheight, piksel dipakai apa adanya dan resolution tidak berlaku. Menerima 2048X1024 / 2048×1024.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)
"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://atauhttps://- Contoh:
https://example.com/image.jpg
- Format:
data:image/<format>;base64,<data>—<format>harus huruf kecil - Contoh:
data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
- 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_formatsetara denganoutput_format; nilai lain diperlakukan sebagaijpeg.
boolean
default:"false"
Apakah menambahkan watermark “AI generated” di kanan bawah
true: tambahkan watermarkfalse: 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
<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:<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. GantiYOUR_API_KEY sebelum menjalankannya.
Python
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:Respons dan rekonstruksi dekomposisi layer
Arrayurl, sizes, output_formats, dan layers saling bersesuaian berdasarkan indeks; indeks 0 selalu merupakan gambar dasar:
z_index menaik. Untuk merekonstruksinya pada gambar dasar keluaran dengan koordinat absolut:
W × H apa pun, gunakan koordinat yang dinormalisasi:
Catatan penagihan
- 1.5K harganya sama dengan 1K ($0.045).
- Dengan piksel tepat di
size, penagihan memakai luas keluaran aktual;resolutiontidak 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.
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