Seedgream 4.5 API’si nasıl kullanılır?

Seedream 4.5, (Byte/BytePlus araştırmaları kapsamında geliştirilen) Seedream metinden-görüntüye / görüntü düzenleme model ailesinin en yeni evrimidir. Resmi BytePlus uç noktalarında ve CometAPI gibi çoklu model ağ geçitleri üzerinden entegre erişim de dahil olmak üzere, birden çok üçüncü taraf platformda kullanıma sunuluyor ve geliştirilmiş konu tutarlılığı, tipografi/metin işleme ve çoklu görüntü düzenleme doğruluğu sağlıyor.

Bu makale, Seedream 4.5 API’sini kullanmaya yönelik uygulamalı, profesyonel bir kılavuzdur. Pratik kurulum adımları, kimlik doğrulama ve istek kalıpları, istem ve parametre en iyi uygulamaları, düzenleme ve çoklu görüntü iş akışları, hata yönetimi, dağıtım kalıpları ve hukuki/güvenlik hususlarını bulacaksınız.

Seedream 4.5 nedir?

Seedream 4.5, Seedream ailesinin son yinelemesidir — yüksek doğrulukta metinden-görüntü oluşturma ve bağlamı gözeten görüntü düzenleme (görüntüden-görüntüye, çoklu referans düzenleme, inpainting/outpainting, tipografi ve yoğun metin işleme) için tasarlanmış çok modlu bir görüntü üretim ve düzenleme modelidir. Önceki Seedream sürümleriyle karşılaştırıldığında, 4.5 çoklu görüntü iş akışlarında geliştirilmiş konu tutarlılığına, referans detaylarının daha sıkı korunmasına, daha yüksek tipografik sadakate (görüntülerdeki metin) ve “yüksek kalite” ayarlarında 4K/ultra-HD’ye kadar daha iyi çıktı kalitesine odaklanır. Bu iyileştirmeler, ölçeklendirilmiş mimari ve güncellenmiş istem ayarlaması / motor tarafı sezgisel kuralların bir parçası olarak gelir.

Neden önemli: 4.5, profesyonel yaratıcı görevleri — toplu ürün varyasyonları, marka tutarlı çoklu görüntü düzenlemeleri ve yüksek çözünürlüklü baskı varlıkları — ele almak üzere, referans görüntüler ve özel düzenleme işlemleriyle daha ince kontrol sağlayacak şekilde bilinçli olarak tasarlanmıştır.

Temel yetenekler

• Metinden görüntü oluşturma (tekil ve toplu): bir API çağrısında 1–15 görüntü üretebilir, hız ve çözünürlük arasında denge kuran seçilebilir kalite kipleri (Basic vs High) sunar.
• Görüntü düzenleme (i2i / inpainting / outpainting): bir veya daha fazla referans görüntüsü kullanır; birden fazla referans arasında ayrıntı ve uzamsal ilişkileri korur.
• Çoklu referans harmanlama ve öğe kopyalama: tek bir işte ~10’a kadar referans görüntü kullanılarak öğeler aktarılabilir; ışık/perspektif uyumu korunur.
• Yüksek tipografi/yoğun metin işleme: metin veya tabelalar içeren görüntülerde daha iyi işleme (mockup’lar, ürün etiketleri, UI ekran görüntüleri için faydalı).
• Akış / ilerlemeli çıktı: bazı dağıtım uç noktaları, istemcilerin üretim sürerken kısmi sonuçlar almasına olanak veren akış desteği sunar.

Seedream 4.5 API’sini CometAPI üzerinden nasıl kullanırım?

Aşağıda, Seedream 4.5 modelini bir model parametresi olarak sunan bir toplayıcı olan CometAPI üzerinden görüntü üretmeye yönelik pratik, kopyala-yapıştır bir yürüyüş bulunmaktadır. CometAPI’yi, yüzlerce modele tek bir API anahtarıyla erişmek ve stabil, entegre edilmesi kolay bir REST yüzeyi istediğinizde kullanın. CometAPI dokümantasyonu, doubao-seedream-4-5-251128 model takma adını ve standart bir görüntü üretim uç noktasını gösterir.

Üst düzey adımlar

1. CometAPI’ye kaydolun ve bir API anahtarı edinin.
2. Görüntü üretim uç noktasını (POST https://api.cometapi.com/v1/images/generations) kullanın ve model parametresini Seedream 4.5 tanımlayıcısına ayarlayın (örnek: doubao-seedream-4-5-251128).
3. İstem, isteğe bağlı referans görüntüler (toplayıcıya bağlı olarak URL’ler veya çok parçalı yüklemeler), çıktı boyutu/kalitesi ve diğer parametreleri ekleyin.
4. Üretilen görüntü URL’lerini (veya base64) ve metaveriyi içeren bir JSON yanıtı alın.

İstek türleri ve kipler

Seedream 4.5 genellikle şunları destekler:

• Metin → Görüntü (metin istemleri → yeni görüntüler)
• Görüntü → Görüntü (stilize dönüşümler için referans görüntüler + istemler)
• Görüntü Düzenleme / Inpainting (hedefli değişiklikler için maske + düzenleme talimatları)
  barındırılan API’ler, uzun süreli oluşturma ve toplu iş akışlarına uyan eşzamansız görev kiplerini (iş gönder → taskId ile sorgula) destekler. Üretilen bağlantılar sıklıkla zaman sınırlıdır (ör. bazı ağ geçitlerinde 24 saat geçerlidir); bu nedenle depolama/dışa aktarma için plan yapın.

curl örneği (metinden görüntüye, tek istem)

curl -X POST "https://api.cometapi.com/v1/images/generations" \
  -H "Authorization: Bearer COMETAPI_KEY_GOES_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "A cinematic portrait of a cyberpunk fox in neon rain, 4k, detailed lighting, film grain",
    "n": 3,
    "width": 2048,
    "height": 2048,
    "quality": "high",     # or "basic"
    "seed": 12345,
    "style": "photorealistic"
  }'

Notlar

• COMETAPI_KEY_GOES_HERE ifadesini kendi CometAPI anahtarınızla değiştirin.
• n parametresi tek çağrıda birden fazla varyasyon üretir (ek yükü azaltır).
• quality: "high" genellikle daha yüksek çözünürlük / daha yüksek hesaplama maliyetiyle eşleşir (sıklıkla 4K desteklidir).

Python requests örneği (metinden görüntü + sonuçları kaydetme)

import requests, base64, os

API_URL = "https://api.cometapi.com/v1/images/generations"
API_KEY = os.environ.get("COMETAPI_KEY")  # set env var for safety

payload = {
  "model": "doubao-seedream-4-5-251128",
  "prompt": "Studio shot of a ceramic mug on a wooden table, warm natural light, ultra-detailed, 2k",
  "n": 2,
  "width": 1024,
  "height": 1024,
  "quality": "basic"
}

resp = requests.post(API_URL, json=payload, headers={
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
})
resp.raise_for_status()
data = resp.json()

# Example: each item has 'b64_json' or 'url' depending on provider
for i, item in enumerate(data.get("data", [])):
    img_b64 = item.get("b64_json")
    if img_b64:
        img_bytes = base64.b64decode(img_b64)
        with open(f"seedream_result_{i}.png", "wb") as f:
            f.write(img_bytes)
    else:
        print("Image URL:", item.get("url"))

Neden bu kalıp? Toplayıcılar genellikle ya base64 yükü ya da barındırılan URL’ler döndürür; kod her ikisini de ele alır. Uç nokta tipik olarak bir task_id döndürür. Durum succeeded olana kadar GET /tasks/{task_id} uç noktasını sorgulayın ve ardından sonucu indirin. Birçok sağlayıcı bu kalıp için yerleşik yardımcılar içeren SDK’lar sunar.

Görüntü kalitesini nasıl optimize eder ve metni okunur tutarım?

1. Tutarlılık ve renk eşlemesi için referans görüntüler kullanın.
2. İstemde tipografiyi açıkça belirtin (yazı tipi ailesi, kalınlık, hizalama) ve okunurluğu garanti etmek için ikinci bir adımda metni tam olarak bindirme olarak eklemeyi düşünün.
3. İki aşamalı bir süreç çalıştırın: (a) temel kompozisyonu üretin; (b) yakın planlar veya etiket alanlarına odaklanan, daha yüksek çözünürlüklü ikinci bir düzenleme/yeniden oluşturma geçişi yapın.

Seedream 4.5 için istemleri nasıl yazmalısınız?

İstem oluşturma ilkeleri

• Açık olun: konuyu, eylemi, stili, lens/kamerayı, günü saatini ve istenen renk paletini listeleyin.
• Kimlik ankrajları kullanın: Aynı yüz/öğeyi görüntüler arasında istiyorsanız, kalıcı tanımlayıcılar ekleyin (ör. “kısa dalgalı saçlı, yeşil ceketli, sol kaşında yara izi olan aynı kadın”) ve 1–3 referans görüntüsü sağlayın. Seedream 4.5’ın çoklu referans füzyonu gelişmiştir, ancak ankrajlar yardımcı olur.
• Negatif istemler: kaçınılması gerekenleri açıkça belirtin (ör. “metin yok”, “filigran yok”, “ekstra uzuv yok”).
• Kısa + uzun hibrit: kısa bir kanonik talimat verin, ardından birkaç satır ayrıntı ve kısıtlamayla genişletin.

Örnek istem şablonları

Ürün kahraman çekimi (foto-gerçekçi): "Beyaz bir masa üzerinde konumlandırılmış mat siyah kablosuz hoparlörün temiz bir ürün kahraman çekimi, softbox ışık, 50mm, sığ alan derinliği, stüdyo arka planı, fotogerçekçi, metin yok"

Fantastik illüstrasyon (stilize): "Epik fantastik manzara, bir uçurumda yükselen cam bir kale, altın saat, hacimsel sis, ressamsı, son derece detaylı, konsept sanat"

Görüntü düzenleme (nesne kaldırma) : "Soldaki kişiyi kaldır ve boşluğu doldurmak için arka planı genişlet, ışıklandırmayı tutarlı tut, artefakt olmasın"

Tipografi ağırlıklı mockup: "iPhone 14 üzerinde mobil uygulama açılış ekranı mockup’ı, 'Launch Now' metni Gotham Bold ile, butonu yeşil yap ve gölgeleri yumuşak tut"

Karakter portresi: "Kahramansı bir kadın savaşçı portresi, sinematik kenar ışığı, 85mm portre lensi, ultra detaylı cilt dokusu, doğal çiller, deri zırh, nötr arka plan, fotogerçekçi."

Çoklu görüntü ve referans istemleri

Çoklu görüntü düzenleme kullanırken, hangi referans görüntünün istemin hangi kısmına karşılık geldiğini belirtin. Seedream 4.5, birden çok referans arasında ana konuyu belirlemede gelişmiştir — ancak açık olmak (ör. “yüz için image_1’i, kıyafet dokusu için image_2’yi kullan”) daha iyi sonuç verir.

Çıktı seçimi ve son işlem

• N varyant üretin ve nesnel filtreler çalıştırın: yüz benzerliği skoru, renk histogramı karşılaştırması, tipografi OCR ile metin doğruluğunu kontrol edin.
• QC eşiklerini otomatikleştirin ve eşik altında kalan çıktıları manuel rötuşa yönlendirin.
• Nihai tipografiyi yerleşim araçlarına bırakın piksel hassasiyeti gerekiyorsa — arka planlar ve görseller için modeli kullanın, ardından kesin metni postta birleştirin. Bu, pazarlama varlıklarında modelin metin sadakatine bel bağlama ihtiyacını azaltır.

---

Görüntü düzenleme, inpainting ve çoklu görüntü kompozisyonunu nasıl gerçekleştirirsiniz?

Görüntü düzenleme iş akışı

1. Referans görüntü(ler)i sağlayıcıya yükleyin veya isteğin içine ekleyin.
2. Inpainting için bir maske (ikili görüntü) veya hedefli düzenlemeler için bir sınırlayıcı açıklama sağlayın.
3. Hangi bölgelerin değiştirileceğini ve hangilerinin korunacağını netleştiren bir düzenleme istemi gönderin.

Birçok API, tek görüntü düzenleme ve çoklu görüntü kompozisyon kiplerini destekler; 4.5, konu kimliğini korumaya ve çoklu görüntü tutarlılığını artırmaya açıkça ayarlanmıştır.

Örnek: Inpainting payload (JSON sözde kodu)

{
  "model": "seedream-4.5",
  "mode": "image_edit",
  "image_url": "https://.../original.png",
  "mask_url": "https://.../mask.png",
  "prompt": "Replace background with a sunset beach — keep subject untouched, maintain original lighting on subject",
  "guidance": 9,
  "steps": 40
}

Tutarlı çoklu görüntü düzenleme ipuçları

• İlgili render’lar için aynı seed değerini kullanın; kareler arasında tutarlılığı artırır.
• Bakış açısı tutarlılığı için istemler arasında kamera tanımlayıcılarını sabit tutun (ör. “85mm portre, softbox, 3/4”).
• Yüzleri düzenlerken, kimlik sapmasını azaltmak için ayrıntılı koruma maddeleri isteyin (“yüz yapısını koru, sadece saç rengini değiştir”).

Seedream 4.5 kullanırken en iyi uygulamalar nelerdir

Yaygın sorunları nasıl giderirsiniz?

Sonuçlar beklenenden sapıyorsa işte pratik sorun giderme adımları:

Bulanık yüzler / yanlış ayrıntılar

Yüz ayrıntıları (yaş, ifade, ışıklandırma) için istem özgüllüğünü artırın, daha yüksek kaliteli referans görüntüler sağlayın veya açık bir “yüzü koru” talimatı deneyin ve orijinalin daha fazlasını korumak için düzenleme strength değerini düşürün. Seedream 4.5 yüz gerçekçiliğini iyileştirir, ancak girdiler hâlâ kritiktir.

Metin okunamıyor veya bozuk

Piksel hassasiyetinde tipografi gerekiyorsa vektör veya raster metni ayrı bir bindirme olarak sağlayın; aksi halde daha yüksek çözünürlük ayarları ve açık “render legible text: yes” tarzı talimatlar kullanın. 4.5, önceki sürümlere kıyasla yoğun metin işlemeyi iyileştirir, ancak tipografik mükemmellik yine de postta birleştirme gerektirebilir.

Toplu işlerde tutarsız ışıklandırma veya kompozisyon

Aydınlatma/kamera atıfları sabit olan şablon bir istem kullanın veya tutarlılığı artırmak için tek bir toplu çağrı içinde üretim yapın. BytePlus ve CometAPI bu nedenle toplu çıkarım kalıpları sağlar.

Son notlar ve sonraki adımlar

Seedream 4.5, gerçek yaratıcı iş akışlarını hedefleyen belirgin iyileştirmelere sahip, olgun ve üretim odaklı bir görüntü modelidir: daha iyi tutarlılık, geliştirilmiş metin ve yüz işleme, ve çoklu referans desteği. Hızlı denemeler ve çoklu model esnekliği istediğinizde CometAPI veya benzeri toplayıcıları kullanın.

Geliştiriciler, CometAPI aracılığıyla [Seedream 4.5](http://Seedream 4.5) API vb.’ye erişebilir, the latest model version her zaman resmi web sitesiyle eşzamanlı olarak güncellenir. Başlamak için, modelin yeteneklerini Playground içinde keşfedin ve ayrıntılı talimatlar için API guide’a bakın. Erişmeden önce, CometAPI’ye giriş yaptığınızdan ve API anahtarını edindiğinizden emin olun. CometAPI entegrasyonu kolaylaştırmak için resmi fiyattan çok daha düşük bir fiyat sunar.

Ready to Go?→ Free trial of Seedream 4.5 !

Daha fazla ipucu, kılavuz ve habere göz atmak isterseniz bizi VK, X ve Discord üzerinden takip edin!