Słownik

Dlaczego limit znaków w opisie na TikToku liczy się w runach UTF-16

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •9 min czytania
Dlaczego limit znaków w opisie na TikToku liczy się w runach UTF-16Dlaczego limit znaków w opisie na TikToku liczy się w runach UTF-16

TL;DR, szybka odpowiedź

9 min czytania

Content Posting API TikToka ogranicza opis filmu do 2200 runów UTF-16, tytuł posta ze zdjęciem do 90, a opis posta ze zdjęciem do 4000. TikTok nigdzie nie definiuje, czym jest run UTF-16, a dwie możliwe interpretacje różnią się przy każdym emoji. Tytuł zdjęcia, który czytelnik widzi jako 79 znaków, ma 86 jednostek według jednej interpretacji i 96 według drugiej, więc ten sam ciąg przechodzi lub nie, zależnie od tego, którą z nich wdrożył TikTok.

Jaki jest limit znaków w opisie na TikToku?

Udokumentowany limit znaków w opisie na TikToku to 2200 runów UTF-16 dla opisu filmu i 90 runów UTF-16 dla tytułu posta ze zdjęciem, a do tego osobne pole opisu o długości 4000 runów, dostępne tylko w postach ze zdjęciami. Wszystkie trzy liczby pochodzą z dokumentacji Content Posting API TikToka i wszystkie są podane w runach, a nie w znakach. Dalsza część dotyczy API, bo tylko tam TikTok publikuje jakąkolwiek liczbę.

Słowo „caption" nie jest w API nazwą żadnego pola. W filmie opis trafia do title. W poście ze zdjęciem title to krótki nagłówek, a tekst opisu należy do description. Ta sama aplikacja, ten sam twórca, ta sama czynność pisania opisu, a dwa pola, których limity różnią się dwudziestoczterokrotnie.

Typ postaEndpointPole opisuUdokumentowane maksimumDrugie pole tekstowe
Film, publikacja bezpośrednia/v2/post/publish/video/init/title2200 runów UTF-16brak
Zdjęcie, publikacja bezpośrednia/v2/post/publish/content/init/title90 runów UTF-16description, 4000 runów UTF-16
Film, do szkiców/v2/post/publish/inbox/video/init/braknie dotyczybrak

Trzeci wiersz bywa zaskoczeniem. Endpoint przesyłania, który umieszcza film w skrzynce twórcy na TikToku, w ogóle nie przyjmuje tekstu. Treść jego żądania zawiera source, video_size, chunk_size, total_chunk_count i video_url, i nic więcej, choć pola dotyczące fragmentów nadal muszą się zgadzać. TikTok mówi integratorom: "You should inform users that they must click on inbox notifications to continue the editing flow in TikTok and complete the post." Jeśli twoje narzędzie do planowania publikuje przez ten endpoint, opis nigdy nie opuści twojej bazy danych. Szkice zdjęć działają inaczej, bo endpoint zdjęć w trybie MEDIA_UPLOAD nadal przyjmuje title i description.

Czym jest run UTF-16?

TikTok tego nie mówi. Wyrażenie "UTF-16 runes" pojawia się w opisach pól bez definicji, linku i przykładu, a łączy dwie jednostki z dwóch różnych tradycji. Run to w języku Go nazwa punktu kodowego Unicode. UTF-16 to kodowanie, którego jednostką miary jest jednostka kodu, a znaki spoza podstawowej płaszczyzny zajmują dwie takie jednostki. „Run UTF-16" może więc oznaczać „punkt kodowy" albo „jednostkę kodu UTF-16", a to różne liczby.

Dla zwykłego tekstu angielskiego obie liczby są takie same. Rozchodzą się przy wszystkim powyżej U+FFFF, a właśnie tam znajdują się wszystkie emoji obrazkowe.

TekstCo liczy czytelnikPunkty kodoweJednostki kodu UTF-16
Hello555
café ze znakiem złożonym U+00E9444
café z e oraz U+0301455
こんにちは555
😀112
👩‍👩‍👧‍👦1711

Alfabety inne niż łaciński nie są problemem, za jaki się je uważa. Japońskie znaki kana należą do podstawowej płaszczyzny wielojęzycznej (Basic Multilingual Plane), więc pięć kana kosztuje pięć według obu interpretacji. Podwójnie kosztuje wszystko zakodowane powyżej U+FFFF: emoji, pisma historyczne, niektóre bloki rozszerzeń CJK i matematyczne znaki alfanumeryczne.

Moim zdaniem ta niejednoznaczność wskazuje na jednostki kodu, bo tę liczbę serwer dostaje za darmo: String.prototype.length w JavaScripcie i String.length() w Javie zwracają właśnie jednostki kodu. To przypuszczenie dotyczące implementacji TikToka, a nie coś, co TikTok podaje, więc traktuj 2200 i 90 jako pułapy, poniżej których należy pozostać, a nie jako cele do osiągnięcia.

Telefon z klawiaturą emoji, bo każde wybrane tu emoji niesie ukryty koszt w limicie znaków opisu.

Ile jedno emoji kosztuje w limicie?

Od 1 do 11, a czytelnik i tak widzi jeden znak. Według jednej interpretacji koszt to liczba punktów kodowych emoji, a według drugiej suma ich szerokości w UTF-16. Każdy punkt kodowy powyżej U+FFFF zajmuje 2 jednostki kodu. Łączniki zerowej szerokości i selektory wariantów zajmują po 1.

EmojiSekwencja punktów kodowychCzytelnik liczyJako punkty kodoweJako jednostki UTF-16
🍁U+1F341112
😀U+1F600112
⛩️U+26E9 U+FE0F122
❤️U+2764 U+FE0F122
👉🏽U+1F449 U+1F3FD124
🏳️‍🌈U+1F3F3 U+FE0F U+200D U+1F308146
👩‍👩‍👧‍👦U+1F469 U+200D U+1F469 U+200D U+1F467 U+200D U+1F4661711

Nietypowe są brama torii i czerwone serce. Każde z nich to symbol z podstawowej płaszczyzny z selektorem wariantu, więc obie interpretacje dają 2, choć czytelnik widzi 1. Najdroższe jest emoji rodziny: 11 jednostek kodu to w 90-runowym tytule zdjęcia ponad jedna dziesiąta pola.

Tytuł zdjęcia, który przechodzi według jednej interpretacji, a według drugiej nie

Weźmy taki tytuł posta ze zdjęciem: Autumn in Kyoto: the twelve quiet corners we walked before dawn, day 1 🍁🍂🏯🌄👘🎋⛩️👩‍👩‍👧‍👦. To 71 znaków ASCII i osiem emoji. Czytelnik naliczy 79 elementów, czyli wyraźnie poniżej 90.

FragmentCzytelnik liczyJako punkty kodoweJako jednostki UTF-16
Treść ASCII717171
🍁🍂🏯🌄👘🎋6612
⛩️122
👩‍👩‍👧‍👦1711
Razem798696

Jeśli „runy UTF-16" oznaczają punkty kodowe, tytuł ma 86 i się mieści. Jeśli jednostki kodu UTF-16, ma 96 i się nie mieści. Jeden ciąg, jeden udokumentowany limit 90, dwie uzasadnione interpretacje i przeciwne odpowiedzi. Zamień emoji rodziny na 👪 U+1F46A, a ten sam tytuł spadnie według surowszej interpretacji do 87 i przejdzie w obu przypadkach.

Ten sam tytuł, jedno zamienione emoji
👩‍👩‍👧‍👦 emoji rodziny
  • 86 punktów kodowych
  • 96 jednostek UTF-16
  • przekracza 90 runów tytułu według surowszej interpretacji
👪 zamiana na jeden znak
  • 80 punktów kodowych
  • 87 jednostek UTF-16
  • mieści się według obu interpretacji
Zamiana czteroosobowego emoji rodziny na znak rodziny o jednym punkcie kodowym sprawia, że ten sam tytuł zdjęcia mieści się w limicie 90 runów.

Dlaczego ten sam opis nie działa w poście ze zdjęciem?

Bo opis filmu ma do dyspozycji 2200 runów, a tytuł zdjęcia 90. Narzędzie, które przechowuje jeden opis na zaplanowany post i przypisuje go do title w obu endpointach, poradzi sobie z filmem, ale przekroczy tytuł zdjęcia, który pozwala na 24 razy mniej. Albo przytnie ciąg przed wysłaniem, bez ostrzeżenia usuwając większość opisu, albo TikTok odrzuci wywołanie.

Jeśli TikTok je odrzuci, odpowiedź nie będzie konkretna. Żadna z dokumentacji nie podaje nazwanego błędu dla zbyt długiego opisu. Ogólnym kodem jest invalid_param z HTTP 400, opisany jako "Check error message for details", a pozostałe udokumentowane kody dotyczą innych spraw: spam_risk_too_many_posts, reached_active_user_cap, url_ownership_unverified, privacy_level_option_mismatch, scope_not_authorized, rate_limit_exceeded. Długość trzeba sprawdzać we własnym kodzie, bo API nie powie, które pole było za długie.

Właściwe przypisanie traktuje post ze zdjęciem jako dwa pola, a nie jedno. Krótki nagłówek umieść w title, a treść opisu w description, które przy 4000 runów jest najbardziej pojemnym polem tekstowym w całym Content Posting API. Pole description w poście ze zdjęciem mieści niemal dwa razy więcej niż pole title w filmie. Nazwy są odwrotne względem rozmiarów.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Hashtagi to druga asymetria. TikTok dokumentuje ich rozpoznawanie tylko dla pola filmu, w zdaniu z literówką: "Hashtags (#) and mentions (@) will be matched, or deliminated by spaces or new lines." W dokumentacji zdjęć takiego zdania nie ma dla żadnego z pól. Nie wiadomo więc, czy #tag wpisany w opisie zdjęcia stanie się prawdziwym tagiem, dlatego sprawdź to najpierw na poście SELF_ONLY.

Osoba pisze na laptopie, czyli moment, w którym opis jest mierzony w kodzie przed wysłaniem na TikToka.

Jak policzyć opis na TikToka przed wysłaniem?

Oblicz wszystkie trzy liczby i sprawdzaj według największej. Intl.Segmenter podaje liczbę widzianą przez czytelnika w Node i w przeglądarce bez żadnej zależności, a dwie pozostałe są wbudowane.

const segmenter = new Intl.Segmenter('en', { granularity: 'grapheme' });
 
const readings = (text) => ({
  reader: [...segmenter.segment(text)].length,
  codePoints: [...text].length,
  utf16Units: text.length,
});
 
const LIMITS = { videoTitle: 2200, photoTitle: 90, photoDescription: 4000 };
 
const fits = (text, field) => readings(text).utf16Units <= LIMITS[field];

text.length to surowsza interpretacja, więc sprawdzanie według niej zapewnia bezpieczeństwo w obu przypadkach. Nie sięgaj tu po Buffer.byteLength(text, 'utf8'). Bajty UTF-8 to trzecia jednostka, która nalicza 3 za znak kana i 4 za emoji spoza podstawowej płaszczyzny, a dokumentacja TikToka w ogóle ich nie wymaga. To Threads liczy w bajtach UTF-8, i to tylko emoji. Pomylenie tych zasad odrzuca opisy, które TikTok by przyjął.

Czy limit opisu w aplikacji jest taki sam jak w API?

TikTok nie publikuje liczby dla aplikacji, więc nie ma czego porównywać. Dokumentacja Content Posting API podaje 2200, 90 i 4000 dla trzech pól API i nic nie mówi o edytorze w aplikacji. Centrum pomocy TikToka opisuje dodawanie opisu bez podania długości. Liczby krążące w odniesieniu do edytora w aplikacji pochodzą z wpisów marketingowych, a nie od TikToka, dlatego ich tu nie powtarzam.

Dopóki TikTok nie udokumentuje tego inaczej, traktuj oba limity jako odrębne. Opis wpisany w aplikacji i opis wysłany przez /v2/post/publish/video/init/ idą różnymi drogami, a tylko jedna z nich ma opublikowaną liczbę.

Jeszcze jedno ograniczenie jest udokumentowane na innej stronie. Content sharing guidelines TikToka wymagają, by "API Clients must allow users to enter or select the following metadata for a post: a. Title", oraz by "Preset text, including any text in the title field or hashtags, should be allowed to be edited by the user before posting content." Narzędzie, które generuje opis i publikuje go bez możliwości edycji, narusza te zasady, niezależnie od liczby użytych runów.

Gdzie w tym wszystkim jest AdaptlyPost

AdaptlyPost publikuje na TikToku przez to samo Content Posting API, więc limity 2200, 90 i 4000 dotyczą zaplanowanego posta dokładnie tak samo jak wpisanego ręcznie. Limity platformy należą do TikToka. Planowanie zmienia jedynie moment, w którym się o nich dowiadujesz, bo opis przygotowany w kalendarzu treści można zmierzyć na kilka dni przed publikacją, a nie w chwili, gdy API zwróci invalid_param.

Rozbieżność się pogłębia, gdy jeden szkic trafia do kilku sieci, co jest normą przy publikowaniu na wielu platformach. Każda sieć ma własną jednostkę liczenia, więc opis dopasowany do jednej nie musi być bezpieczny w kolejnej. Jeśli piszesz za pomocą generatora opisów AI, warto trzymać emoji na końcu, gdzie ich przycięcie nic nie kosztuje.

O planowaniu przeczytasz na stronie narzędzia do planowania postów na TikToku, o endpointach na stronie API publikacji TikToka, a wyniki postów sprawdzisz w analityce TikToka.

Najczęściej zadawane pytania

Jaka jest maksymalna długość opisu na TikToku w API?

2200 runów UTF-16 dla opisu filmu, który według dokumentacji Content Posting API trafia do pola title w /v2/post/publish/video/init/. Posty ze zdjęciami działają inaczej: title ma limit 90 runów UTF-16, a description 4000, oba w /v2/post/publish/content/init/.

Co TikTok rozumie przez runy UTF-16?

TikTok nie definiuje tego pojęcia. Run to w języku Go punkt kodowy Unicode, a UTF-16 mierzy w jednostkach kodu, i te dwie interpretacje różnią się dla każdego znaku powyżej U+FFFF. Sprawdzaj według liczby jednostek kodu, czyli text.length w JavaScripcie, bo jest większa i utrzymuje cię w limicie przy obu interpretacjach.

Dlaczego limit opisu zdjęcia na TikToku to tylko 90 znaków?

Limit 90 runów dotyczy pola title, które w postach ze zdjęciami jest nagłówkiem, a nie opisem. Treść opisu należy do description, które dopuszcza 4000 runów UTF-16. Narzędzie przypisujące jeden zapisany opis do title w endpointach filmów i zdjęć trafia na limit 90 i może go tylko przyciąć.

Ile znaków zajmuje emoji w opisie na TikToku?

Od 1 do 11, zależnie od budowy. Emoji o jednym punkcie kodowym, takie jak 😀, kosztuje 1 jako punkt kodowy i 2 jako jednostki kodu UTF-16. Czteroosobowe emoji rodziny 👩‍👩‍👧‍👦 to siedem punktów kodowych spojonych łącznikami zerowej szerokości, czyli 7 lub 11 w zależności od interpretacji, choć czytelnik widzi jeden znak.

Jaki błąd zwraca TikTok, gdy opis jest za długi?

TikTok nie publikuje nazwanego błędu dla zbyt długiego opisu. Ogólnym kodem jest invalid_param z HTTP 400, opisany jako "Check error message for details", a pozostałe opublikowane kody dotyczą ryzyka spamu, limitów, niezweryfikowanej własności adresu URL, niezgodności prywatności i autoryzacji. Sprawdź długość samodzielnie przed wywołaniem endpointu.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Czy limit opisu w aplikacji TikTok jest taki sam jak w API?

TikTok nie publikuje liczby dla edytora w aplikacji, więc na podstawie dokumentacji nie da się ich porównać. Wartości 2200, 90 i 4000 podano tylko dla pól API, w dokumentacji Content Posting API. Każda liczba dla aplikacji, którą znajdziesz gdzie indziej, nie pochodzi od TikToka.

Czy można dodać opis przy wysyłaniu filmu do szkiców na TikToku?

Endpoint wysyłający film do skrzynki twórcy na TikToku, /v2/post/publish/inbox/video/init/, w ogóle nie ma pola opisu. Treść żądania przyjmuje tylko source, video_size, chunk_size, total_chunk_count i video_url. TikTok oczekuje, że twórca doda opis w aplikacji po dotknięciu powiadomienia w skrzynce, bo opis z narzędzia do planowania nigdy nie trafia do danych tego endpointu.

Czy TikTok rozpoznaje hashtagi w poście ze zdjęciem tak samo jak w filmie?

TikTok dokumentuje rozpoznawanie hashtagów i wzmianek tylko dla pola title filmu, w zdaniu mówiącym, że są one "matched, or deliminated by spaces or new lines." W dokumentacji postów ze zdjęciami nie ma podobnego zdania ani dla title, ani dla description. Nie wiadomo, czy #tag wpisany w opisie zdjęcia stanie się klikalnym tagiem, więc zanim na tym polegniesz, sprawdź to na poście SELF_ONLY.

Czy narzędzie do planowania może opublikować opis na TikToku bez możliwości edycji?

Content sharing guidelines TikToka to wykluczają. Wymagają, by klienci API pozwalali użytkownikom wpisać lub wybrać tytuł, i stanowią, że gotowy tekst w polu tytułu lub hashtagach musi dać się edytować przed publikacją. Narzędzie, które generuje opis i publikuje go bez możliwości edycji, narusza te zasady, niezależnie od liczby użytych runów.

Czy opis na TikToka należy liczyć w bajtach UTF-8?

Bajty UTF-8 to w przypadku TikToka niewłaściwa jednostka. Udokumentowane limity TikToka są podane w runach UTF-16, a nie w bajtach, a UTF-8 nalicza 3 bajty za znak kana i 4 za emoji spoza podstawowej płaszczyzny, czego dokumentacja TikToka nigdzie nie wymaga. To Threads nalicza emoji, i tylko emoji, według długości w bajtach UTF-8. Pomylenie tych zasad odrzuca opisy, które TikTok by przyjął.

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

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

Powiązane artykuły