Een beeldstap is geen gewone API-call

In een workflow ziet beeldgeneratie eruit als elke andere stap: verzoek eruit, resultaat erin. In de praktijk gedraagt hij zich anders. Het duurt seconden tot minuten, het kan mislukken zonder foutmelding, en elke poging kost geld.

Dat maakt vier dingen belangrijk die je bij een gewone API niet hoeft te regelen.

1. Wachten zonder de flow te blokkeren

De meeste beeld-API's werken asynchroon: je krijgt een taak-id terug en moet daarna zelf pollen. Bouw je dat als een simpele wachtlus, dan staat je hele workflow stil zodra het model traag is. Splits het: één stap die de opdracht plaatst, en een aparte die later het resultaat ophaalt.

2. Mislukking is normaal, niet uitzonderlijk

Reken erop dat een deel van je verzoeken niets bruikbaars oplevert — geweigerd om inhoudsredenen, een timeout, of gewoon een lelijk beeld. Zonder afhandeling loopt je flow door met een leeg bestand en publiceer je een lege plek.

• Controleer of er echt een bestand terugkwam voordat je verder gaat.
• Beperk het aantal nieuwe pogingen — anders verdubbel je je kosten stilletjes.
• Laat mislukkingen naar een lijst gaan die iemand bekijkt, niet naar een log dat niemand leest.

3. Kosten die je pas achteraf ziet

Een lus die per ongeluk twee keer draait, is bij tekst een paar cent en bij beeld al snel tientallen euro's. Zet een teller in je flow: hoeveel beelden per dag, en een grens waarboven hij stopt en jou een bericht stuurt. Dat is vijf minuten werk en het scheelt je ooit een vervelende rekening.

4. Bestanden die niemand terugvindt

Beeld komt vaak terug als tijdelijke URL die na een dag verloopt. Sla het bestand direct op je eigen opslag op, met een naam waar de bron in zit: onderwerp, datum, welke stap. Anders heb je over drie maanden een map vol bestanden waarvan niemand weet waar ze bij horen.

Veelgestelde vragen