Seedream 5.5 API — üretim, RGBA, düzenleme, katmanlar ve zengin metin OCR
doubao-seedream-5-5-261028. için eksiksiz istek parametreleri, görsel kısıtları, katman yeniden oluşturma, zengin metin OCR ve kullanıma dayalı görsel fiyatlandırması
Seedream 5.5
doubao-seedream-5-5-261028 modelini POST https://apimaster.ai/v1/images/generations, bir JSON gövdesi ve Authorization: Bearer YOUR_API_KEY ile kullanın. APIMaster anahtarınızı konsolda oluşturun.
Metinden görsele, en fazla on referansla düzenleme, ardışık düzenleme, yerel saydam RGBA çıktısı, katmanlara ayırma ve zengin metin OCR desteklenir. Normal üretim bir görsel döndürür. Katmanlara ayırma bir taban ve ayrı katmanlar döndürür. Akış, sıralı görsel üretimi ve web araması desteklenmez. Eşzamanlı uç noktayı kullanın; istemci zaman aşımını en az 300 saniye yapın ve körlemesine yeniden göndermekten kaçının.
Resmî temel fiyatlandırma
2026-11-13 tarihinde Volcengine fiyatlandırması ile karşılaştırılarak doğrulandı. Yapılandırılan dönüşüm kuru USD başına 7 CNY idi.
| Kalem | Görsel başına CNY | Yaklaşık USD temel fiyatı |
|---|---|---|
| İlk dahil her giriş referansı | 0.05 | 0.00714286 |
| Genişlik × yükseklik ≤ 2,610,000 piksel olan çıktı | 0.13 | 0.01857143 |
| 2,610,000 pikselin üzerindeki çıktı | 0.23 | 0.03285714 |
Üretim ve katmanlara ayırma aynı çıktı ücretlerini kullanır. Her taban/katmanı gerçek data[].size değerini kullanarak ayrı ayrı ücretlendirin; en uzun kenar kademeyi belirlemez. 2048x1024 alt kademededir. İki giriş artı bir üst kademe çıktı, hesap/kanal çarpanlarından önce CNY 0.33 tutarındadır. Seedream 5.0 Pro'nun aksine, ilk referans ücretsiz değildir. Gerçek hesap ücretleri geçerli kanal/kullanıcı grubu katsayılarını ve tam sayı kota yuvarlamasını içerir. Canlı model kartına ve kullanım günlüklerine bakın.
Metinden görsele
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
}'
Parametreler
| Alan | Tür / varsayılan | Kurallar |
|---|---|---|
model |
zorunlu string | doubao-seedream-5-5-261028. |
prompt |
string | Üretim için zorunlu; katmanlara ayırma için isteğe bağlı. İçeriği, stili, en-boy oranını, metni veya düzenleme konumunu tanımlayın. Resmî yazım kılavuzu ≤300 Çince karakter veya ≤600 İngilizce kelime önerir; bu bir bayt sınırı değil, yönlendirmedir. |
image |
string veya string[] | Genel URL veya data:image/png;base64,.... Üretim için en fazla on referans; katmanlara ayırma için tam olarak bir giriş. Yerel dosya sistemi yolları çalışmaz. |
size |
string | Üretim varsayılan olarak 2K değerini alır; 1K, 1.5K, 2K veya tam WIDTHxHEIGHT. Katmanlara ayırma varsayılan olarak auto değerini alır, yalnızca auto ve bu üç kademeyi kabul eder. |
output_format |
string, png |
png veya jpeg. Katmanlara ayırmada bu yalnızca tabanı kontrol eder; katmanlar her zaman PNG'dir. |
background |
string, auto |
auto, transparent veya opaque, yalnızca üretim için. Saydam çıktı PNG gerektirir; katmanlara ayırma için bu alanı tamamen atlayın. |
response_format |
string, url |
url veya b64_json. Her data[] öğesinde eşleşen alanı okuyun. |
watermark |
boolean, true |
Görünür AI üretim filigranını atlamak için false değerini ayarlayın. |
optimize_prompt_options |
object | 5.5 tarafından yalnızca {"mode":"standard"} desteklenir; fast desteklenmez. |
layer_decomposition |
boolean, false |
Bir PNG/JPEG görselinin katmanlara ayrılmasını etkinleştirin. |
layer_decomposition_options |
object | Katmanlara ayırma seçenekleri aşağıda. |
layer_decomposition_options.max_images |
integer, 30 |
2–100, taban dahil. Garantili bir sayı değil, bir üst sınırdır. |
layer_decomposition_options.text_recognition |
boolean, false |
Normal metin katmanları için zengin metin OCR isteyin. |
safety_identifier |
string | Sabit İngilizce kullanıcı tanımlayıcısı, en fazla 64 karakter; kişisel iletişim bilgileri yerine bir hash kullanın. |
Bu modeli kontrol etmek için başka bir modelin resolution, quality, n veya seed alanlarını kullanmayın. Bunlar resmî API'de bu modelin karşılık gelen üretim kontrolleri olarak listelenmemiştir. Katmanlara ayırma sınırlarını layer_decomposition_options.max_images ile ayarlayın.
Boyutlar ve giriş kısıtları
Normal üretim için bir kademe (1K, 1.5K, 2K) seçin ve en-boy oranını istemde tanımlayın veya tam boyutları sağlayın. Tam çıktı alanı 921,600–4,624,220 piksel olmalı ve en-boy oranı 1:16–16:1 olacak şekilde her iki kısıtı da karşılamalıdır. 2880x1440 geçerlidir; 512x512 çok küçüktür. 4K kademesi yoktur.
Katmanlara ayırma tam boyutları kabul etmez. auto ile desteklenen aralıktaki taban/katman boyutları mümkün olduğunda orijinal boyutlarını korur; daha küçük/büyük öğeler en-boy oranlarını koruyarak 1K/2K değerine doğru ölçeklenir. Döndürülen katmanlar farklı faturalama kademelerinde yer alabilir.
| Giriş kısıtı | Üretim/düzenleme | Katmanlara ayırma |
|---|---|---|
| Adet | En fazla 10 | Tam olarak 1 |
| Biçimler | JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF | PNG, JPEG |
| Görsel başına dosya boyutu | ≤30 MB | ≤30 MB |
| Piksel alanı | 196–36,000,000; her iki kenar >14 piksel | 262,144–36,000,000 |
| En-boy oranı | 1:16–16:1 | 1:16–16:1 |
Veri URL'lerinde küçük harfli MIME türlerini kullanın. Uzak giriş URL'leri hizmet tarafından erişilebilir olmalıdır.
Düzenleme ve saydam görseller
{
"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
}
Tek bir giriş için image bir string olabilir. Ardışık düzenlemeler için önceki çıktıyı açıkça bir sonraki giriş olarak geçirin: bu, durum bilgisi tutan bir konuşma değildir ve her istek ayrı ayrı faturalandırılır. Koordinatları/kutuları/okları istemde tanımlayın veya referans üzerine işaretler çizin; bu arabirim için belgelenmiş ayrı bir mask konumlandırma parametresi yoktur.
Yerel saydam üretim için gereksizse image alanını atlayın ve background: "transparent", output_format: "png" değerlerini ayarlayın; istemde “yarı saydam mavi cam kelebek, izole varlık, saydam arka plan” gibi bir ifade kullanın. Düzenleme en fazla on referans kullanabilir; bunların hâlihazırda alfa kanalları olması gerekmez. transparent artı jpeg geçersizdir. Bir yanıtın background alanı gerçek saydamlığı (transparent veya opaque) açıklar.
Katmanlara ayırma ve zengin metin OCR
{
"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
}
Bir taban artı en fazla 99 katman destekler. max_images: 4 tabanı içerir. background alanını atlayın; her katman saydam PNG'dir. Tek bir katman hatası, kısmi başarı döndürmek yerine tüm isteği başarısız kılar.
Tüm data[] girdilerini okuyun:
url/b64_json,sizeveoutput_formatçıktı öğesini ve gerçek boyutlarını tanımlar;backgrounduygun olduğunda kullanılabilir.z_index: 0tabanı tanımlar; daha büyük endeksler daha küçüklerin üzerinde görünür.namevedescriptionkatmanı açıklar.bounding_box.absolute, çıktı tabanı piksellerinde[left,top,right,bottom]'dir. Bir katmanı(right-left) × (bottom-top)boyutuna yeniden boyutlandırın ve(left,top)konumuna yerleştirin; katman dosyası boyutları tuval üzerindeki kaplama alanından farklı olabilir.bounding_box.normalized, 0–1000 koordinatlarını kullanır. Yatay/dikey koordinatları hedef tuval genişliği/yüksekliği ile çarpın ve 1000. değerine bölün.text_recognitionyalnızca istendiğinde ve katman tanınan normal metin içerdiğinde görünür. El yazısı, sanatsal yazı ve metin olmayan katmanlar bunu atlayabilir.
OCR, text ve lines[] içerir; her satırın kendi bounding_box ve biçimlendirilmiş runs[] değeri vardır. Her metin parçasının text ve style değeri vardır; bunlar similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow ve translucent içerebilir. Bunlar tam orijinal tasarım özellikleri değil, yaklaşık görsel yorumlardır; yazı tipi tanıma unknown döndürebilir.
Yanıt, depolama ve hatalar
Yanıt created, model, data[], usage.input_images ve usage.generated_images içerir. Üretilen sayı tabanı ve katmanları içerir. Eksiksiz yanıt meta verilerini koruyun. Orijinal sağlayıcı indirme URL'leri 24 saat sonra sona erer; varlıklarınızı hemen indirin/arşivleyin.
Yeniden denemeden önce geçersiz boyutları, referans sayılarını veya uyumsuz saydamlık seçeneklerini düzeltin. Kimlik doğrulama, izinler, moderasyon, hız sınırları ve üst kaynak hatalarını ayrı ayrı ele alın; bir hatayı asla başarılı üretim olarak yorumlamayın. IPM sınırları hesap/model sürümü başına üretilen görselleri sayar; katmanlara ayırma max_images ayırır ve tamamlandıktan sonra kullanılmayan kapasiteyi döndürür, faturalama ise gerçekte üretilen görselleri kullanır.
Resmî kaynaklar: Seedream 5.5, Görsel üretimi API'si, fiyatlandırma. Parametreler 2026-11-13 tarihinde kontrol edildi.
