Hoe gebruikt u de Seedgream 4.5 API

Seedream 4.5 is de nieuwste evolutie binnen de Seedream-familie van text-to-image-/beeldbewerkingsmodellen (ontwikkeld binnen Byte/BytePlus-onderzoek). Het wordt uitgerold via officiële BytePlus-endpoints en meerdere platforms van derden — inclusief geïntegreerde toegang via multi-model gateways zoals CometAPI — en biedt verbeterde onderwerpconsistentie, typografie-/tekstrendering en hogere getrouwheid bij bewerken met meerdere afbeeldingen.

Dit artikel is een praktische, professionele gids voor het gebruik van de Seedream 4.5-API. Je krijgt concrete stappen voor de setup, authenticatie- en aanvraagpatronen, best practices voor prompts en parameters, workflows voor bewerking en meerdere afbeeldingen, foutafhandeling, implementatiepatronen en juridische/veiligheidsaspecten.

Wat is Seedream 4.5?

Seedream 4.5 is de nieuwste iteratie van de Seedream-familie — een multimodaal model voor beeldgeneratie en -bewerking, ontworpen voor hoogwaardige tekst-naar-beeldcreatie en contextbewuste beeldbewerking (image-to-image, multi-reference editing, inpainting/outpainting, typografie en verwerking van dichte tekst). Vergeleken met eerdere Seedream-releases richt 4.5 zich op verbeterde onderwerpconsistentie in workflows met meerdere afbeeldingen, striktere behoud van referentiedetails, hogere typografische getrouwheid (tekst in afbeeldingen) en betere outputkwaliteit tot 4K/ultra-HD in “high quality”-instellingen. Deze verbeteringen komen voort uit een opgeschaalde architectuur en bijgewerkte prompttuning/engine-side heuristieken.

Waarom dit belangrijk is: 4.5 is bewust gebouwd voor professionele creatieve taken — batch productvariaties, merkvast bewerken over meerdere afbeeldingen en high-res printassets — terwijl het fijnmazige controle mogelijk maakt met referentieafbeeldingen en gespecialiseerde bewerkingen.

Kernmogelijkheden

• Text-to-image-generatie (single en batch): genereer 1–15 afbeeldingen per API-call, met selecteerbare kwaliteitsmodi (Basic vs High) die snelheid en resolutie afwegen.
• Beeldbewerking (i2i / inpainting / outpainting): gebruik één of meerdere referentieafbeeldingen; behoudt details en ruimtelijke relaties over meerdere referenties.
• Multi-reference blending & elementkopie: tot ~10 referentieafbeeldingen in één job om elementen te transplanteren met behoud van coherente belichting/perspectief.
• Hoge typografie-/dichte-tekstrendering: betere verwerking van beelden met tekst of signage (handig voor mock-ups, productlabels, UI-screenshots).
• Streaming/progressieve output: sommige deployment-endpoints ondersteunen streamingresultaten, zodat clients tussentijdse resultaten ontvangen terwijl de generatie doorgaat.

Hoe gebruik ik de Seedream 4.5-API via CometAPI?

Hieronder vind je een praktische, kopieer-en-plakbare walkthrough voor het genereren van afbeeldingen via CometAPI (een aggregator die het Seedream 4.5-model als modelparameter exposeert). Gebruik CometAPI wanneer je met één API-sleutel toegang wilt tot tientallen/honderden modellen en een stabiel, eenvoudig te integreren REST-oppervlak. De CometAPI-documentatie toont de doubao-seedream-4-5-251128-modelalias en een standaard endpoint voor beeldgeneratie.

High-level steps

1. Meld je aan bij CometAPI en verkrijg een API-sleutel.
2. Gebruik het endpoint voor beeldgeneratie (POST https://api.cometapi.com/v1/images/generations) met de modelparameter ingesteld op de Seedream 4.5-identifier (voorbeeld: doubao-seedream-4-5-251128).
3. Voeg prompt, optionele referentieafbeeldingen (URL’s of multipart-uploads afhankelijk van de aggregator), outputgrootte/-kwaliteit en andere parameters toe.
4. Ontvang een JSON-respons met gegenereerde afbeeldings-URL’s (of base64) en metadata.

Aanvraagtypen en -modi

Seedream 4.5 ondersteunt doorgaans:

• Text → Image (tekstprompts → nieuwe afbeeldingen)
• Image → Image (referentieafbeeldingen + prompts voor gestileerde transformaties)
• Image Editing / Inpainting (masker + bewerkinstructies voor gerichte wijzigingen)
  gehoste API’s ondersteunen asynchrone taakmodi (job indienen → pollen met taskId), wat past bij langlopende renders en batchworkflows. Gegenereerde links zijn vaak tijdsgebonden (bijv. 24 uur geldig op sommige gateways), plan dus voor opslag/export.

curl-voorbeeld (text-to-image, enkele prompt)

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"
  }'

Opmerkingen

• Vervang COMETAPI_KEY_GOES_HERE door je CometAPI-sleutel.
• De parameter n genereert meerdere variaties in één call (scheelt overhead).
• quality: "high" correspondeert doorgaans met een hogere resolutie/hogere compute-kosten (vaak 4K-capabel).

Python requests-voorbeeld (text-to-image + resultaten opslaan)

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"))

Waarom dit patroon? Aggregators retourneren vaak ofwel een base64-payload of gehoste URL’s; de code dekt beide. Het endpoint retourneert doorgaans een task_id. Poll het endpoint GET /tasks/{task_id} totdat de status succeeded is en download vervolgens het resultaat. Veel providers bieden SDK’s met ingebouwde helpers voor dit patroon.

Hoe optimaliseer je de beeldkwaliteit en houd je tekst leesbaar?

1. Gebruik referentieafbeeldingen voor consistente context en kleurmatching.
2. Benoem typografie expliciet in de prompt (lettertypefamilie, gewicht, uitlijning) en overweeg om de exacte tekst als overlay in een tweede stap toe te voegen voor leesbaarheid.
3. Voer een tweestapsproces uit: (a) basiscompositie genereren; (b) opnieuw renderen of bewerken in een tweede pass gericht op close-ups of labelgebieden met hogere resolutie.

Hoe schrijf je prompts voor Seedream 4.5?

Principes voor prompt-engineering

• Wees expliciet: noem onderwerp, actie, stijl, lens/camera, tijdstip en gewenste kleurenpalet.
• Gebruik identiteitsankers: als je hetzelfde gezicht/object over meerdere afbeeldingen nodig hebt, voeg consistente beschrijvers toe (bijv. “dezelfde vrouw met kort golvend haar, groene jas, litteken op linkerwenkbrauw”) en lever 1–3 referentieafbeeldingen. Seedream 4.5’s multi-reference-fusie is verbeterd, maar ankers helpen.
• Negatieve prompts: benoem expliciet wat je wilt vermijden (bijv. “geen tekst”, “geen watermerken”, “geen extra ledematen”).
• Hybride van kort + lang: geef een korte canonieke instructie en breid uit met enkele regels details en randvoorwaarden.

Voorbeeldprompt-sjablonen

Product hero shot (fotorealistisch): "Een clean product-hero-shot van een matzwarte draadloze speaker op een witte tafel, softboxverlichting, 50mm, geringe scherptediepte, studiobackground, fotorealistisch, geen tekst"

Fantasy-illustratie (gestileerd): "Episch fantasielandschap, torenend glazen kasteel op een klif, golden hour, volumetrische nevel, schilderachtig, zeer gedetailleerd, concept art"

Beeldbewerking (object verwijderen): "Verwijder de persoon links en breid de achtergrond uit om de ruimte te vullen, houd de belichting consistent, geen artefacten"

Typografie-intensieve mock-up: "Mock-up van een mobiele app-landingspagina op een iPhone 14, met de tekst 'Nu lanceren' in Gotham Bold, maak de knop groen en houd de schaduwen zacht"

Personageportret: "Heroïsch portret van een vrouwelijke krijger, cinematografische rim lighting, 85mm portretlens, ultragedetailleerde huidtextuur, natuurlijke sproeten, leren harnas, neutrale achtergrond, fotorealistisch."

Prompts voor meerdere afbeeldingen en referenties

Bij bewerken met meerdere afbeeldingen, specificeer welke referentieafbeelding bij welk deel van de prompt hoort. Seedream 4.5 is beter in het herkennen van het hoofdonderwerp over meerdere referenties — maar expliciet zijn (bijv. “gebruik image_1 voor het gezicht, image_2 voor de kledingtextuur”) levert betere resultaten op.

Outputselectie en nabewerking

• Genereer N varianten en gebruik objectieve filters: gezichts-similariteitsscore, kleurhistogramvergelijking, typografie-OCR om tekstnauwkeurigheid te controleren.
• Automatiseer QC-drempels om outputs onder de drempel naar handmatige retouche te routeren.
• Besteed definitieve typografie uit aan lay-outtools als je pixel-exacte tekst nodig hebt — gebruik het model voor achtergronden en beeldmateriaal en voeg precieze tekst toe in de post. Zo hoef je minder te vertrouwen op de tekstrendering van het model voor marketingassets.

---

Hoe voer je beeldbewerking, inpainting en compositie met meerdere afbeeldingen uit?

Workflow voor beeldbewerking

1. Upload referentieafbeelding(en) naar de provider of stuur ze inline mee met de aanvraag.
2. Lever een masker (binaire afbeelding) voor inpainting of een begrenzende annotatie voor gerichte edits.
3. Stuur een bewerkingsprompt die verduidelijkt welke regio’s moeten veranderen en welke behouden moeten blijven.

Veel API’s ondersteunen zowel single-image-edit als compositie met meerdere afbeeldingen; 4.5 is expliciet getuned om onderwerpidentiteit te behouden en consistentie over meerdere afbeeldingen te verbeteren.

Voorbeeld: Inpainting-payload (JSON-pseudocode)

{
  "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
}

Tips voor consistente bewerking met meerdere afbeeldingen

• Gebruik dezelfde seed voor gerelateerde renders om consistentie tussen frames te behouden.
• Houd camerabeschrijvingen consistent in prompts (bijv. “85mm portret, softbox, 3/4”) om de gezichtspuntconsistentie te behouden.
• Vraag bij het bewerken van gezichten om fijnmazige behoudclausules (“behoud gelaatsstructuur, verander alleen haarkleur”) om identiteitsdrift te verminderen.

What are the best practices when using Seedream 4.5

Hoe los je veelvoorkomende problemen op?

Hier zijn praktische stappen voor troubleshooting wanneer resultaten afwijken:

Wazige gezichten / onjuiste details

Vergroot de specificiteit van de prompt voor gelaatsdetails (leeftijd, expressie, belichting), lever referentieafbeeldingen van hogere kwaliteit, of probeer een expliciete instructie “preserve face” en verlaag de edit-strength om meer van het origineel te behouden. Seedream 4.5 verbetert de gezichtsrealiteit, maar input blijft bepalend.

Tekst is onleesbaar of vervormd

Lever vector- of rastertekst als aparte overlay als je pixelperfecte typografie nodig hebt; gebruik anders hogere resolutie-instellingen en expliciete stijl-instructies als “render legible text: yes”. 4.5 verbetert de verwerking van dichte tekst ten opzichte van eerdere versies, maar typografische perfectie vereist mogelijk nog compositing in post.

Inconsistente batchbelichting of compositie

Gebruik een getemplate prompt met vaste vermeldingen voor belichting/camera, of genereer binnen één batchcall om de consistentie te vergroten. BytePlus en CometAPI bieden batch-inferencepatronen om die reden.

Laatste opmerkingen en volgende stappen

Seedream 4.5 is een volwassen, productiegericht beeldmodel met expliciete verbeteringen voor echte creatieve workflows: betere consistentie, verbeterde tekst- en gezichtsrendering en multi-reference-ondersteuning. Gebruik CometAPI of vergelijkbare aggregators wanneer je snel wilt experimenteren en multi-modelflexibiliteit nodig hebt.

Developers kunnen toegang krijgen tot de [Seedream 4.5](http://Seedream 4.5)-API enz. via CometAPI, de nieuwste modelversie wordt altijd bijgewerkt met de officiële website. Om te beginnen, verken de mogelijkheden van het model in de Playground en raadpleeg de API-gids voor gedetailleerde instructies. Zorg ervoor dat je bent ingelogd bij CometAPI en een API-sleutel hebt verkregen voordat je toegang aanvraagt. CometAPI biedt een prijs die veel lager is dan de officiële prijs om je te helpen integreren.

Klaar om te starten?→ Gratis proef van Seedream 4.5 !

Wil je meer tips, gidsen en nieuws over AI? Volg ons op VK, X en Discord!