TikTokin kuvateksti- ja hashtag-API: endpointit ja rajat
Koda tarjoaa kolme POST-endpointia — /api/v1/caption, /api/v1/hashtags ja /api/v1/script — jotka todennetaan API-avaimella, jonka itse luot ja perut. Kuvateksti tai hashtag-sarja maksaa 1 krediitin, käsikirjoitus 2, ja jokainen vastaus palauttaa kentät credits_used ja credits_remaining, jotta oma koodisi voi pysähtyä ennen saldoa. Krediitit ostetaan paketeissa, alkaen $0.05 kappaleelta ja halvimmillaan $0.03, ja ne ovat erillään Koda Coineista, joita studio kuluttaa.
Mitä kolme endpointia maksavat kutsua kohden
Jokainen kutsu hinnoitellaan kokonaisina krediitteinä, jotka veloitetaan atomisesti, kun luonti onnistuu — epäonnistunutta kutsua ei laskuteta, koska veloitus edellyttää, että saldo riittää yhä kirjoitushetkellä.
| Endpoint | Krediitit |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
Paljonko krediitti oikeasti maksaa?
Neljä pakettikokoa, ja yksikköhinta laskee koon kasvaessa: $0.05 krediitiltä 100:n paketissa, $0.03 5000:n paketissa. Kuvateksti parhaalla hinnalla maksaa kolme senttiä.
Krediitit eivät vanhene laskutuskauden mukana, eivätkä ne ole Koda Coineja. Yksi coin vastaa $0.001 todellisia palveluntarjoajakuluja studion sisällä; API-krediitti on kiinteä vähittäisyksikkö. Niitä ei koskaan muunneta toisikseen, ja siksi ne lasketaan kojelaudassa erikseen.
| Paketti | Hinta krediitiltä |
|---|---|
| 100 krediittiä | $0.05 |
| 500 krediittiä | $0.04 |
| 1000 krediittiä | $0.035 |
| 5000 krediittiä | $0.03 |
Mitä vastaus antaa tekstin lisäksi
Jokainen onnistunut vastaus sisältää kentät credits_used ja credits_remaining. Se osa kannattaa kytkeä: eräajo voi lukea jäljellä olevan saldon viimeisestä kutsusta erillisen endpointin kyselemisen sijaan ja pysäyttää itsensä siististi.
Kun saldo on liian pieni, kutsu palauttaa HTTP 402 -vastauksen koodilla insufficient_credits ja nykyisen saldon, joten virheen voi käsitellä ohjelmallisesti eikä virhemerkkijonoa jäsentämällä.
Mitä tämä ei tee
- Se ei luo videota, kuvia eikä ääntä. v1-API on pelkkää tekstiä — kuvatekstejä, hashtageja ja käsikirjoituksia. Videoiden luonti pysyy studiossa, jossa se hinnoitellaan coineina mallia ja sekuntia kohden.
- Se ei julkaise. Mikään v1:ssä ei julkaise TikTokiin, Instagramiin tai YouTubeen; tilin yhdistäminen ja julkaiseminen tehdään kojelaudassa.
- Sen nopeusraja on 5 pyyntöä minuutissa endpointia kohden, mikä on purskeiden katto, ei kuukausikiintiö. Enemmän tarvitsevan ajon on tahditettava itseään.
- API:lla ei ole ilmaistasoa. Krediitit ostetaan ennen ensimmäistä kutsua.
Usein kysyttyä
- Jakavatko API-krediitit ja Koda Coinit saldon?
- Eivät. Ne ovat kaksi erillistä saldoa, jotka näytetään kojelaudassa erikseen. Koda Coineilla maksetaan studion luonnit, ja ne seuraavat todellisia palveluntarjoajakuluja; API-krediitit ovat kiinteä vähittäisyksikkö, jota ostetaan paketeissa v1-endpointeja varten.
- Mitä epäonnistuneelle kutsulle tapahtuu?
- Sitä ei laskuteta. Veloitus on ehdollinen kirjoitus, joka toteutuu vain, kun saldo yhä riittää, ja se ajetaan luonnin palattua — joten palveluntarjoajan virhe tai nopeusrajan aiheuttama hylkäys jättää saldon koskemattomaksi.
- Voiko API-avaimen perua?
- Kyllä, Developer-sivulta. Avain näytetään kokonaan tasan kerran, luotaessa, ja sen voi perua milloin tahansa; käyttö kirjataan avainkohtaisesti, joten näet, mikä avain kulutti mitäkin.
Kokeile Kodaa
Miten tämä sivu tehtiin: laadittu tekoälyn avulla niistä asetuksista ja rajoista, joilla Koda itse toimii, tarkistettu .
