Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Posty ze zdjęciami i karuzelami w TikToku przez API: do 35 obrazów

API for Business w TikToku publikuje post zdjęciowy złożony z od 1 do 35 obrazów. Każdy to plik JPG, JPEG lub WebP o wielkości do 20 MB i nie większy niż 1080 na 1920 pikseli w każdej orientacji. TikTok pobiera je z zweryfikowanego adresu URL. Post przyjmuje tytuł do 90 znaków, opis, poziom prywatności i obraz okładki.

easyCoexistence publikuje posty zdjęciowe TikToka przez publish_tiktok_post z poziomu Claude, ChatGPT lub własnego kodu: przekaż od 1 do 35 linków do obrazów, tytuł i opis, a następnie śledź post przez get_tiktok_publish_status.

35

Najwięcej obrazów, jakie może zawierać pojedynczy post zdjęciowy przez endpoint publikacji zdjęć TikToka.

20 MB

Największy rozmiar pliku dla każdego obrazu w poście zdjęciowym, który musi być w formacie JPG, JPEG lub WebP.

1080 x 1920

Najwyższa rozdzielczość obrazu w pikselach dla posta zdjęciowego, czyli 1920 x 1080 dla obrazu poziomego.

90

Liczba jednostek kodowych UTF-16, jaką może mieć tytuł posta zdjęciowego; opis może mieć do 4 000.

Co wchodzi w skład posta zdjęciowego?

Jedno wywołanie POST /business/photo/publish/ przenosi obrazy i szczegóły posta:

  • photo_images: do 35 adresów URL obrazów w zweryfikowanej domenie lub prefiksie URL.
  • photo_cover_index: obraz użyty jako okładka, liczony od 0, czyli wartość domyślna.
  • post_info.title: do 90 jednostek kodowych UTF-16.
  • post_info.caption: do 4 000 jednostek kodowych UTF-16, z #hashtagami i najwyżej 30 wzmiankami @.
  • post_info.privacy_level: kto może zobaczyć post, w ramach opcji dozwolonych w ustawieniach konta.
  • post_info.disable_comment: wyłącza komentarze pod postem.

Jakie pliki obrazów działają?

JPG, JPEG lub WebP, każdy do 20 MB i nie większy niż 1080 na 1920 pikseli albo 1920 na 1080 dla obrazu poziomego. TikTok sprawdza format dopiero po pobraniu pliku, więc nieobsługiwany plik kończy się błędem file_format_check_failed. publish_tiktok_post odrzuca linki kończące się na .png, .gif, .bmp, .heic, .avif lub .svg, zanim cokolwiek zostanie wysłane.

Czym różnią się tytuł i opis?

To osobne pola z osobnymi limitami. Tytuł może mieć do 90 jednostek kodowych UTF-16. Opis to treść posta, do 4 000 jednostek, i może zawierać #hashtagi oraz wzmianki @ kont, które obserwują się wzajemnie, najwyżej 30. Oba liczone są w jednostkach kodowych UTF-16, więc emoji może zajmować dwie lub więcej. publish_tiktok_post przyjmuje je jako title i caption.

Kto widzi post i czy można komentować?

privacy_level decyduje, kto go zobaczy: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR lub SELF_ONLY, w ramach opcji, które GET /business/video/settings/ zwraca dla konta. TikTok podaje PUBLIC_TO_EVERYONE tylko dla kont publicznych i właśnie ten poziom ustawia publish_tiktok_post. Komentarze są włączone, chyba że disable_comment ma wartość true, a konto, które nie przyjmuje komentarzy od nikogo, akceptuje wyłącznie true.

Co dzieje się po wywołaniu?

TikTok zwraca share_id i pobiera obrazy w tle. get_tiktok_publish_status przyjmuje ten share_id i raportuje PROCESSING_DOWNLOAD, gdy TikTok pobiera obrazy, PUBLISH_COMPLETE, gdy post przeszedł moderację, albo FAILED z powodem, na przykład photo_pull_failed. TikTok ogranicza posty zdjęciowe przez ten endpoint do sześciu na minutę i 15 dziennie na konto.

Typowe błędy

  • Wysyłanie obrazów PNG. Posty zdjęciowe TikToka przyjmują wyłącznie JPG, JPEG lub WebP, więc przed publikacją przekonwertuj pliki.
  • Liczenie tytułu w znakach tak, jak je widzisz. TikTok liczy jednostki kodowe UTF-16, więc tytuł z emoji szybciej osiągnie 90.
  • Używanie obrazów większych niż 1080 na 1920 pikseli. To największa rozdzielczość TikToka dla postów zdjęciowych, więc najpierw zmniejsz większe obrazy.
  • Umieszczanie okładki poza pierwszą pozycją. publish_tiktok_post używa pierwszego obrazu jako okładki.
Z EasyCoexistence zrobisz to

Posty zdjęciowe mogą też wychodzić o wybranej dacie i godzinie, z własnej kolejki. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym: pierwsze 3 dni za darmo.

Najczęściej zadawane pytania

Ile zdjęć może mieć post TikToka przez API?

Do 35, każde jako plik JPG, JPEG lub WebP nieprzekraczający 20 MB.

Czy post zdjęciowy TikToka może używać obrazów PNG?

Nie. Endpoint zdjęć przyjmuje JPG, JPEG i WebP, a TikTok odrzuca PNG po pobraniu, z błędem file_format_check_failed.

Jak długi może być tytuł posta zdjęciowego?

Do 90 jednostek kodowych UTF-16. Opis to osobne pole i może mieć do 4 000.

Który obraz staje się okładką?

Ten, na który wskazuje photo_cover_index, liczony od 0. publish_tiktok_post pozostawia wartość 0, więc okładką jest pierwszy obraz.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w