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 evrimdir (Byte/BytePlus araştırması kapsamında geliştirilmiştir). Resmi BytePlus uç noktaları ve CometAPI gibi çoklu model geçitleri aracılığıyla entegre erişim dahil olmak üzere birden fazla üçüncü taraf platformda kullanıma sunuluyor ve özne tutarlılığı, tipografi/metin oluşturma ve çoklu görsel düzenleme sadakatinde iyileştirmeler getiriyor.

Bu makale, Seedream 4.5 API’sini kullanmaya yönelik uygulamalı, profesyonel bir rehberdir. 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 hukuki/güvenlik hususlarını edineceksiniz.

Seedream 4.5 nedir?

Seedream 4.5, Seedream ailesinin en son yinelemesidir — yüksek doğrulukta metinden görsele üretim ve bağlama duyarlı görsel 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ış multimodal bir görsel oluşturma ve düzenleme modeli. Önceki Seedream sürümleriyle karşılaştırıldığında 4.5, çoklu görsel iş akışlarında iyileştirilmiş özne tutarlılığına, referans ayrıntılarını daha sıkı korumaya, daha yüksek tipografik doğruluğa (görsellerdeki metin) ve “yüksek kalite” ayarlarında 4K/ultra HD’ye kadar daha iyi çıktı kalitesine odaklanır. Bu iyileştirmeler, ölçeklenmiş bir mimarinin ve güncellenmiş istem ayarlama / motor tarafı sezgisel tekniklerin bir parçası olarak gelir.

Neden önemli: 4.5, kasıtlı olarak profesyonel yaratıcı görevleri — toplu ürün varyasyonları, marka tutarlı çoklu görsel düzenlemeler ve yüksek çözünürlüklü baskı varlıkları — ele almak için tasarlanmıştır; referans görselleri ve özel düzenleme işlemleriyle daha ince kontrol sağlar.

Temel yetenekler

• Metinden görsele üretim (tekli ve toplu): API çağrısı başına 1–15 görsel üretin; hız ve çözünürlüğü dengeleyen seçilebilir kalite kipleri (Basic ve High).
• Görsel düzenleme (i2i / inpainting / outpainting): bir veya daha fazla referans görsel kullanın; birden fazla referans arasında ayrıntı ve mekânsal ilişkileri korur.
• Çoklu referans harmanlama ve öğe kopyalama: tek bir işte ~10’a kadar referans görsel kullanarak öğeleri taşırken ışık/perspektif uyumunu sürdürür.
• 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 faydalıdır).
• Akış/kademeli çıktı: bazı dağıtım uç noktaları, üretim devam ederken 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 üretimine yönelik pratik, kopyala-yapıştır bir yürütme örneği bulacaksınız. Çok sayıda modele tek bir API anahtarıyla ve kararlı, kolay entegre edilebilir bir REST yüzeyiyle erişmek istediğinizde CometAPI’yi kullanın. CometAPI dokümantasyonu, doubao-seedream-4-5-251128 model takma adını ve standart bir görsel üretim uç noktasını gösterir.

Üst düzey 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 çok parçalı 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 kipleri

Seedream 4.5 genellikle şunları destekler:

• Metin → Görsel (metin istemleri → yeni görseller)
• Görsel → Görsel (referans görseller + stillendirilmiş dönüşümler için istemler)
• Görsel Düzenleme / Inpainting (hedefli değişiklikler için maske + düzenleme talimatları)
  barındırılan API’ler eşzamansız görev kiplerini (iş gönder → taskId ile yokla) destekler; bu, uzun süren üretimler ve toplu iş akışları için uygundur. Üretilen bağlantılar genellikle zaman sınırlıdır (ör. bazı ağ geçitlerinde 24 saat geçerli) bu nedenle depolama/dışa aktarma planlayı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 ifadesini CometAPI anahtarınızla değiştirin.
• n parametresi tek ç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 maliyetiyle eşleşir (çoğu zaman 4K desteklidir).

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 base64 yükü veya barındırılan URL’ler döndürür; kod her iki durumu da 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 desen için yerleşik yardımcılar içeren SDK’lar sunar.

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. İstem içinde tipografiyi açıkça belirtin (yazı tipi ailesi, kalınlık, hizalama) ve okunabilirliği garanti altına almak için ikinci bir adımda metni tam olarak bir örtücü katman olarak eklemeyi düşünün.
3. İki aşamalı bir süreç yürütün: (a) temel kompozisyonu üretin; (b) yakın planlar veya etiket alanlarına odaklanan ikinci bir geçişte daha yüksek çözünürlükle yeniden üretin veya düzenleyin.

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

İstem mühendisliği ilkeleri

• Açık olun: özne, eylem, stil, lens/kamera, günün saati ve istenen renk paletini listeleyin.
• Kimlik sabitleyicileri kullanın: aynı yüz/nesne birçok görselde gerekliyse kalıcı betimleyiciler ekleyin (örn. “kısa dalgalı saçlı, yeşil ceketli, sol kaş üzerinde yara izi olan aynı kadın”) ve 1–3 referans görsel sağlayın. Seedream 4.5’in çoklu referans füzyonu gelişmiş olsa da sabitleyiciler yardımcı olur.
• Negatif istemler: kaçınılmasını istediğiniz şeyleri açıkça belirtin (örn. “metin yok”, “filigran yok”, “fazladan uzuv yok”).
• Kısa + uzun hibrit: kısa bir kanonik talimat verin ve ardından birkaç satır ayrıntı ve kısıtla genişletin.

Örnek istem şablonları

Ürün kahraman görseli (fotogerçekçi): "Beyaz bir masa üzerinde konumlandırılmış 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): "Efsanevi bir fantezi manzarası, bir uçurumda yükselen cam şato, altın saat, hacimsel sis, resimsel, son derece detaylı, konsept art"

Görsel düzenleme (nesne kaldırma): "Soldaki kişiyi kaldır ve boşluğu doldurmak için arka planı genişlet, ışığı tutarlı koru, eser yok"

Tipografisi yoğun mockup: "iPhone 14 üzerinde bir mobil uygulama açılış ekranı mockup’ı, 'Hemen Başlat' metni Gotham Bold ile, butonu yeşil yap ve gölgeleri yumuşak tut"

Karakter portresi: "Kahramansı bir kadın savaşçı portresi, sinematik kenar aydınlatması, 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 bölümüne karşılık geldiğini belirtin. Seedream 4.5, birden çok referans arasında ana özneyi belirlemede iyileşmiştir — ancak açık olmak (örn. “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şleme

• N varyant üretin ve nesnel filtreler çalıştırın: yüz benzerlik skoru, renk histogramı karşılaştırması, metin doğruluğunu kontrol etmek için tipografi OCR.
• Eşik altındaki çıktıları manuel rötuşa yönlendirmek için otomatik KG eşikleri uygulayın.
• Piksel düzeyinde kesin metin gerekiyorsa son tipografiyi yerleşim araçlarına bırakın — arka plan ve görseller için modeli, ardından kesin metni postta birleştirin. Bu, pazarlama varlıklarında modelin metin doğruluğuna bağımlılığı azaltır.

---

Görsel düzenleme, inpainting ve çoklu görsel kompozisyonu nasıl yaparsınız?

Görsel 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örsel) veya hedefli düzenlemeler için bir sınır notasyonu sağlayın.
3. Hangi bölgelerin değiştirileceğini ve hangilerinin korunacağını açıklayan bir düzenleme istemi gönderin.

Birçok API hem tek görsel düzenleme hem de çoklu görsel kompozisyon kiplerini destekler; 4.5, özne kimliğini korumak ve çoklu görsel tutarlılığını iyileştirmek için açıkça ayarlanmıştır.

Örnek: Inpainting yükü (JSON sözde kod)

{
  "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 üretimler için aynı seed değerini kullanarak kareler arasında tutarlılığı artırın.
• Görüş noktası tutarlılığı için istemlerde kamera betimleyicilerini tutarlı tutun (örn. “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, sadece saç rengini değiştir”).

Seedream 4.5 kullanırken en iyi uygulamalar nelerdir

Yaygın sorunları nasıl giderirsiniz?

Sonuçlar hedefin uzağındaysa pratik sorun giderme adımları:

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

Yüz ayrıntıları için istem özgüllüğünü artırın (yaş, ifade, aydınlatma), daha yüksek kaliteli referans görseller sağlayın veya yüzü açıkça “koru” talimatı verin ve daha fazlasını orijinalde tutmak 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â kritik önemdedir.

Metin okunaksız veya bozuk

Piksel mükemmel tipografi gerekiyorsa metni ayrı bir kaplama olarak vektör ya da raster biçimde sağlayın; aksi halde daha yüksek çözünürlük ayarlarını ve açık “okunaklı metin üret” tarz talimatlarını kullanın. 4.5, önceki sürümlere kıyasla yoğun metin işleme konusunda iyileşmiştir, ancak tipografik mükemmeliyet yine de postta kompozitlemeyi gerektirebilir.

Toplu işler arasında tutarsız ışık veya kompozisyon

Aydınlatma/kamera belirtilerinin sabit olduğu şablon bir istem kullanın veya tutarlılığı artırmak için tek bir toplu çağrıda ü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ına yönelik belirgin iyileştirmelerle olgun, üretime hazır bir görsel modeldir: daha iyi tutarlılık, gelişmiş metin ve yüz oluşturma, 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 üzerinden [Seedream 4.5](http://Seedream 4.5) API vb.’ne erişebilir; the latest model version her zaman resmi web sitesiyle günceldir. Başlamak için modelin yeteneklerini Playground içinde keşfedin ve ayrıntılı talimatlar için API guide bölümüne başvurun. Erişmeden önce lütfen 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?→ Free trial of Seedream 4.5 !

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