Specyfikacja filmów TikTok przy wgrywaniu przez API (2026)
Sprawdzono · źródła wymienione na dole tej strony
Content Posting API TikToka przyjmuje przy wgrywaniu trzy typy treści wideo: video/mp4, video/quicktime i video/webm. Maksymalna długość nie jest stałą liczbą: endpoint Query Creator Info zwraca ją dla każdego twórcy jako max_video_post_duration_sec i trzeba ją odczytać przed każdym postem.
Jakie formaty wideo przyjmuje API TikToka?
Na endpoincie wgrywania udokumentowane są trzy typy treści: video/mp4, video/quicktime i video/webm. W praktyce MP4 z wideo H.264 i dźwiękiem AAC to bezpieczny wybór domyślny: to połączenie, które TikTok transkoduje najbardziej przewidywalnie.
| Content-Type | Kontener | Uwaga |
|---|---|---|
| video/mp4 | .mp4 | Domyślny. H.264 + AAC to najbardziej przewidywalna para w transkodowaniu TikToka. |
| video/quicktime | .mov | Akceptowany. Zwykle większy przy tej samej jakości, co ma znaczenie przy transferze, a nie dla API. |
| video/webm | .webm | Akceptowany przez API. Rzadko to, co tworzy telefon albo edytor. |
Jaka jest maksymalna długość filmu na TikToku przez API?
Nie ma jednej odpowiedzi i to najczęściej błędnie podawany fakt o API TikToka. Udokumentowany mechanizm to pole, a nie stała: max_video_post_duration_sec, zwracane przez Query Creator Info dla konta, na którym zaraz opublikujesz.
Każda strona, która podaje jedną liczbę dla „maksymalnej długości filmu w API TikToka”, opisuje jedno konto albo zgaduje. Poprawna implementacja pyta dla każdego konta i każdego posta, a gdy plik jest dłuższy, odrzuca wgrywanie po stronie klienta.
Jak działa wgrywanie w częściach?
Gdy przekazujesz TikTokowi bezpośrednio plik, a nie URL, wywołanie init przyjmuje chunk_size i total_chunk_count, a plik jest przesyłany w kawałkach.
Dokumentacja wgrywania TikToka nie podaje liczbowych granic tych dwóch parametrów, więc każdą konkretną liczbę, którą przeczytasz gdzie indziej, traktuj jako niezweryfikowaną. Dokumentacja ustala za to schemat: najpierw deklarujesz podział, potem przesyłasz.
Dlaczego proporcji obrazu nie ma w dokumentacji API?
Bo API ich nie wymusza. 9:16 w 1080 × 1920 to zalecenie dystrybucyjne, a nie ograniczenie przy wgrywaniu: kwadratowy albo poziomy plik wgra się bez problemu, a potem odtworzy się z czarnymi pasami w pionowym kanale pełnoekranowym, co kosztuje czas oglądania zamiast zwrócić błąd.
To więc jedyna specyfikacja na tej stronie, o której żadna odpowiedź API nigdy ci nie powie, i ta, która najbardziej wpływa na wyniki filmu.
Najczęstsze pytania
- Jakie formaty wideo przyjmuje Content Posting API TikToka?
- Udokumentowane są trzy typy treści: video/mp4, video/quicktime i video/webm. MP4 z H.264 i AAC to najbardziej przewidywalny wybór.
- Jaka jest maksymalna długość filmu, który mogę opublikować przez API TikToka?
- Zależy od konta. Endpoint Query Creator Info zwraca max_video_post_duration_sec dla każdego twórcy, a ta wartość jest limitem dla tego konta. Nie ma jednej opublikowanej liczby.
- Czy API TikToka odrzuca film, który nie jest w 9:16?
- Nie. Proporcje nie są ograniczeniem przy wgrywaniu. Film niepionowy wgra się bez problemu, a potem odtworzy się z pasami w pionowym kanale, co zwykle skraca czas oglądania.
- Dlaczego mój film opublikowany przez API widzę tylko ja?
- Bo treści publikowane przez klienta API bez audytu są ograniczone do trybu prywatnego. To ograniczenie znika, gdy klient przejdzie audyt TikToka, a nie po zmianie pola prywatności.
Źródła
- TikTok for Developers — Content Posting API, Upload Video — odczytano .
- TikTok for Developers — Query Creator Info — odczytano .
- TikTok for Developers — Content Posting API, Direct Post — odczytano .
Te dane pochodzą z dokumentacji innej firmy, która może się zmienić bez uprzedzenia i której nic tutaj nie weryfikuje automatycznie. Dlatego przy każdym źródle podajemy datę odczytu. Źródła na tej stronie są czytane ponownie co kwartał.
Jak powstała ta strona: napisana z pomocą AI na podstawie źródeł wymienionych na tej stronie, odczytanych .