TikTok-API til billedtekster og hashtags: grænser
Koda stiller tre POST-endpoints til rådighed — /api/v1/caption, /api/v1/hashtags og /api/v1/script — godkendt med en API-nøgle, du selv opretter og tilbagekalder. En billedtekst eller et sæt hashtags koster 1 credit, et manus koster 2, og hvert svar returnerer credits_used og credits_remaining, så din egen kode kan stoppe, før saldoen gør. Credits købes i pakker, fra $0.05 stykket ned til $0.03, og er adskilt fra de Koda Coins, studiet bruger.
Hvad de tre endpoints koster pr. kald
Hvert kald prissættes i hele credits, der trækkes atomisk, når genereringen lykkes — et kald, der fejler, afregnes ikke, fordi fradraget er betinget af, at saldoen stadig er stor nok i det øjeblik, der skrives.
| Endpoint | Credits |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
Hvad koster en credit egentlig?
Fire pakkestørrelser, og stykprisen falder med størrelsen: $0.05 pr. credit ved 100, $0.03 ved 5000. En billedtekst til den bedste pris koster tre cent.
Credits udløber ikke med en afregningsperiode, og de er ikke Koda Coins. En coin svarer til 0,001 $ i reelle udbyderomkostninger i studiet; en API-credit er en fast detailenhed. De to kan aldrig veksles til hinanden, og derfor tælles de hver for sig i dashboardet.
| Pakke | Pris pr. credit |
|---|---|
| 100 credits | $0.05 |
| 500 credits | $0.04 |
| 1000 credits | $0.035 |
| 5000 credits | $0.03 |
Hvad et svar giver dig ud over teksten
Hvert vellykket svar indeholder credits_used og credits_remaining. Det er den del, der er værd at koble på: et batchjob kan læse den resterende saldo fra det seneste kald i stedet for at polle et separat endpoint og stoppe sig selv pænt.
Når saldoen er for lav, returnerer kaldet HTTP 402 med koden insufficient_credits og den aktuelle saldo, så fejlen kan håndteres i koden i stedet for ved at parse en fejltekst.
Hvad den ikke gør
- Den genererer ikke video, billeder eller stemme. API’et i v1 er kun tekst — billedtekster, hashtags og manus. Videogenerering bliver i studiet, hvor den prissættes i coins pr. model og pr. sekund.
- Den udgiver ikke. Intet i v1 udgiver på TikTok, Instagram eller YouTube; at tilknytte en konto og udgive er handlinger i dashboardet.
- Den har en rate limit på 5 forespørgsler i minuttet pr. endpoint, hvilket er et loft over spidsbelastninger, ikke en månedlig kvote. Et job, der skal bruge mere, må selv sætte tempoet ned.
- Der er ikke noget gratis niveau på API’et. Credits købes før det første kald.
Ofte stillede spørgsmål
- Deler API-credits og Koda Coins saldo?
- Nej. Det er to separate saldi, vist hver for sig i dashboardet. Koda Coins betaler for genereringer i studiet og følger de reelle udbyderomkostninger; API-credits er en fast detailenhed, købt i pakker til v1-endpointsene.
- Hvad sker der med et kald, der fejler?
- Det afregnes ikke. Fradraget er en betinget skrivning, der kun gennemføres, når saldoen stadig er stor nok, og den kører, efter genereringen har svaret — så en fejl hos udbyderen eller en afvisning på grund af rate limit lader saldoen være urørt.
- Kan en API-nøgle tilbagekaldes?
- Ja, fra siden Developer. En nøgle vises i fuld længde præcis én gang, når den oprettes, og kan tilbagekaldes når som helst; forbruget logges pr. nøgle, så du kan se, hvilken der brugte hvad.
Prøv Koda
Sådan blev siden lavet: skrevet med hjælp fra AI ud fra de indstillinger og grænser, Koda selv kører med, tjekket .
