TikTok Caption & Hashtag API: Endpoints and Limits
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.
| Endpoint | Credits |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
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.
| Pack | Price per credit |
|---|---|
| 100 credits | $0.05 |
| 500 credits | $0.04 |
| 1000 credits | $0.035 |
| 5000 credits | $0.03 |
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
How this page was made: drafted with AI assistance from the settings and limits Koda itself runs on, checked on .
