TikTok Caption & Hashtag API: Endpoints and Limits

Try Koda Last checked

Koda exposes three POST endpoints — /api/v1/caption, /api/v1/hashtags and /api/v1/script — authenticated by an API key you create and revoke yourself. A caption or a hashtag set costs 1 credit, a script costs 2, and every response returns credits_used and credits_remaining so your own code can stop before the balance does. Credits are bought in packs, from $0.05 each down to $0.03, and are separate from the Koda Coins the studio spends.

What the three endpoints cost per call

Each call is priced in whole credits, deducted atomically once the generation succeeds — a failed call is not billed, because the deduction is conditional on the balance still being sufficient at write time.

EndpointCredits
POST /api/v1/caption1
POST /api/v1/hashtags1
POST /api/v1/script2
Per call, per key. Rate limit is 5 requests per 60 seconds on each endpoint.

How much does a credit actually cost?

Four pack sizes, and the unit price falls with the size: $0.05 per credit at 100, $0.03 at 5000. A caption at the best rate is three cents.

Credits do not expire with a billing period and they are not Koda Coins. A coin represents $0.001 of real provider cost inside the studio; an API credit is a flat retail unit. The two never convert into each other, which is why they are counted separately in the dashboard.

PackPrice per credit
100 credits$0.05
500 credits$0.04
1000 credits$0.035
5000 credits$0.03
Pack sizes and what one credit works out at.

What a response gives you besides the text

Every successful response carries credits_used and credits_remaining. That is the part worth wiring: a batch job can read the remaining balance off the last call instead of polling a separate endpoint, and stop itself cleanly.

When the balance is too low the call returns HTTP 402 with code insufficient_credits and the current balance, so the failure is programmatic rather than a parse of an error string.

What this does not do

  • It does not generate video, images or voice. The v1 API is text only — captions, hashtags and scripts. Video generation stays in the studio, where it is priced in coins per model and per second.
  • It does not publish. Nothing in v1 posts to TikTok, Instagram or YouTube; connecting an account and publishing are dashboard actions.
  • It is rate limited to 5 requests per minute per endpoint, which is a ceiling on bursts, not a monthly quota. A job that needs more has to pace itself.
  • There is no free tier on the API. Credits are bought before the first call.

Frequently asked

Do API credits and Koda Coins share a balance?
No. They are two separate balances shown separately in the dashboard. Koda Coins pay for studio generations and track real provider cost; API credits are a flat retail unit bought in packs for the v1 endpoints.
What happens to a call that fails?
It is not billed. The deduction is a conditional write that only applies when the balance is still sufficient, and it runs after the generation returns — so a provider error or a rate-limit rejection leaves the balance untouched.
Can an API key be revoked?
Yes, from the Developer page. A key is shown in full exactly once, at creation, and can be revoked at any time; usage is logged per key so you can see which one spent what.

Try Koda

Try Koda

How this page was made: drafted with AI assistance from the settings and limits Koda itself runs on, checked on .