API opisów i hashtagów TikTok: endpointy i limity
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.
| Endpoint | Kredyty |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
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.
| Pakiet | Cena za kredyt |
|---|---|
| 100 kredytów | $0.05 |
| 500 kredytów | $0.04 |
| 1000 kredytów | $0.035 |
| 5000 kredytów | $0.03 |
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
Jak powstała ta strona: napisana z pomocą AI na podstawie ustawień i limitów, na których działa sama Koda, sprawdzonych .
