TL;DR, szybka odpowiedź
8 min czytaniaMeta ogranicza karuzelę w Threads do 20 elementów i wymaga co najmniej 2, a pułap podniesiono z 10 w dniu 19 września 2024 r. Publikacja wymaga trzech wywołań: kontenera dla każdego elementu z is_carousel_item=true, kontenera CAROUSEL z listą children rozdzieloną przecinkami, a następnie threads_publish. Karuzela liczy się jako jeden post w limicie 250 dziennie, a Meta nie dokumentuje kodu błędu dla zbyt długiej lub zbyt krótkiej listy children.
Jaki jest limit elementów karuzeli w Threads API?
Meta wyznacza górną granicę karuzeli w Threads API na 20 elementów, a dolną na 2, i podaje tę parę cztery razy na dwóch stronach. Przewodnik po postach zaczyna sekcję o karuzelach od zdania "You may publish up to 20 images, videos, or a mix of the two in a carousel post", a potem jeszcze dwukrotnie wymienia tę regułę w części Limitations: "Carousels are limited to 20 images, videos, or a mix of the two" oraz "Carousels require a minimum of two children."
Strona przeglądu ujmuje to samo w jednym wierszu w części Other Limitations: "Carousel posts must have a maximum of 20 children and a minimum of 2 children." Opis parametru children powtarza to po raz czwarty: "Carousels must have at least 2 and no more than 20 total images, videos, or a mix of the two."
Cztery stwierdzenia, jedna liczba. Taka zgodność jest w dokumentacji publikowania Meta rzadkością i oznacza, że integracja może wpisać te granice na stałe bez obaw, która strona jest nieaktualna.
Kiedy limit karuzeli w Threads wzrósł do 20?
19 września 2024 r., a Meta odnotowała zmianę w dzienniku zmian Threads: "Carousel posts are now allowed up to 20 images, videos, or a mix of the two." Wcześniej pułap wynosił 10, tak jak na Instagramie.
Ta data ma znaczenie przy przeglądzie starszego kodu. Wpisana na stałe dziesiątka to pierwsze, czego warto szukać w każdej integracji z Threads napisanej przed wrześniem 2024 r. lub przeniesionej z biblioteki do publikacji na Instagramie, bo po cichu dzieli zestaw 16 zdjęć na dwa posty, z których każdy zużywa miejsce w dziennym limicie publikacji.

Jak działa tworzenie kontenerów dla poszczególnych elementów?
Publikacja karuzeli w Threads wymaga trzech wywołań, o jedno więcej niż pojedynczy post. Meta opisuje to jako utworzenie "the individual media containers for each image and video", potem "a single carousel container to contain the media containers", a na końcu publikację.
Krok 1 tworzy po jednym kontenerze na element. Wyróżnikiem jest parametr is_carousel_item=true, a media_type przyjmuje tu IMAGE lub VIDEO:
curl -i -X POST \
-d "image_url=<IMAGE_URL>" \
-d "is_carousel_item=true" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads"Każde wywołanie zwraca identyfikator kontenera. Powtórz je dla każdego elementu, maksymalnie 20 razy.
Krok 2 tworzy sam kontener karuzeli z media_type=CAROUSEL i listą children zawierającą rozdzielone przecinkami identyfikatory z kroku 1. Tekst posta (text) należy umieścić w tym wywołaniu, a nie przy poszczególnych elementach:
curl -i -X POST \
-d "media_type=CAROUSEL" \
-d "children=<MEDIA_ID_1>,<MEDIA_ID_2>,<MEDIA_ID_3>,..." \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads"Krok 3 publikuje kontener karuzeli: jego identyfikator przekazujesz jako creation_id do POST /{threads-user-id}/threads_publish, a w odpowiedzi dostajesz identyfikator opublikowanych multimediów. Meta radzi odczekać "on average 30 seconds before publishing a Threads media container to give our server enough time to fully process the upload", a dla filmów zaleca odpytywanie GET /{threads-container-id}?fields=status,error_message "once per minute, for no more than 5 minutes".
Gdzie strony Meta nie zgadzają się co do elementów karuzeli?
is_carousel_item ma na dwóch aktualnych stronach dwie różne klasyfikacje. Przewodnik po postach oznacza go jako "Required" w tabeli parametrów dla pojedynczych postów, z wartościami true i false (domyślnie). Dokumentacja POST /{threads-user-id}/threads oznacza ten sam parametr jako "Optional", z wartościami true i false (domyślnie).
| Strona | is_carousel_item |
|---|---|
| Posty w Threads, tabela parametrów kroku 1 | "Required. Indicates that images and/or videos will appear in a carousel." |
| Dokumentacja publikowania | "Optional. Values: true, false (default)" |
Obie strony zgadzają się, że wartość domyślna to false, więc spójna jest dokumentacja: parametr z wartością domyślną nie może być wymagany. Ta sama tabela w sekcji o karuzelach zawiera też uwagę skopiowaną z tabeli dla pojedynczych postów, "CAROUSEL is not available for single thread posts", która jest prawdziwa, ale nie ma nic wspólnego z elementem karuzeli. Wartości sprawdzaj w tabelach parametrów, a to, czy pole jest obowiązkowe, w dokumentacji referencyjnej.
Co zwraca zbyt duża karuzela?
Meta nie dokumentuje błędu dla listy children przekraczającej granice. Indeks dokumentacji Threads API wymienia dziewięć stron endpointów i żadnej strony z kodami błędów, a adres developers.facebook.com/documentation/threads/reference/error-codes nie działa. Strona rozwiązywania problemów obejmuje tylko dwie rzeczy: wartości status kontenera i błędy przetwarzania multimediów.
| Udokumentowany wynik | Wartości |
|---|---|
status kontenera | EXPIRED, ERROR, FINISHED, IN_PROGRESS, PUBLISHED |
error_message kontenera | FAILED_DOWNLOADING_VIDEO, FAILED_PROCESSING_AUDIO, FAILED_PROCESSING_VIDEO, INVALID_ASPEC_RATIO, INVALID_BIT_RATE, INVALID_DURATION, INVALID_FRAME_RATE, INVALID_AUDIO_CHANNELS, INVALID_AUDIO_CHANNEL_LAYOUT, UNKNOWN |
Każda z tych wartości opisuje pojedynczy plik multimedialny, a nie błędną listę elementów. Jedyny kod błędu ze ścieżki publikacji, który Meta wymienia gdziekolwiek w dokumentacji Threads, to THREADS_API__LINK_LIMIT_EXCEEDED, zgłaszany, gdy post zawiera więcej niż pięć linków.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Nie ma więc czego przechwytywać po nazwie. Sprawdź długość children przed wywołaniem z kroku 2, odrzucaj lokalnie wszystko poniżej 2 i powyżej 20, a to, co API zwróci dla listy spoza zakresu, traktuj jako nieudokumentowane zachowanie, które może się zmienić bez wpisu w dzienniku zmian.
Czy karuzela liczy się jako jeden post, czy jako dwadzieścia?
Jako jeden. Meta mówi o tym w obu miejscach, w których można tej reguły szukać: "Carousel posts count as a single post against a profile's rate limit" w sekcji o karuzelach oraz "Publishing a carousel counts as a single post" w uwadze nad krokiem 3.
To czyni karuzelę największą dźwignią wpływającą na liczbę publikacji w Threads. Profil ograniczony do 250 postów publikowanych przez API w ruchomym okresie 24 godzin może przepuścić 5 000 multimediów, jeśli każda publikacja to pełna karuzela z 20 elementami, wobec 250, gdy każdy post zawiera jedno zdjęcie. Dwadzieścia pojedynczych postów kosztuje dwadzieścia miejsc, a te same dwadzieścia zdjęć w jednej karuzeli kosztuje jedno.
Jak karuzela w Threads wypada na tle Instagrama?
Obie działają na infrastrukturze Meta, ale ich pułapy się różnią. Przewodnik publikowania treści na Instagramie podaje "Carousels are limited to 10 images, videos, or a mix of the two", czyli połowę liczby z Threads, a limit publikacji też jest niższy.
| Threads API | Instagram API | |
|---|---|---|
| Maksimum w karuzeli | 20 elementów | 10 elementów |
| Minimum w karuzeli | 2 elementy | Nieudokumentowane |
| Liczy się w limicie jako | 1 post | 1 post |
| Dzienny limit publikacji | 250 | 100 |
| Wywołanie kontenera karuzeli | POST /{threads-user-id}/threads | POST /<IG_ID>/media |
Publikacja tego samego zestawu w obu miejscach wymaga więc reguły podziału, bo karuzela z 18 zdjęciami z Threads nie zmieści się w poście na Instagramie. Instagramową stronę tych obliczeń, w tym drugie zdanie o liczeniu postów, którego Meta nie wyjaśnia na własnej stronie, omawiamy w artykule o limicie Instagram API wynoszącym 100 postów na 24 godziny.

Jakie wymagania musi spełnić każdy element karuzeli?
Pułap 20 elementów dotyczy liczby, a nie rozmiaru, a każdy element jest sprawdzany osobno według tych samych specyfikacji co pojedyncze posty. Zdjęcia muszą być w formacie JPEG lub PNG, mieć maksymalnie 8 MB, proporcje nie większe niż 10:1, minimalną szerokość 320 i maksymalną 1440, do której Meta skaluje je automatycznie. Filmy muszą być w formacie MOV lub MP4, mieć maksymalnie 1 GB, trwać najwyżej 300 sekund, mieć od 23 do 60 FPS i najwyżej 1920 pikseli w poziomie.
Jeden zbyt duży element powoduje błąd własnego kontenera w kroku 1, więc kontener karuzeli w ogóle nie powstanie. Sprawdzenie multimediów przed pierwszym wywołaniem jest tańsze niż odkrycie w kroku 2, że brakuje jednego z dziewiętnastu identyfikatorów, a ten nawyk przydaje się przy postach z karuzelą w każdej sieci.
Tekst posta ma własny pułap 500 znaków w kontenerze karuzeli, a obowiązują go te same reguły, które opisujemy w artykule o tym, jak limit 500 znaków w Threads API traktuje topic_tag.
Najczęściej zadawane pytania
Czy karuzela w Threads może łączyć zdjęcia i filmy?
Tak. Na każdej stronie podającej limit Meta używa sformułowania "20 images, videos, or a mix of the two", więc karuzela może zawierać dowolne połączenie, o ile łączna liczba mieści się w przedziale od 2 do 20, a każdy element spełnia własną specyfikację.
Jaka jest minimalna liczba elementów w karuzeli Threads?
Dwa. Meta podaje "Carousels require a minimum of two children" w przewodniku po postach i powtarza to na stronie przeglądu jako "a minimum of 2 children". Karuzela z jednym elementem nie jest prawidłowym kontenerem, więc pojedyncze zdjęcie opublikuj jako zwykły post IMAGE.
Czy karuzela z 20 elementami zużywa 20 miejsc w dziennym limicie publikacji?
Nie. Meta podaje, że "Carousel posts count as a single post against a profile's rate limit", więc pełna karuzela z 20 elementami zużywa jedną z 250 publikacji dostępnych w ruchomym okresie 24 godzin.
Gdzie umieścić tekst posta z karuzelą?
W kontenerze karuzeli tworzonym w kroku 2, gdzie text jest parametrem opcjonalnym obok media_type=CAROUSEL i children. Kontenery elementów z kroku 1 też przyjmują text, ale Meta nigdzie nie wyjaśnia, co ta wartość robi przy elemencie karuzeli.
Czy tworzenie kontenerów elementów karuzeli zużywa jakiś limit?
Meta egzekwuje limit publikacji "on the POST /{threads-user-id}/threads_publish endpoint", czyli w kroku 3, więc kontenery elementów z kroku 1 i kontener karuzeli z kroku 2 nie zużywają limitu publikacji. Kontenery jednak wygasają: nieopublikowany zwraca EXPIRED, opisane jako "The container was not published within 24 hours and has expired."
Gdzie udokumentowano limit 20 elementów karuzeli?
W czterech miejscach na dwóch stronach Meta. Przewodnik po postach pod adresem developers.facebook.com/documentation/threads/posts podaje go we wstępie o karuzelach, na liście Limitations i w opisie parametru children, a strona przeglądu pod adresem developers.facebook.com/documentation/threads/overview w części Other Limitations. Zmiana z 10 na 20 jest odnotowana w dzienniku zmian Threads pod datą 19 września 2024 r.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Czy is_carousel_item jest parametrem wymaganym, czy opcjonalnym?
Strony Meta nie są zgodne. Przewodnik po postach oznacza go jako "Required" w tabeli parametrów, a dokumentacja POST /{threads-user-id}/threads oznacza ten sam parametr jako "Optional" z wartością domyślną false. Obie strony zgadzają się co do tej wartości, a parametr z wartością domyślną nie może być obowiązkowy, więc zaufać należy dokumentacji referencyjnej.
Jakie formaty plików i limity rozmiaru dotyczą elementu karuzeli w Threads?
Każdy element jest sprawdzany według tych samych specyfikacji co pojedynczy post, niezależnie od karuzeli, w której się znajduje. Zdjęcia muszą być w formacie JPEG lub PNG, mieć do 8 MB i proporcje nie większe niż 10:1. Filmy muszą być w formacie MOV lub MP4, mieć do 1 GB, trwać do 300 sekund i mieć od 23 do 60 FPS.
Jak długo czekać przed opublikowaniem kontenera karuzeli?
Meta zaleca odczekanie około 30 sekund po utworzeniu kontenera przed wywołaniem threads_publish, aby serwery zdążyły przetworzyć przesłany plik. W przypadku filmów odpytuj GET /{threads-container-id}?fields=status,error_message raz na minutę, przez maksymalnie 5 minut, zanim uznasz kontener za gotowy.
Czy istnieje nazwany kod błędu dla karuzeli ze zbyt dużą lub zbyt małą liczbą elementów?
Meta żadnego nie dokumentuje. Jedyny kod błędu ze ścieżki publikacji wymieniony w dokumentacji Threads to THREADS_API__LINK_LIMIT_EXCEEDED, zgłaszany, gdy post zawiera więcej niż pięć linków. Lista children spoza zakresu od 2 do 20 nie wywołuje żadnego udokumentowanego błędu, więc sprawdź liczbę elementów lokalnie przed wywołaniem z kroku 2.
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 limit 500 znaków w Threads API traktuje topic_tag
Limit 500 znaków w Threads API dotyczy pola text. topic_tag to osobny parametr z limitem 50 znaków, a Meta nie mówi, czy wlicza się on do puli.


Najlepszy rozmiar zdjęć w Threads do postów i karuzel
Zasady Meta dotyczące rozmiaru zdjęć w Threads: JPEG lub PNG, 8 MB na plik, szerokość od 320 do 1440 pikseli, proporcje do 10:1 i od 2 do 20 elementów karuzeli.


Jaki jest limit długości filmu w Threads w aplikacji i w API
Limit długości filmu w Threads to 5 minut w aplikacji i 300 sekund w API, przy pliku do 1 GB. Oto jak Meta sprawdza każdy film.
Powiązane artykuły


Jak limit linków w Threads API liczy adresy URL w poście
Limit linków w Threads API to 5 unikalnych adresów URL na post. Szósty powoduje błąd THREADS_API__LINK_LIMIT_EXCEEDED przy tworzeniu kontenera. Oto jak liczy je Meta.


Jak działa limit 250 postów dziennie w Threads API
Limit 250 postów dziennie w Threads API to ruchome okno 24 godzin liczone od publikacji. Karuzela liczy się raz, a jeden endpoint pokazuje, ile profilowi zostało.


Co dzieje się z ghost postem w Threads po 24 godzinach
Ghost post w Threads to post tekstowy, który Meta archiwizuje po 24 godzinach. Odpowiedzi mogą trafiać do skrzynki, a API tworzy go przez is_ghost_post=true.

