TL;DR, szybka odpowiedź
8 min czytaniaPOST /v2/post/publish/creator_info/query/ zwraca konto, na którym trafi post, poziomy prywatności, z których to konto naprawdę może korzystać, trzy flagi interakcji oraz max_video_post_duration_sec, które TikTok definiuje jako "The longest video duration in seconds that the TikTok creator can post. Different users have different maximum video-duration privileges." Media Transfer Guide TikToka podaje, że wszyscy twórcy mają 3 minuty, a niektórzy 5 lub 10, ale przykładowa odpowiedź Query Creator Info zwraca 300. Pole jest typu int32, bez udokumentowanego enuma i bez udokumentowanego minimum, centrum pomocy TikToka nie podaje żadnej liczby, a endpoint wymaga zakresu video.publish, więc klient z samym video.upload nie odczyta limitu, którego ma przestrzegać.
Co zwraca pole creator_info max_video_post_duration_sec na TikToku?
Pole creator_info max_video_post_duration_sec na TikToku zwraca najdłuższy film, podany w sekundach, jaki może opublikować ten konkretny twórca. Sformułowanie TikToka nie zostawia miejsca na globalną stałą:
"The longest video duration in seconds that the TikTok creator can post. Different users have different maximum video-duration privileges. Developers should use this field to stop video posts that are too long. IGNORE if your client only sends photo media through this API."
Wartość pochodzi z jednego endpointu, który w ogóle nie przyjmuje treści żądania:
| URL HTTP | /v2/post/publish/creator_info/query/ |
| Metoda HTTP | POST |
| Zakres | video.publish |
| Limit żądań | "Each user access_token is limited to 20 requests per minute." |
Token dostępu identyfikuje twórcę, więc to wywołanie jest odczytem danych konta, a nie wyszukiwaniem. TikTok opisuje cel endpointu jednym tchem z ekranem, który ma on zasilać: "When rendering the Export to TikTok page, your app must invoke the API and use the latest creator information returned to display the account's available privacy level options and video/photo interaction settings."
Co jeszcze zwraca endpoint creator info?
Osiem pól, a każde z nich ma zmieniać to, co pokazuje twój ekran publikacji:
| Pole | Typ | Opis TikToka |
|---|---|---|
creator_avatar_url | string | "The URL of the TikTok creator's avatar with a TTL of 2 hours." |
creator_username | string | "The unique ID of the TikTok creator." |
creator_nickname | string | "The nickname of the TikTok creator." |
privacy_level_options | list<string> | Poziomy prywatności, spośród których to konto może wybierać |
comment_disabled | boolean | "Returns true if the creator sets the comment interaction to "No one" in their privacy setting." |
duet_disabled | boolean | "Returns true if the creator account is private or they set the Duet interaction to "No one" in their privacy setting." |
stitch_disabled | boolean | "Returns true if the creator account is private or they set the Stitch interaction to "No one" in their privacy setting." |
max_video_post_duration_sec | int32 | Najdłuższy film, jaki może opublikować ten twórca |
Dwugodzinny TTL awatara łatwo przeoczyć, a powoduje on niedziałające obrazy na każdym ekranie, który zapisuje URL na czas całej sesji. Dwie flagi disabled łączą dwie różne przyczyny w jedną wartość logiczną: zarówno konto prywatne, jak i jawne ustawienie "No one" zwracają true, a odpowiedź nie pozwala ich rozróżnić.
Dlaczego maksymalna długość filmu zależy od twórcy?
Ponieważ TikTok przyznaje uprawnienia do długości filmów poszczególnym kontom, a nie całej platformie. Media Transfer Guide to jedyna strona, która podaje konkretne liczby:
"All TikTok creators can post 3-minute videos, while some have access to post 5-minute or 10-minute videos. The longest video a developer can send via the initialize Upload Video endpoint is 10 minutes. TikTok users may trim developer-sent videos inside the TikTok app to fit their accounts' actual maximum publish durations."
Daje to udokumentowane minimum 180 sekund i udokumentowany pułap 600. Tymczasem przykładowa odpowiedź TikToka nie zwraca żadnej z tych wartości:
"max_video_post_duration_sec": 300Trzysta sekund to środkowy poziom, czyli pięć minut. Przykład zgadza się z poziomami, ale nic w dokumentacji nie mówi, że pole może przyjmować wyłącznie 180, 300 i 600. Jest typu int32, bez enuma, więc klient rozgałęziający logikę na trzech zakodowanych na stałe wartościach opiera się na nieudokumentowanym założeniu. Porównuj odpowiedź z filmem, który masz, a nigdy ze stałą.
Centrum pomocy TikToka dla użytkowników też nie wypełnia tej luki. Artykuł "Making a post" zachęca twórców słowami "Select a maximum length for your video", ale nie podaje na stronie żadnej liczby, dlatego informacje z aplikacji o tym, jak długi może być film na TikToku, i informacje z API stale się rozjeżdżają. W integracji jedyną naprawdę wiarygodną liczbą jest pole z API, i to wyłącznie dla konta, którego tokenu użyto.

Jakie opcje poziomu prywatności są zwracane razem z tym polem?
privacy_level_options zwraca inną listę w zależności od tego, czy konto jest publiczne, czy prywatne, a TikTok podaje obie:
| Stan konta | Zwracane opcje |
|---|---|
| Publiczne | PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, SELF_ONLY |
| Prywatne | FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS, SELF_ONLY |
Wspólne dla obu list są tylko MUTUAL_FOLLOW_FRIENDS i SELF_ONLY. PUBLIC_TO_EVERYONE nigdy nie pojawia się dla konta prywatnego, a FOLLOWER_OF_CREATOR nigdy dla publicznego. Dokumentacja Direct Post wymienia wszystkie cztery wartości w enumie privacy_level bez tego podziału, więc integracje, które czytają enum zamiast odpowiedzi, kończą z wysyłaniem wartości niedostępnej dla konta.
Konsekwencja jest konkretna. Na etapie inicjalizacji wraca privacy_level_option_mismatch, a TikTok dołącza do tego ostrzeżenie: "All clients are required to correctly display the creator account's privacy level options and honor the users' choice. Occurances of this error for product-use applications suggest violations to TikTok's product-use guidance."
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Zasady UX są równie szczegółowe. TikTok wymaga, aby "Users must manually select the privacy status from a dropdown and there should be no default value", aby wyłączone interakcje były wyszarzone i aby żaden z przełączników komentarzy, Duet ani Stitch nie był domyślnie zaznaczony. W kwestii długości te same wytyczne mówią: "API clients must check if the duration of the to-be-posted video follows the max_video_post_duration_sec returned in the creator_info API." Samo odczytanie wartości nie oznacza zgodności. Liczy się zablokowanie posta.
Klienci bez audytu mają jeszcze krótszą listę. TikTok ogranicza ich do widoczności SELF_ONLY oraz do "up to 5 users to post in a 24 hour window", przy czym każde z tych kont musi być w chwili publikacji prywatne.
Czego TikTok nie rozstrzyga
Te luki lepiej mieć na liście kontrolnej, niż odkrywać je na produkcji.
Zakres nie pasuje do przepływu. Query Creator Info wymaga zakresu video.publish. Endpoint Upload pod adresem /v2/post/publish/inbox/video/init/ wymaga video.upload. Klient, który tylko wrzuca szkice do skrzynki twórcy, ma więc token niepozwalający wywołać endpointu, którego wartości TikTok każe mu przestrzegać. TikTok nigdzie nie odnosi się do tej sprzeczności. Najbliższe rozwiązania jest zdanie o przycinaniu z Media Transfer Guide, bo zbyt długi film wysłany do skrzynki trafia do twórcy do przycięcia, zamiast zostać od razu odrzucony.
Odmowa może przyjść jako HTTP 200. Tabela błędów creator info wymienia spam_risk_too_many_posts, spam_risk_user_banned_from_posting i reached_active_user_cap pod statusem HTTP "200 (intentional)". Klient, który patrzy tylko na kody statusu, uzna to za sukces i pokaże ekran publikacji, z którego nie da się nic opublikować. Zalecenie TikToka jest jasne: "When the creator_info API returns that the creator can not make more posts at this moment, API Clients must stop the current publishing attempt and prompt users to try again later."
Limit publikacji jest opisany, ale nie podany. TikTok pisze: "There is a limit on the number of posts that can be made to a creator account in a 24-hour window via Direct Post API. The upper limit may vary among creators (typically around 15 posts per day/ creator account) and is shared across all API Clients using Direct Post." Żadne pole nie zwraca tej liczby, a "typically around" to cała precyzja, jaką oferuje TikTok. To słabsza deklaracja niż konkretna wartość stojąca za limitem publikacji treści na Instagramie.
Nie ma udokumentowanego minimum. Dokumentacja API podaje maksymalną długość dla twórcy i nic na temat dolnej granicy. Zbyt krótki film wychodzi na jaw dopiero po fakcie, jako powód niepowodzenia duration_check_failed z /v2/post/publish/status/fetch/, opisany słowami "Video does not meet our duration restrictions."
Traktuj wywołanie creator info jako część każdej publikacji, a nie wdrożenia. Opcje prywatności, flagi interakcji i limit długości zmieniają się, gdy twórca zmieni ustawienie, dlatego każde narzędzie, które planuje posty na TikToku, musi odpytywać API w chwili publikacji, zamiast używać danych zapisanych w zeszłym tygodniu. Dołączany opis podlega osobnej regule, czyli pułapowi 2 200 runów UTF-16 omówionemu w tekście o limicie znaków w opisie na TikToku.
Najczęściej zadawane pytania

Czy max_video_post_duration_sec może zwrócić coś innego niż 180, 300 lub 600?
TikTok nie obiecuje tych trzech wartości. Pole jest typu int32, dokumentacja nie podaje enuma, a uprawnienia 3, 5 i 10 minut wymienia tylko Media Transfer Guide. Porównuj film ze zwróconą liczbą, a nie z zakodowanym na stałe zestawem.
Co się stanie, jeśli opublikuję film dłuższy niż zwrócony limit?
W Direct Post zadanie zakończy się niepowodzeniem z powodem duration_check_failed. W przypadku endpointu Upload TikTok podaje, że "TikTok users may trim developer-sent videos inside the TikTok app to fit their accounts' actual maximum publish durations", więc twórca rozwiązuje problem podczas edycji.
Czy integracja obsługująca tylko zdjęcia może zignorować to pole?
Tak, i TikTok mówi o tym wprost. max_video_post_duration_sec, duet_disabled i stitch_disabled mają adnotację "IGNORE if your client only sends photo media through this API."
Jak często mogę wywoływać endpoint creator info?
Dwadzieścia razy na minutę na token dostępu użytkownika. To najwyższy opublikowany limit wśród endpointów publikacji, które pozwalają na 6 żądań na minutę przy inicjalizacji i 30 przy sprawdzaniu statusu.
Dlaczego duet_disabled ma wartość true, choć twórca nie wyłączył Duet?
Bo konto prywatne ustawia tę samą flagę. TikTok zwraca true, jeśli "the creator account is private or they set the Duet interaction to "No one" in their privacy setting", a odpowiedź nie pozwala odróżnić tych dwóch przyczyn.
Czy endpoint informuje, czy konto jest publiczne, czy prywatne?
Nie w osobnym polu, ale zdradza to privacy_level_options. Lista z PUBLIC_TO_EVERYONE należy do konta publicznego, a lista z FOLLOWER_OF_CREATOR do prywatnego, ponieważ te dwie wartości nigdy nie występują razem.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Czy muszę odpytywać creator info przed każdym postem, czy tylko raz przy wdrożeniu?
Przy każdej publikacji, nie przy wdrożeniu. Opcje prywatności, flagi interakcji i limit długości zmieniają się, gdy twórca zmieni ustawienie, więc wartość pobrana w zeszłym tygodniu może być już nieaktualna. Narzędzia planujące posty na TikToku z wyprzedzeniem muszą odpytywać API w chwili publikacji, zamiast używać zapisanej odpowiedzi.
Co się stanie, jeśli moja aplikacja pozwoli wybrać poziom prywatności spoza privacy_level_options?
TikTok zwróci błąd privacy_level_option_mismatch na etapie inicjalizacji. W aplikacjach do użytku produkcyjnego powtarzanie się tego błędu TikTok traktuje jako znak naruszania wytycznych, ponieważ klienci muszą wyświetlać wyłącznie opcje prywatności faktycznie dostępne dla konta.
Jakie dodatkowe limity dotyczą aplikacji TikToka, która nie przeszła jeszcze audytu?
TikTok ogranicza klientów bez audytu do poziomu prywatności SELF_ONLY i do publikowania dla maksymalnie 5 użytkowników w ciągu 24 godzin. Każde z tych kont musi być w chwili publikacji prywatne.
Czy TikTok podaje dokładny dzienny limit publikacji na konto twórcy?
TikTok nigdy nie podaje dokładnej liczby. Opisuje limit wspólny dla wszystkich klientów API, który wynosi "typically around 15 posts per day/creator account" i może się różnić w zależności od twórcy, a żadne pole w odpowiedziach nie zwraca tej wartości.
Wykorzystaj to w praktyce z AdaptlyPost
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Więcej naszych treści w Google
Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.
Jeszcze chwila...
AdaptlyPost
Planowanie treści na wszystkich platformach
Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Powiązane hasła ze słownika


Jak w TikTok API muszą się zgadzać chunk_size i total_chunk_count
chunk_size w TikTok API ma dolną granicę 5 MB, górną 64 MB, końcowy fragment do 128 MB oraz total_chunk_count, który trzeba zaokrąglać w dół, a nie w górę.


Jak działa dzienny limit postów na TikToku dla aplikacji i narzędzi do planowania
Dzienny limit postów na TikToku: dokumentacja API podaje 15 postów Direct Post na twórcę, 5 oczekujących szkiców i limit wspólny dla wszystkich aplikacji.


Dlaczego deweloperzy potrzebują zatwierdzenia aplikacji, by publikować na TikToku publicznie
Bez zatwierdzenia aplikacji posty z API zostają SELF_ONLY, a publikować może dziennie tylko 5 prywatnych kont. Co sprawdza audyt i jakie błędy zobaczysz.
Powiązane artykuły


Dlaczego weryfikacja domeny pull_from_url w TikTok API odrzuca twój host
Weryfikacja domeny pull_from_url w TikTok API to kontrola DNS hosta, który podajesz. Bez niej każde wywołanie init zwraca url_ownership_unverified.


Oznaczenie treści AI na TikToku to w rzeczywistości dwa różne oznaczenia
Oznaczenie AI na TikToku pojawia się na dwa sposoby: jako etykieta twórcy ustawiana przez is_aigc i jako etykieta automatyczna z efektów AI lub C2PA, której nie usuniesz.


Trzy odpowiedzi na pytanie, jak długie mogą być Reels na Facebooku
Jak długie mogą być Reels na Facebooku? W aplikacji dowolnie długie od 2025, przez API od 3 do 90 sekund, a w grupach 30 sekund, według stron samej Meta.

