API opisów i hashtagów TikTok: endpointy i limity

Wypróbuj Koda Sprawdzono

Koda udostępnia trzy endpointy POST (/api/v1/caption, /api/v1/hashtags i /api/v1/script) uwierzytelniane kluczem API, który sam tworzysz i unieważniasz. Opis albo zestaw hashtagów kosztuje 1 kredyt, scenariusz 2, a każda odpowiedź zwraca credits_used i credits_remaining, żeby twój kod mógł się zatrzymać, zanim skończy się saldo. Kredyty kupuje się w pakietach, od $0.05 za sztukę do $0.03, i są oddzielne od Koda Coins, które wydaje studio.

Ile kosztuje jedno wywołanie każdego z trzech endpointów

Każde wywołanie jest wyceniane w pełnych kredytach, pobieranych atomowo dopiero po udanym generowaniu: nieudane wywołanie nie jest rozliczane, bo pobranie zależy od tego, czy saldo w chwili zapisu nadal wystarcza.

EndpointKredyty
POST /api/v1/caption1
POST /api/v1/hashtags1
POST /api/v1/script2
Za wywołanie, na klucz. Limit zapytań to 5 zapytań na 60 sekund na każdym endpoincie.

Ile naprawdę kosztuje kredyt?

Cztery rozmiary pakietów, a cena jednostkowa spada wraz z rozmiarem: $0.05 za kredyt przy 100, $0.03 przy 5000. Opis w najlepszej stawce kosztuje trzy centy.

Kredyty nie wygasają z okresem rozliczeniowym i nie są Koda Coins. Coin reprezentuje $0.001 realnego kosztu dostawców w studiu; kredyt API to stała jednostka detaliczna. Jedne nigdy nie zamieniają się w drugie, dlatego w panelu są liczone osobno.

PakietCena za kredyt
100 kredytów$0.05
500 kredytów$0.04
1000 kredytów$0.035
5000 kredytów$0.03
Rozmiary pakietów i ile wychodzi jeden kredyt.

Co daje odpowiedź oprócz tekstu

Każda udana odpowiedź zawiera credits_used i credits_remaining. To część, którą warto podpiąć: zadanie wsadowe może odczytać pozostałe saldo z ostatniego wywołania, zamiast odpytywać osobny endpoint, i zatrzymać się czysto.

Gdy saldo jest za niskie, wywołanie zwraca HTTP 402 z kodem insufficient_credits i bieżącym saldem, więc błąd obsługuje się programowo, a nie przez parsowanie komunikatu o błędzie.

Czego ta funkcja nie robi

  • Nie generuje wideo, obrazów ani głosu. API v1 to wyłącznie tekst: opisy, hashtagi i scenariusze. Generowanie wideo zostaje w studiu, gdzie jest wyceniane w coinach za model i za sekundę.
  • Nie publikuje. Nic w v1 nie publikuje na TikToku, Instagramie ani YouTube; łączenie konta i publikacja to działania w panelu.
  • Ma limit 5 zapytań na minutę na endpoint, który jest sufitem dla nagłych serii, a nie miesięcznym limitem. Zadanie, które potrzebuje więcej, musi samo rozłożyć tempo.
  • API nie ma darmowego poziomu. Kredyty kupuje się przed pierwszym wywołaniem.

Najczęstsze pytania

Czy kredyty API i Koda Coins mają wspólne saldo?
Nie. To dwa oddzielne salda, pokazywane osobno w panelu. Koda Coins płacą za generowanie w studiu i odzwierciedlają realny koszt dostawców; kredyty API to stała jednostka detaliczna kupowana w pakietach dla endpointów v1.
Co dzieje się z wywołaniem, które się nie powiedzie?
Nie jest rozliczane. Pobranie to warunkowy zapis, który działa tylko wtedy, gdy saldo nadal wystarcza, i wykonuje się po zwróceniu wyniku generowania, więc błąd dostawcy albo odrzucenie przez limit zapytań zostawiają saldo nietknięte.
Czy klucz API można unieważnić?
Tak, na stronie Deweloper. Klucz jest pokazywany w całości dokładnie raz, przy tworzeniu, i można go unieważnić w każdej chwili; użycie jest rejestrowane dla każdego klucza, więc widzisz, który wydał ile.

Wypróbuj Koda

Wypróbuj Koda

Jak powstała ta strona: napisana z pomocą AI na podstawie ustawień i limitów, na których działa sama Koda, sprawdzonych .