Generate TikTok captions, hashtags and scripts from your own code
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 EUR each down to 0.03 EUR, 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 EUR per credit at 100, 0.03 EUR 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 EUR |
| 500 credits | 0.04 EUR |
| 1000 credits | 0.035 EUR |
| 5000 credits | 0.03 EUR |
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.