Seedream 5.5

Gunakan model doubao-seedream-5-5-261028 dengan POST https://apimaster.ai/v1/images/generations, body JSON, dan Authorization: Bearer YOUR_API_KEY. Buat kunci APIMaster Anda di konsol.

Mendukung text-to-image, penyuntingan dengan hingga sepuluh referensi, penyuntingan berturut-turut, keluaran RGBA transparan native, dekomposisi lapisan, dan OCR teks kaya. Generasi normal mengembalikan satu gambar. Dekomposisi mengembalikan basis dan lapisan terpisah. Streaming, generasi gambar berurutan, dan pencarian web tidak didukung. Gunakan endpoint sinkron; beri waktu setidaknya 300 detik sebelum timeout klien dan hindari pengiriman ulang secara buta.

Harga dasar resmi

Diperiksa berdasarkan harga Volcengine pada 2026-11-13. Kurs konversi yang dikonfigurasi adalah 7 CNY per USD.

Item	CNY per gambar	Perkiraan harga dasar USD
Setiap referensi masukan, termasuk yang pertama	0.05	0.00714286
Keluaran dengan lebar × tinggi ≤ 2,610,000 piksel	0.13	0.01857143
Keluaran di atas 2,610,000 piksel	0.23	0.03285714

Generasi dan dekomposisi menggunakan tarif keluaran yang sama. Tagih setiap basis/lapisan secara terpisah menggunakan data[].size aktualnya; tepi terpanjang tidak menentukan tier. 2048x1024 berada di tier yang lebih rendah. Dua masukan ditambah satu keluaran tier tinggi membutuhkan biaya CNY 0.33 sebelum pengali akun/channel. Tidak seperti Seedream 5.0 Pro, referensi pertama tidak gratis. Biaya akun aktual mencakup koefisien channel/grup pengguna yang berlaku dan pembulatan kuota bilangan bulat. Lihat kartu model langsung dan log penggunaan.

Teks ke gambar

curl --max-time 300 "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"doubao-seedream-5-5-261028",
    "prompt":"A cream landscape poster, a red circle, a blue square, heading HELLO SEEDREAM",
    "size":"1.5K",
    "output_format":"png",
    "background":"opaque",
    "response_format":"url",
    "watermark":false
  }'

Parameter

Bidang	Tipe / default	Aturan
model	string wajib	doubao-seedream-5-5-261028.
prompt	string	Wajib untuk generasi; opsional untuk dekomposisi. Jelaskan konten, gaya, rasio aspek, teks, atau lokasi penyuntingan. Panduan penulisan resmi merekomendasikan ≤300 karakter Mandarin atau ≤600 kata bahasa Inggris; ini adalah panduan, bukan batas byte.
image	string atau string[]	URL publik atau data:image/png;base64,.... Hingga sepuluh referensi generasi; tepat satu masukan untuk dekomposisi. Path sistem berkas lokal tidak berfungsi.
size	string	Generasi default ke 2K; 1K, 1.5K, 2K, atau WIDTHxHEIGHT persis. Dekomposisi default ke auto, hanya menerima auto dan ketiga tier ini.
output_format	string, png	png atau jpeg. Untuk dekomposisi ini hanya mengontrol basis; lapisan selalu PNG.
background	string, auto	auto, transparent, atau opaque, hanya untuk generasi. Keluaran transparan memerlukan PNG; hilangkan bidang ini sepenuhnya untuk dekomposisi.
response_format	string, url	url atau b64_json. Baca bidang yang sesuai di setiap item data[].
watermark	boolean, true	Atur false untuk menghilangkan tanda air generasi AI yang terlihat.
optimize_prompt_options	object	Hanya {"mode":"standard"} yang didukung oleh 5.5; fast tidak didukung.
layer_decomposition	boolean, false	Aktifkan dekomposisi satu gambar PNG/JPEG.
layer_decomposition_options	object	Opsi dekomposisi di bawah.
layer_decomposition_options.max_images	integer, 30	2–100, termasuk basis. Nilai maksimum, bukan jumlah yang dijamin.
layer_decomposition_options.text_recognition	boolean, false	Minta OCR teks kaya untuk lapisan teks reguler.
safety_identifier	string	Pengenal pengguna bahasa Inggris yang stabil, paling banyak 64 karakter; gunakan hash sebagai ganti informasi kontak pribadi.

Jangan gunakan resolution, quality, n, atau seed milik model lain untuk mengontrol model ini. Ini tidak tercantum sebagai kontrol generasi yang sesuai dalam API resmi. Atur batas dekomposisi dengan layer_decomposition_options.max_images.

Ukuran dan batasan masukan

Untuk generasi biasa, pilih tier (1K, 1.5K, 2K) dan jelaskan rasio aspek dalam prompt, atau berikan dimensi persis. Luas keluaran persis harus 921,600–4,624,220 piksel, dengan rasio aspek 1:16–16:1, memenuhi kedua batasan. 2880x1440 valid; 512x512 terlalu kecil. Tidak ada tier 4K.

Dekomposisi tidak menerima dimensi persis. Dengan auto, ukuran basis/lapisan dalam rentang yang didukung mempertahankan dimensi aslinya jika memungkinkan; item yang lebih kecil/lebih besar diskalakan menuju 1K/2K sambil mempertahankan rasio aspeknya. Lapisan yang dikembalikan dapat menempati tier penagihan yang berbeda.

Batasan masukan	Generasi/penyuntingan	Dekomposisi
Jumlah	Hingga 10	Tepat 1
Format	JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF	PNG, JPEG
Ukuran berkas per gambar	≤30 MB	≤30 MB
Luas piksel	196–36,000,000; kedua sisi >14 px	262,144–36,000,000
Rasio aspek	1:16–16:1	1:16–16:1

Gunakan tipe MIME huruf kecil di URL data. URL masukan jarak jauh harus dapat diakses oleh layanan.

Penyuntingan dan gambar transparan

{
  "model":"doubao-seedream-5-5-261028",
  "prompt":"Keep the layout of the first image; recolor only its circle using the second reference",
  "image":["https://example.com/source.png","https://example.com/reference.png"],
  "size":"1.5K",
  "output_format":"png",
  "watermark":false
}

Untuk satu masukan, image dapat berupa string. Untuk penyuntingan berturut-turut, teruskan secara eksplisit keluaran sebelumnya sebagai masukan berikutnya: ini bukan percakapan stateful, dan setiap permintaan ditagih terpisah. Jelaskan koordinat/kotak/panah dalam prompt atau gambar tanda pada referensi; tidak ada parameter pemosisian mask terpisah yang didokumentasikan untuk antarmuka ini.

Untuk generasi transparan native, hilangkan image jika tidak perlu dan atur background: "transparent", output_format: "png", dengan prompt seperti “a translucent blue glass butterfly, isolated asset, transparent background”. Penyuntingan dapat menggunakan hingga sepuluh referensi; referensi tersebut tidak harus sudah memiliki kanal alpha. transparent ditambah jpeg tidak valid. background pada respons menjelaskan transparansi aktual (transparent atau opaque).

Dekomposisi dan OCR teks kaya

{
  "model":"doubao-seedream-5-5-261028",
  "image":"https://example.com/poster.png",
  "prompt":"Separate the heading, circle and square into editable layers",
  "layer_decomposition":true,
  "layer_decomposition_options":{"max_images":4,"text_recognition":true},
  "size":"auto",
  "output_format":"png",
  "watermark":false
}

Mendukung satu basis plus hingga 99 lapisan. max_images: 4 termasuk basis. Hilangkan background; setiap lapisan adalah PNG transparan. Kegagalan satu lapisan membuat seluruh permintaan gagal alih-alih mengembalikan keberhasilan sebagian.

Baca semua entri data[]:

• url/b64_json, size, dan output_format mengidentifikasi artefak dan dimensi aktualnya; background tersedia jika berlaku.
• z_index: 0 mengidentifikasi basis; indeks yang lebih besar muncul di atas yang lebih kecil.
• name dan description menjelaskan lapisan.
• bounding_box.absolute adalah [left,top,right,bottom] dalam piksel basis keluaran. Ubah ukuran lapisan ke (right-left) × (bottom-top) dan tempatkan di (left,top); dimensi berkas lapisan dapat berbeda dari jejak kanvasnya.
• bounding_box.normalized menggunakan koordinat 0–1000. Kalikan koordinat horizontal/vertikal dengan lebar/tinggi kanvas target dan bagi dengan 1000.
• text_recognition hanya muncul jika diminta dan lapisan berisi teks reguler yang dikenali. Tulisan tangan, huruf artistik, dan lapisan non-teks dapat menghilangkannya.

OCR berisi text dan lines[]; setiap baris memiliki bounding_box sendiri dan runs[] bergaya. Setiap run memiliki text dan style, yang dapat berisi similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow, dan translucent. Ini adalah interpretasi visual perkiraan, bukan properti desain asli yang persis; pengenalan font dapat mengembalikan unknown.

Respons, penyimpanan, dan kegagalan

Respons berisi created, model, data[], usage.input_images, dan usage.generated_images. Jumlah yang dihasilkan mencakup basis dan lapisan. Pertahankan metadata respons lengkap. URL unduhan penyedia asli kedaluwarsa setelah 24 jam; segera unduh/arsipkan aset Anda.

Perbaiki dimensi, jumlah referensi, atau opsi transparansi yang tidak kompatibel sebelum mencoba lagi. Tangani autentikasi, izin, moderasi, batas laju, dan kegagalan upstream secara terpisah; jangan pernah menafsirkan kesalahan sebagai generasi yang berhasil. Batas IPM menghitung gambar yang dihasilkan per akun/versi model; dekomposisi mencadangkan max_images dan mengembalikan kapasitas yang tidak terpakai setelah selesai, sedangkan penagihan menggunakan gambar yang benar-benar dihasilkan.

Sumber resmi: Seedream 5.5, API generasi gambar, harga. Parameter diperiksa pada 2026-11-13.