API för TikTok-bildtexter och hashtaggar: endpoints, gränser
Koda exponerar tre POST-endpoints — /api/v1/caption, /api/v1/hashtags och /api/v1/script — autentiserade med en API-nyckel som du själv skapar och återkallar. En bildtext eller en uppsättning hashtaggar kostar 1 kredit, ett manus kostar 2, och varje svar returnerar credits_used och credits_remaining så att din egen kod kan stanna innan saldot gör det. Krediter köps i paket, från $0.05 styck ner till $0.03, och är skilda från de Koda Coins som studion förbrukar.
Vad de tre endpoints kostar per anrop
Varje anrop prissätts i hela krediter, som dras atomärt när genereringen lyckats — ett misslyckat anrop debiteras inte, eftersom dragningen är villkorad av att saldot fortfarande räcker när den skrivs.
| Endpoint | Krediter |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
Vad kostar en kredit egentligen?
Fyra paketstorlekar, och styckpriset sjunker med storleken: $0.05 per kredit vid 100, $0.03 vid 5000. En bildtext till bästa pris kostar tre cent.
Krediter går inte ut med en faktureringsperiod och de är inte Koda Coins. En coin motsvarar $0.001 i verklig leverantörskostnad inne i studion; en API-kredit är en fast detaljhandelsenhet. De två växlas aldrig mot varandra, och därför räknas de separat i dashboarden.
| Paket | Pris per kredit |
|---|---|
| 100 krediter | $0.05 |
| 500 krediter | $0.04 |
| 1000 krediter | $0.035 |
| 5000 krediter | $0.03 |
Vad ett svar ger dig utöver texten
Varje lyckat svar innehåller credits_used och credits_remaining. Det är den delen som är värd att koppla in: ett batchjobb kan läsa av återstående saldo från det senaste anropet i stället för att polla en separat endpoint, och stoppa sig själv snyggt.
När saldot är för lågt returnerar anropet HTTP 402 med koden insufficient_credits och det aktuella saldot, så att felet går att hantera programmatiskt i stället för genom att tolka en felsträng.
Vad det här inte gör
- Det genererar inte video, bilder eller röst. v1-API:et är bara text — bildtexter, hashtaggar och manus. Videogenerering stannar i studion, där den prissätts i coins per modell och per sekund.
- Det publicerar inte. Inget i v1 postar till TikTok, Instagram eller YouTube; att ansluta ett konto och publicera görs i dashboarden.
- Det är begränsat till 5 anrop per minut per endpoint, vilket är ett tak för toppar, inte en månadskvot. Ett jobb som behöver mer får sprida ut sina anrop.
- Det finns ingen gratisnivå för API:et. Krediter köps före det första anropet.
Vanliga frågor
- Delar API-krediter och Koda Coins saldo?
- Nej. Det är två separata saldon som visas separat i dashboarden. Koda Coins betalar för genereringar i studion och följer den verkliga leverantörskostnaden; API-krediter är en fast detaljhandelsenhet som köps i paket för v1-endpoints.
- Vad händer med ett anrop som misslyckas?
- Det debiteras inte. Dragningen är en villkorad skrivning som bara genomförs när saldot fortfarande räcker, och den körs efter att genereringen svarat — så ett fel hos leverantören eller ett avslag på grund av hastighetsgränsen lämnar saldot orört.
- Kan en API-nyckel återkallas?
- Ja, från sidan Developer. En nyckel visas i sin helhet exakt en gång, när den skapas, och kan återkallas när som helst; användningen loggas per nyckel så att du ser vilken som förbrukade vad.
Testa Koda
Så gjordes den här sidan: skriven med hjälp av AI utifrån de inställningar och gränser som Koda själv körs med, kontrollerade .
