TikTokin kuvateksti- ja hashtag-API: endpointit ja rajat

Kokeile Kodaa Tarkistettu viimeksi

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ä.

EndpointKrediitit
POST /api/v1/caption1
POST /api/v1/hashtags1
POST /api/v1/script2
Kutsua ja avainta kohden. Nopeusraja on 5 pyyntöä 60 sekunnissa kussakin endpointissa.

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.

PakettiHinta krediitiltä
100 krediittiä$0.05
500 krediittiä$0.04
1000 krediittiä$0.035
5000 krediittiä$0.03
Pakettikoot ja mitä yksi krediitti tulee maksamaan.

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

Kokeile Kodaa

Miten tämä sivu tehtiin: laadittu tekoälyn avulla niistä asetuksista ja rajoista, joilla Koda itse toimii, tarkistettu .