TikTok-caption- en hashtag-API: endpoints en limieten

Probeer Koda Laatst gecontroleerd op

Koda biedt drie POST-endpoints — /api/v1/caption, /api/v1/hashtags en /api/v1/script — beveiligd met een API-key die je zelf aanmaakt en intrekt. Een caption of een set hashtags kost 1 credit, een script kost 2, en elke respons geeft credits_used en credits_remaining terug, zodat je eigen code kan stoppen voordat het saldo dat doet. Credits koop je in pakketten, van $0.05 per stuk tot $0.03, en ze staan los van de Koda Coins die de studio uitgeeft.

Wat de drie endpoints per aanroep kosten

Elke aanroep wordt in hele credits geprijsd en atomair afgeschreven zodra de generatie is geslaagd — een mislukte aanroep wordt niet gefactureerd, omdat de afschrijving afhangt van de voorwaarde dat het saldo op het moment van schrijven nog toereikend is.

EndpointCredits
POST /api/v1/caption1
POST /api/v1/hashtags1
POST /api/v1/script2
Per aanroep, per key. De rate limit is 5 verzoeken per 60 seconden op elk endpoint.

Wat kost een credit eigenlijk?

Vier pakketgroottes, en de prijs per stuk daalt met de grootte: $0.05 per credit bij 100, $0.03 bij 5000. Een caption kost tegen het beste tarief drie cent.

Credits verlopen niet met een factuurperiode en het zijn geen Koda Coins. Een coin staat voor $0,001 aan echte providerkosten in de studio; een API-credit is een vaste verkoopeenheid. De twee worden nooit in elkaar omgerekend, en daarom worden ze in het dashboard apart geteld.

PakketPrijs per credit
100 credits$0.05
500 credits$0.04
1000 credits$0.035
5000 credits$0.03
Pakketgroottes en wat één credit dan kost.

Wat een respons je geeft naast de tekst

Elke geslaagde respons bevat credits_used en credits_remaining. Dat is het deel dat het aansluiten waard is: een batchjob kan het resterende saldo uit de laatste aanroep lezen in plaats van een apart endpoint te pollen, en zichzelf netjes stoppen.

Als het saldo te laag is, geeft de aanroep HTTP 402 terug met de code insufficient_credits en het huidige saldo, zodat de fout programmatisch af te handelen is in plaats van dat je een foutmelding moet parsen.

Wat deze functie niet doet

  • Het genereert geen video, beelden of stemmen. De v1-API is alleen tekst — captions, hashtags en scripts. Videogeneratie blijft in de studio, waar ze in coins per model en per seconde wordt geprijsd.
  • Het publiceert niet. Niets in v1 post op TikTok, Instagram of YouTube; een account koppelen en publiceren zijn acties in het dashboard.
  • De rate limit is 5 verzoeken per minuut per endpoint — een plafond voor pieken, geen maandquotum. Een job die meer nodig heeft, moet zijn eigen tempo doseren.
  • Er is geen gratis abonnement voor de API. Credits koop je vóór de eerste aanroep.

Veelgestelde vragen

Delen API-credits en Koda Coins een saldo?
Nee. Het zijn twee aparte saldi, apart getoond in het dashboard. Koda Coins betalen voor generaties in de studio en volgen echte providerkosten; API-credits zijn een vaste verkoopeenheid, in pakketten gekocht voor de v1-endpoints.
Wat gebeurt er met een aanroep die mislukt?
Die wordt niet gefactureerd. De afschrijving is een voorwaardelijke schrijfactie die alleen doorgaat als het saldo nog toereikend is, en ze draait pas nadat de generatie terugkomt — een providerfout of een weigering door de rate limit laat het saldo dus ongemoeid.
Kan een API-key worden ingetrokken?
Ja, op de Developer-pagina. Een key wordt precies één keer volledig getoond, bij het aanmaken, en kan op elk moment worden ingetrokken; het gebruik wordt per key gelogd, zodat je ziet welke key wat heeft uitgegeven.

Probeer Koda

Probeer Koda

Hoe deze pagina is gemaakt: geschreven met hulp van AI op basis van de instellingen en limieten waarmee Koda zelf draait, gecontroleerd op .