Seedgream 4.5 API'si nasıl kullanılır

CometAPI
AnnaDec 9, 2025
Seedgream 4.5 API'si nasıl kullanılır

Seedream 4.5, Seedream ailesinin metinden görsele / görsel düzenleme modellerindeki en yeni evrimidir (Byte/BytePlus araştırması kapsamında geliştirilmiştir). Resmi BytePlus uç noktaları ve CometAPI gibi çoklu model ağ geçitleri üzerinden entegre erişim de dahil olmak üzere birden fazla üçüncü taraf platformda kullanıma sunuluyor ve konu tutarlılığını, tipografi/metin oluşturmayı ve çoklu görsel düzenlemede sadakati iyileştiriyor.

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

Seedream 4.5 nedir?

Seedream 4.5, Seedream ailesinin en son sürümüdür — yüksek doğrulukta metinden görsele üretim ve bağlama duyarlı görüntü düzenleme (image-to-image, ç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 modeli. Önceki Seedream sürümleriyle karşılaştırıldığında, 4.5; çoklu görsel iş akışlarında konu tutarlılığını geliştirmeye, referans detaylarının daha sıkı korunmasına, daha yüksek tipografik doğruluğa (görüntülerde metin) ve “yüksek kalite” ayarlarında 4K/ultra-HD’ye kadar daha iyi çıktı kalitesine odaklanır. Bu iyileştirmeler, ölçeklenmiş bir mimari ve güncellenmiş istem ayarlaması / motor tarafı sezgisel kurallarla birlikte gelir.

Neden önemli: 4.5, profesyonel yaratıcı görevleri — toplu ürün varyasyonları, markaya tutarlı çoklu görsel düzenlemeler ve yüksek çözünürlüklü baskı varlıkları — ele almak için özellikle tasarlanmıştır ve referans görseller ile uzmanlaşmış düzenleme işlemleriyle daha ince kontrol sağlar.

Temel yetenekler

  • Metinden görsele üretim (tekli ve toplu): tek bir API çağrısında 1–15 görsel üretebilir, hız ve çözünürlük arasında denge sunan seçilebilir kalite modları (Basic ve High).
  • Görüntü düzenleme (i2i / inpainting / outpainting): bir veya daha fazla referans görsel kullanın; birden fazla referans arasında detayları ve mekansal ilişkileri korur.
  • Çoklu referans harmanlama ve öge kopyalama: tek bir işte ~10’a kadar referans görsel, öğeleri ışıklandırma/perspektif tutarlılığını koruyarak taşımak için kullanılabilir.
  • Yüksek tipografi/yoğun metin oluşturma: metin veya tabela içeren görselleri daha iyi işler (mockup’lar, ürün etiketleri, UI ekran görüntüleri için yararlıdır).
  • Akış/ilerlemeli çıktı: bazı dağıtım uç noktaları, üretim sürerken istemcilerin kısmi sonuçları alabilmesi için 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örsel üretimi için pratik, kopyala-yapıştır yapılabilir bir anlatım bulacaksınız. CometAPI, onlarca/yüzlerce modele tek bir API anahtarıyla erişmek ve stabil, kolay entegre edilebilir bir REST yüzeyi istediğinizde kullanılmalıdır. CometAPI dokümantasyonunda doubao-seedream-4-5-251128 model takma adı ve standart bir görsel üretim uç noktası gösterilir.

Yüksek seviyeli adımlar

  1. CometAPI’ye kaydolun ve bir API anahtarı alın.
  2. Görsel üretim uç noktasını kullanın (POST https://api.cometapi.com/v1/images/generations) 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örseller (toplayıcıya bağlı olarak URL’ler veya multipart yüklemeler), çıktı boyutu/kalitesi ve diğer parametreleri ekleyin.
  4. Üretilen görsel URL’lerini (veya base64) ve metaveriyi içeren bir JSON yanıtı alın.

İstek türleri ve modlar

Seedream 4.5 genellikle şunları destekler:

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

curl örneği (metinden görsele, 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 alanını CometAPI anahtarınızla değiştirin.
  • n parametresi tek bir çağrıda birden çok varyasyon üretir (ek yükü azaltır).
  • quality: "high" genellikle daha yüksek çözünürlük / daha yüksek hesaplama maliyetine karşılık gelir (çoğunlukla 4K desteği).

Python requests örneği (metinden görsele + 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 bir 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ı yoklayı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 sağlar.

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

  1. Tutarlı bağlam ve renk eşleşmesi için referans görseller kullanın.
  2. İstemde tipografiyi açıkça belirtin (yazı tipi ailesi, ağırlık, hizalama) ve okunabilirliği garanti etmek için ikinci bir adımda metni birebir bindirme olarak eklemeyi düşünün.
  3. İki aşamalı bir süreç çalıştırın: (a) temel kompozisyonu üretin; (b) yüksek çözünürlüklü yakın planlar veya etiket alanlarına odaklı 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 tasarımı ilkeleri

  • Açık olun: konuyu, eylemi, stili, lens/kamerayı, günün saatini ve istenen renk paletini listeleyin.
  • Kimlik çapalaması kullanın: Birden çok görselde aynı yüz/ögeyi 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örsel sağlayın. Seedream 4.5’ın çoklu referans füzyonu gelişmiştir, ancak çapalar yardımcı olur.
  • Negatif istemler: kaçınılacakları açıkça belirtin (ör. “metin yok”, “filigran yok”, “fazladan uzuv yok”).
  • Kısa + uzun hibrit: kısa, kanonik bir talimat verin, ardından birkaç satır detay ve kısıt ile genişletin.

Örnek istem şablonları

  • Ürün kahraman görseli (fotogerçekçi): "Beyaz bir masa üstüne yerleştirilmiş mat siyah kablosuz hoparlörün temiz bir ürün kahraman çekimi, softbox aydınlatma, 50mm, sığ alan derinliği, stüdyo arka planı, fotogerçekçi, metin yok"
  • Fantastik illüstrasyon (stilize): "Epik fantezi manzarası, bir uçurumun üzerinde yükselen camdan bir kale, altın saat, hacimli sis, resimsi, son derece detaylı, konsept sanat"
  • Görsel düzenleme (nesne kaldırma): "Soldaki kişiyi kaldırın ve boşluğu doldurmak için arka planı uzatın, ışıklandırmayı tutarlı tutun, eser oluşmasın"
  • Tipografi ağırlıklı mockup: "Bir iPhone 14 üzerinde mobil uygulama açılış ekranı mockup’ı, üzerinde 'Launch Now' metni Gotham Bold ile, düğmeyi yeşil yapın ve gölgeleri yumuşak tutun"
  • Karakter portresi: "Kadın bir savaşçının kahramanca portresi, sinematik kenar aydınlatma, 85mm portre lensi, ultra detaylı cilt dokusu, doğal çiller, deri zırh, nötr arka plan, fotogerçekçi."

Çoklu görsel ve referans istemleri

Çoklu görsel düzenleme kullanırken, hangi referans görselin istemin hangi kısmına karşılık geldiğini belirtin. Seedream 4.5, birden fazla 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 adet varyasyon üretin ve nesnel filtreler çalıştırın: yüz benzerliği skoru, renk histogramı karşılaştırması, metin doğruluğunu kontrol etmek için tipografi OCR.
  • Eşik altı çıktıları manuel rötuşa yönlendirmek üzere otomatik KG eşikleri belirleyin.
  • Piksel hassasiyetinde metin gerekiyorsa son tipografiyi yerleşim araçlarına bırakın — arka plan ve görsellik için modeli kullanın, ardından metni postta hassas şekilde birleştirin. Bu, pazarlama varlıkları için modelin metin doğruluğuna bağımlılığı azaltır.

Görüntü düzenleme, inpainting ve çoklu görsel kompozisyonu nasıl yapılır?

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

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

Birçok API hem tek görselle düzenleme hem de çoklu görselle kompozisyon modlarını destekler; 4.5, konu kimliğini koruma ve çoklu görsel tutarlılığını iyileştirme konusunda özellikle ayarlanmıştır.

Örnek: Inpainting yükü (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örsel düzenleme için ipuçları

  • İlgili oluşturmalarda tutarlılığı korumak için aynı seed değerini kullanın.
  • Bakış açısı tutarlılığı için istemler boyunca kamera tanımlarını sabit tutun (ör. “85mm portre, softbox, 3/4”).
  • Yüz düzenlerken, kimlik kaymasını azaltmak için ayrıntılı koruma maddeleri isteyin (“yüz yapısını koru, yalnızca saç rengini değiştir”).

Seedream 4.5 kullanırken en iyi uygulamalar nelerdir

Yaygın sorunları nasıl giderirsiniz?

Sonuçlar beklediğiniz gibi değilse uygulanabilir sorun giderme adımları:

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

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

Metin okunamıyor veya bozuk

Piksel mükemmelliğinde tipografi gerekiyorsa metni vektör veya raster bindirme olarak ayrı bir katmanda sağlayın; aksi halde daha yüksek çözünürlük ayarlarını ve açık “okunaklı metin oluştur: evet” tarzı talimatları kullanın. 4.5 önceki sürümlere kıyasla yoğun metin işlemeyi iyileştirir, ancak tipografik kusursuzluk yine de postta kompozit gerektirebilir.

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

Işıklandırma/kamera vurguları sabit olan şablon bir istem kullanın veya tutarlılığı artırmak için tek bir toplu çağrı içinde üretin. 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ına yönelik açık iyileştirmelerle olgun, üretim odaklı bir görüntü modelidir: daha iyi tutarlılık, geliştirilmiş metin ve yüz oluşturma ile çoklu referans desteği. Hızlı deney ve çoklu model esnekliği istediğinizde CometAPI veya benzeri toplayıcıları kullanın.

Geliştiriciler, CometAPI aracılığıyla Seedream 4.5 API vb.’ye erişebilir; en son model sürümü her zaman resmi web sitesiyle günceldir. Başlamak için, modelin yeteneklerini Playground’da keşfedin ve ayrıntılı talimatlar için API guide’a başvurun. Erişimden önce, CometAPI’ye giriş yaptığınızdan ve API anahtarını edindiğinizden emin olun. CometAPI entegrasyona yardımcı olmak için resmi fiyattan çok daha düşük bir fiyat sunar.

Hazır mısınız?→ Seedream 4.5’i ücretsiz deneyin

Daha fazla ipucu, rehber ve yapay zeka haberleri için bizi VK, X ve Discord üzerinden takip edin!

Devamını Oku

500+ Model Tek Bir API'de

%20'ye Varan İndirim