Replicate voor beginners: je eerste AI-afbeelding via de API

Replicate is een platform waarop je open-source AI-modellen draait zonder ze zelf te installeren. Je kiest een model, stuurt een verzoek via de API en krijgt het resultaat terug. Deze mini-gids laat zien hoe je in een paar minuten je eerste afbeelding maakt met FLUX, het beeldmodel dat we eerder uitgebreid leerden prompten.

Wat je nodig hebt

Een Replicate-account, Python en een terminal. Je betaalt per gebruik, dus je hebt ook een betaalmethode nodig. Reken vooraf even door wat je van plan bent: het snelle model uit de quickstart, flux-schnell, kost 3 dollar per duizend uitvoerafbeeldingen, en de zwaardere varianten flux-dev (0,025 dollar) en flux-1.1-pro (0,04 dollar) rekenen per afbeelding (Bron: Replicate Pricing). Voor proberen en prompts uittesten is dat verschil van een factor tien het overwegen waard.

Stap 1: installeer de Python-client

pip install replicate

Stap 2: maak een API-token

Maak op replicate.com/account/api-tokens een token aan en zet het als omgevingsvariabele, zodat het niet in je code belandt:

export REPLICATE_API_TOKEN=r8_jouw_token

Beginner-tip: Plak je token nooit in een script dat je deelt of in Git zet. De client leest REPLICATE_API_TOKEN zelf uit je omgeving, dus je hoeft hem nergens in je code te noemen.

Stap 3: draai het model

import replicate

output = replicate.run(
    "black-forest-labs/flux-schnell",
    input={"prompt": "an iguana on the beach, pointillism"}
)

with open("output.png", "wb") as f:
    f.write(output[0].read())

Dit is het voorbeeld uit de Python-quickstart van Replicate. Het model geeft FileOutput-objecten terug; met .read() haal je de bytes op en schrijf je ze naar een bestand (Bron: Replicate Docs).

Stap 4: test eerst in de browser

Wil je eerst zien wat een model doet? Elke modelpagina heeft een playground in de browser, met een kostenschatting voordat je iets draait. Dat is de goedkoopste manier om prompts uit te proberen voordat je ze in code zet — en het scheelt je de rondgang van foutmeldingen over inputvelden die je nog niet kent.

Gevorderden: Eigen modellen verpak je met het open-source hulpmiddel Cog en draai je op Replicate. Let op dat je bij private modellen ook betaalt voor opstart- en inactieve tijd; alleen bij fast booting fine-tunes reken je uitsluitend de actieve tijd af (Bron: Replicate Pricing).

Wat de Cloudflare-overname betekent

Cloudflare kondigde op 17 november 2025 aan Replicate over te nemen. Volgens Cloudflare blijven bestaande API’s en workflows zonder onderbreking werken en komt de modelcatalogus ook naar Workers AI. Voor een eerste project verandert er dus niets. Bouw je iets groters, houd dan de Replicate-documentatie in de gaten — de aankondiging is nog geen afgeronde integratie.

Dat je hier per afbeelding of per GPU-seconde afrekent, is geen boekhoudkundig detail: hetlaatsteainieuws.nl legde uit hoe AI-inferentie in 2026 van tokens naar watts rekent, en dat is precies de rekening die je hier ziet.

Checklist: ben je klaar?

• Replicate-account met betaalmethode actief
• pip install replicate gelukt in je (virtuele) omgeving
• REPLICATE_API_TOKEN staat in je omgeving, niet in je code
• Je weet welk FLUX-model je aanroept en wat dat per afbeelding kost
• Eerste prompt getest in de browser-playground
• Script draait en schrijft een bestand weg
• Token staat niet in een repo die je pusht

Wil je dit uitbouwen tot iets dat zelf beslist wanneer het een afbeelding maakt, dan is onze gids over je eerste AI-agent bouwen in Python de volgende stap.

Bronnen

• Replicate — Python quickstart — installatie, token en het codevoorbeeld
• Replicate — Pricing — prijs per model en de regels voor private modellen
• Cloudflare Blog — Replicate is joining Cloudflare — de overname en wat er voor bestaande gebruikers verandert