APIMaster.ai

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, size ve output_format çıktı öğesini ve gerçek boyutlarını tanımlar; background uygun olduğunda kullanılabilir.
  • z_index: 0 tabanı tanımlar; daha büyük endeksler daha küçüklerin üzerinde görünür.
  • name ve description katmanı 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_recognition yalnı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.