Naar hoofdinhoud springen

Run je een API-wrapper-bedrijf? Waarom de upstream-API-rekening COGS is onder een markup-model — en wat er met je marge gebeurt wanneer de provider de prijzen verhoogt

Gepubliceerd 12 min leestijdMike ThriftMike Thrift
Run je een API-wrapper-bedrijf? Waarom de upstream-API-rekening COGS is onder een markup-model — en wat er met je marge gebeurt wanneer de provider de prijzen verhoogt
Op deze pagina

Je dashboard zegt dat de brutomarge 81 procent is. Je bankrekening is het daar niet mee eens. Ergens tussen de prijspagina die je zes maanden geleden schreef en de providerfactuur die vanochtend binnenkwam, is de rekensom veranderd: een power user ontdekte je product, het upstream-model werd opnieuw geprijsd, of beide gebeurden in dezelfde week. Als je een product verkoopt dat op de API van iemand anders is gebouwd — een AI-functie, een berichtenstroom, dataverrijking, een checkout — dan is je belangrijkste kostenpost een rekening die je niet beheerst, en je boekhouding moet die zo behandelen voordat die rekening jou zo behandelt.

Dit is de gids om een API-wrapper-bedrijf eerlijk te boeken: waarom de upstream-factuur kostprijs van verkochte goederen is, wanneer boekhoudregels zeggen dat je "omzet" alleen je markup is, wat er op de dag van herprijzing daadwerkelijk met je marge gebeurt, en de vier verdedigingen die voorkomen dat één aankondiging van een provider je kwartaal opeet.

Het markup-model in één alinea​

Een API-wrapper koopt een gemeten input in tegen groothandelsprijs en verkoopt een afgewerkt product tegen detailhandelsprijs. De provider rekent je per token, per minuut, per lookup of per bericht; jij rekent je klant een abonnement, een prijs per seat, gebruiks credits, of een eigen meter met markup. Je brutowinst is de spread tussen die twee meters, en je hele bedrijf is de weddenschap dat de spread positief blijft bij het gebruiksniveau van elke klant.

Bureaus en wrappers nestelen zich in een handvol prijsvormen: per-eenheid pass-through met een markup, een vast retainer-bedrag met een gebruikslimiet, een hybride van basisvergoeding plus overages, of uitkomstgebaseerde prijsstelling per geleverd resultaat. Elk daarvan is een markup-model in vermomming, want elk daarvan financiert een variabele upstream-rekening uit een klantprijs die je vooraf hebt vastgesteld. Op het moment dat je vergeet dat de upstream-meter bestaat — flat unlimited-plannen zijn de klassieke manier — heb je je klant een blanco cheque uitgeschreven op je provideraccount.

Waarom de upstream-rekening COGS is, geen overhead​

Waar de providerfactuur in je boeken landt, bepaalt of je brutomarge de waarheid vertelt. De test is eenvoudig: stijgt en daalt deze kostenpost met het bedienen van klanten? Als het onboarden van één klant meer, of één klant die het product twee keer zoveel gebruikt, deze rekening laat groeien, dan is het een directe kost van het leveren van je product. Dat is kostprijs van verkochte goederen.

COGS-gidsen voor softwarebedrijven zeggen dit expliciet: productiehosting, betaalverwerking, support en externe API's waarvan het product afhankelijk is, staan allemaal boven de brutomargelijn. Inferentie- en API-kosten die betalende klanten bedienen, zijn COGS, punt. Je wrapper kan geen enkele eenheid waarde leveren zonder de upstream-call, dus elke token, minuut of lookup die je klanten verbruiken, is een eenheid kostprijs van omzet.

Overhead is wat je betaalt wanneer niemand iets gebruikt. Huur, marketing, de engineers die de functies van volgend kwartaal bouwen, je eigen salaris — dat zijn operationele kosten omdat ze niet meebewegen met gebruik. De toetsvraag voor elke dubbelzinnige kostenpost: als elke klant een maand pauzeerde, zou deze rekening dan naar nul gaan? De gebruiksmeter wel. De vaste platformvergoeding of de commit op gereserveerde capaciteit niet, en daarom splitsen veel winkels de providerfactuur in variabele COGS voor gemeten gebruik en vaste COGS voor commits — beide boven de streep, apart gevolgd zodat de unit economics zuiver blijven.

Misclassificatie liegt twee keer. Parkeer de API-rekening in overhead en je brutomarge leest als klassieke SaaS — 75 tot 85 procent — terwijl operationele kosten stilletjes de kost van elke klantactie absorberen. Dat vleit het cijfer waarop investeerders benchmarken, en AI-native bedrijven leven daar niet: met inferentie in COGS clusteren ze rond 40 tot 60 procent brutomarge. Erger nog, de leugen verbergt je prijsvloer. Een oprichter die het cijfer van 80 procent gelooft, denkt dat er ruimte is voor een volumekorting; een oprichter die de echte 50 procent ziet, weet precies hoe ver de prijs kan zakken voordat elke nieuwe klant geld verliest. De tweede oprichter overleeft de eerste enterprise-deal.

Bruto of netto? De ASC 606-vraag die zich verstopt in je omzetregel​

Hier is de boekhoudkundige vraag die de meeste wrappers nooit stellen: is de upstream-kost überhaupt een last, of zou die je winst-en-verliesrekening helemaal nooit mogen raken? Onder ASC 606 draait het antwoord om één woord — controle. Als je de dienst beheerst voordat die aan je klant wordt overgedragen, ben je de principal: je erkent de volledige klantbetaling als omzet (bruto) en boekt de providerfactuur als COGS. Als je slechts regelt dat iemand anders de dienst levert, ben je de agent: je erkent alleen je vergoeding of markup als omzet (netto), en de pass-through loopt via een balansrekening.

De indicatoren van controle zijn praktisch, niet filosofisch. Stel jij de klantprijs vast, of de provider? Handel jij support af en draag jij de verantwoordelijkheid wanneer de dienst faalt? Draag je voorraadrisico — toegezegde capaciteit die je betaalt of klanten die het nu gebruiken of niet? Een wrapper met eigen prijsstelling, eigen supportwachtrij en toegezegde provideruitgaven lijkt op een principal en rapporteert bruto. Een dunne pass-through die verzoeken doorstuurt tegen de providerprijs met een vaste bemiddelingsvergoeding begint op een agent te lijken, en agents rapporteren netto.

Waarom dit ertoe doet voordat je groot genoeg bent om geaudit te worden. Bruto rapporteren blaast de topline-omzet op en drukt de margepercentages; netto rapporteren toont kleinere omzet tegen een veel hogere marge. Geen van beide is "beter" — maar investeerders, kredietverstrekkers en overnemers die ontdekken dat je de verkeerde hebt gekozen, zullen je cijfers herzien, en een herzien groeiverhaal is hoe deals sterven. Als je product echt dun is — verzoeken erin, antwoorden eruit, geprijsd dicht bij de eigen meter van de provider — vraag je accountant dan of je omzet boekt die je nooit hebt beheerst. Het is veel goedkoper om het beleid in jaar één te corrigeren dan om in jaar drie een herziening uit te leggen.

De dag dat de provider de prijzen verhoogt​

Herprijzing door de provider is geen hypothese; het is het achtergrondritme van de API-economie. Tussen oktober 2025 en oktober 2026 stegen de lijstprijzen per token op 10 van de 14 gevolgde modeltiers, waarbij leveranciers de verhogingen koppelden aan bekwaamheidsclaims — elk nieuw vlaggenschip kost meer per token dan het vorige omdat het meer per token doet. Vlaggenschipprijzen hebben zelfs een U-bocht gemaakt binnen één generatie: na jaren van steile dalingen kost het beste algemene model nu meerdere malen wat zijn voorganger kostte. En verhogingen komen niet altijd als persberichten; soms komen ze als kalenderdata, zoals een grote provider die de API-tarieven van één model verdubbelt op 1 december, weken van tevoren aangekondigd in een changelog die je klanten nooit lezen.

Je klantprijzen daarentegen herprijzen zichzelf nooit. Wat je ook hebt beloofd — $29 per seat, een plan van $49, een credit van $0,10 — is een contract, een prijspagina en een verwachting. De spread die je bij signup modelleerde, is de spread die je financiert tot je die wijzigt, en drie krachten drukken die van beide kanten tegelijk samen.

Het flat-plan ontmoet de power user. Een enkele zware gebruiker op een unlimited-plan kan tien keer de upstream-kost van een gemiddelde genereren — praktijkmensen melden individuele seats die honderden dollars aan inferentie verbranden tegen een abonnement van $29. De vuistregel van één data-SaaS-oprichter: begroot 20.000 calls per gebruiker bij $49 per maand en de marge lijkt op papier 59 procent, tot één klant in het weekend een backfill-script draait en zes maanden marge verbrandt vóór de standup van maandag. Gemiddelden liegen; distributies sturen de rekening.

De aggregator ontmoet piekprijzen. In oktober 2026 verlaagde een aggregator van AI-abonnementen met vaste tarieven de quota van zijn gebruikers op één populair model met maar liefst 75 procent nadat piek-API-prijzen en zwaar tokenverbruik de economie van zijn flat-plannen braken — een abonnee die $60 aan pass-through-credits verbrandt onder een plan van $10 is een maandelijks tekort van $50 dat het platform financiert. Quotaverlagingen zijn hoe herprijzing eruitziet wanneer je niet kunt herprijzen: de meter van de provider blijft lopen, dus het product krimpt in plaats daarvan. Je klanten ervaren het als een product dat slechter wordt voor hetzelfde geld, want dat is het ook.

De stack herprijst in lagen. Je wrapper is zelden afhankelijk van één meter. Spraak, redeneren, opslag, levering en de betaalrail factureren elk apart, en elk herprijst op zijn eigen schema. Een stijging van 20 procent op de input die je het meest gebruikt, kan meer marge wegvagen dan een verdubbeling van de input die je nauwelijks aanraakt. Als je niet kunt zeggen welke upstream-kostenpost je grootste kost per klant is, leer je het van de factuur, en dat is de duurst mogelijke leermeester.

Vier verdedigingen die de spread positief houden​

Je kunt providers er niet van weerhouden te herprijzen. Je kunt wel een bedrijf bouwen waarin herprijzing een routinegebeurtenis is in plaats van een noodgeval. Vier praktijken, in volgorde van hefboomwerking:

1. Volg marge per eenheid, per klant, per model. Geaggregeerde COGS vertelt je dat vorige maand slecht was; tracking per eenheid vertelt je waarom en wiens schuld het is. Log upstream-kost tegen elke klant en elke providermeter — tokens per model, minuten per richting, lookups per endpoint — en review maandelijks de klanten met de slechtste marge. Resellerplatforms leerden dit vroeg: één gemengde markup breekt zodra de catalogus gecachte en niet-gecachte tokens mengt, batch- en realtime-tarieven, of onderhandelde en lijstprijzen. Als je boeken geen kost-per-klant kunnen produceren, is je prijsstelling een gok in een spreadsheetkostuum. Plain-text boeken maken dit goedkoop om te starten: tag elke providerfactuurregel per klantcohort en het margerapport is een query, wat de docs stap voor stap doorloopt.

2. Factureer gebruik door, met een markup — niet eromheen. Pass-through-facturering rekent elke klant je API-kosten in verhouding tot hun werkelijke verbruik, plus je platformvergoeding of percentage erbovenop. De rekening van de klant beweegt mee met de meter van de provider, dus een zware gebruiker financiert zijn eigen zwaarte en een providerstijging stroomt door naar klantfacturen in plaats van naar je marge. Pure flat-rate-prijsstelling op variabele inputs is de structuur die faalt; de oplossing is gemeten overage, creditpakketten die leeglopen, of hybride basis-plus-gebruik-plannen. Let op: de boekhouding volgt hier de economie — hoe meer je prijs de meter van de provider volgt, hoe zorgvuldiger je de principal-versus-agent-vraag hierboven met je accountant moet herzien.

3. Beperk het neerwaartse risico in het contract. Elke vaste of gebundelde prijs heeft een hek nodig: inbegrepen gebruikslimieten, fair-use-clausules met numerieke tanden, overage-tarieven gepubliceerd voordat ze afgaan, en voorwaarden die je toestaan prijzen aan te passen wanneer onderliggende providertarieven veranderen. Een clausule met 30 dagen kennisgeving van prijswijziging is precies daarom standaard in bureauscontracten. Het moment om herprijsrechten te onderhandelen is bij signup, wanneer de klant je product wil — niet bij verlenging, wanneer zij de hefboom hebben en jij een factuur.

4. Routeer om de dure meter heen. Multi-model-routing, caching, batch-endpoints en kleinere modellen voor eenvoudige taken verlagen de upstream-kost per klantactie zonder je prijs aan te raken. Gecachte input-tokens kunnen een tiende kosten van verse; batch-API's geven flinke korting in ruil voor latency die je je vaak kunt permitteren. Behandel inferentie-efficiëntie als een margehefboom met een eigenaar en een maanddoel, zoals een restaurant zijn voedselkosten behandelt. Wanneer de provider de verhoging aankondigt, onderhandelt het team dat routing al heeft gebouwd vanuit kracht; iedereen else onderhandelt vanuit de factuur.

Hoe je het boekt: een maand uit het leven van een wrapper​

Stel je runt een kleine wrapper: $4.900 aan abonnementsomzet in november, een upstream-inferentiefactuur van $2.100 voor oktobergebruik, en betaalverwerking tegen ruwweg 3 procent. De boeken voor de maand zien er zo uit:

2026-01-01 open Assets:Checking:Operating USD
2026-01-01 open Income:Subscriptions:Wrapper USD
2026-01-01 open Expenses:COGS:Upstream-API USD
2026-01-01 open Expenses:Fees:Payment-Processing USD
2026-01-01 open Liabilities:Provider-Payable USD
 
2026-11-01 * "Omzet plannen november" "Klantabonnementen"
  Assets:Checking:Operating  4900.00 USD
  Income:Subscriptions:Wrapper  -4900.00 USD
 
2026-11-05 * "Upstream-inferentiefactuur" "Providerfactuur oktober"
  Expenses:COGS:Upstream-API  2100.00 USD
  Liabilities:Provider-Payable  -2100.00 USD
 
2026-11-05 * "Betaalverwerking" "Verwerkingskosten november"
  Expenses:Fees:Payment-Processing  147.00 USD
  Assets:Checking:Operating  -147.00 USD

Twee dingen om op te merken. Ten eerste landt de providerfactuur op Expenses:COGS:Upstream-API, boven de brutomargelijn — de brutowinst van november is $4.900 minus $2.100, een marge van 57 procent die de waarheid vertelt over een inferentiebedrijf. Ten tweede wordt de factuur geboekt op een crediteurenpost, niet rechtstreeks uit checking: je betaalt de provider op hun voorwaarden (vaak midden in de maand) terwijl klanten je bij signup betaalden, en de crediteurenpost maakt dat timingverschil zichtbaar in plaats van een blik op het banksaldo te laten veinzen dat al het geld van jou is.

Vanaf hier is de maandelijkse routine drie queries: brutomarge met en zonder de providerregel, kost per actieve klant tegen planprijs, en de vijf klanten met de slechtste marge. Volg de trend in een dashboard zoals Fava en een samenknijpende spread verschijnt als een helling weken voordat die zich als een crisis aandient. De oprichter die de helling ziet, verhoogt het overage-tarief, verscherpt het hek of routeert naar het goedkopere model. De oprichter die het allemaal als overhead boekte, ziet marges van 80 procent tot precies het kwartaal waarin het geld op is — en begrijpt nooit wat er is gebeurd.

Bron: https://beancount.io/nl/blog/2026/11/09/api-wrapper-upstream-api-bill-cogs-markup-model-margin-guide

Gepubliceerd: 9 november 2026