So funktioniert das Threads-API-Maximum an Karussell-Elementen

Was ist das Threads-API-Maximum an Karussell-Elementen?

Meta setzt das Threads-API-Maximum an Karussell-Elementen auf 20 Children, mit einer Untergrenze von 2, und nennt das Paar viermal auf zwei Seiten. Die Beitragsanleitung eröffnet ihren Karussell-Abschnitt mit „You may publish up to 20 images, videos, or a mix of the two in a carousel post“ und führt die Regel unter Limitations noch zweimal auf: „Carousels are limited to 20 images, videos, or a mix of the two“ und „Carousels require a minimum of two children.“

Die Überblicksseite sagt dasselbe in einer Zeile unter Other Limitations: „Carousel posts must have a maximum of 20 children and a minimum of 2 children.“ Die Beschreibung des Parameters children wiederholt es ein viertes Mal: „Carousels must have at least 2 and no more than 20 total images, videos, or a mix of the two.“

Vier Aussagen, eine Zahl. So viel Übereinstimmung ist in Metas Publishing-Dokumentation ungewöhnlich, und sie bedeutet, dass eine Integration die Grenzprüfung fest verdrahten kann, ohne sich zu fragen, welche Seite veraltet ist.

Wann wurde die Threads-Karussell-Grenze zu 20?

Am 19. September 2024, und Meta hat die Änderung im Threads-Changelog protokolliert: „Carousel posts are now allowed up to 20 images, videos, or a mix of the two.“ Vor diesem Eintrag lag die Obergrenze bei 10, passend zu Instagram.

Dieses Datum zählt beim Prüfen älteren Codes. Eine fest verdrahtete 10 ist das Erste, wonach man in jeder Threads-Integration sucht, die vor September 2024 geschrieben oder aus einer Instagram-Publishing-Bibliothek portiert wurde, denn sie zerlegt einen Satz aus 16 Bildern still in zwei Beiträge, die jeweils einen Slot des täglichen Veröffentlichungskontingents verbrennen.

Wie läuft der Container-Ablauf pro Element ab?

Ein Threads-Karussell zu veröffentlichen braucht drei Aufrufe, einen mehr als ein einzelner Beitrag. Meta beschreibt es als das Anlegen von „the individual media containers for each image and video“, dann „a single carousel container to contain the media containers“, dann die Veröffentlichung.

Schritt 1 legt einen Container pro Element an. Der unterscheidende Parameter ist is_carousel_item=true, und media_type nimmt hier IMAGE oder VIDEO an:

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"

Jeder Aufruf gibt eine Container-ID zurück. Wiederhole ihn für jedes Element, bis zu 20.

Schritt 2 legt den Karussell-Container selbst an, mit media_type=CAROUSEL und einer kommagetrennten children-Liste der IDs aus Schritt 1. Der text des Beitrags gehört an diesen Aufruf, nicht an die einzelnen Elemente:

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"

Schritt 3 veröffentlicht den Karussell-Container, indem seine ID als creation_id an POST /{threads-user-id}/threads_publish geht, was die veröffentlichte Medien-ID zurückgibt. Meta rät, „on average 30 seconds before publishing a Threads media container to give our server enough time to fully process the upload“ zu warten, und empfiehlt für Video-Elemente, GET /{threads-container-id}?fields=status,error_message „once per minute, for no more than 5 minutes“ abzufragen.

Wo widersprechen sich Metas eigene Seiten bei Karussell-Elementen?

is_carousel_item bekommt auf zwei aktiven Seiten zwei verschiedene Einstufungen. Die Beitragsanleitung markiert den Parameter in der Parametertabelle für einzelne Thread-Beiträge als „Required“, mit den Werten true und false (Standard). Die Referenz zu POST /{threads-user-id}/threads markiert denselben Parameter als „Optional“, mit den Werten true und false (Standard).

Da beide Seiten sich einig sind, dass der Standard false ist, ist die Referenz die stimmige: Ein Parameter mit einem Standardwert kann nicht erforderlich sein. Dieselbe Tabelle im Karussell-Abschnitt trägt außerdem eine aus der Tabelle für Einzelbeiträge kopierte Notiz, „CAROUSEL is not available for single thread posts“, die zwar stimmt, mit einem Karussell-Element aber nichts zu tun hat. Lies die Parametertabellen für die Werte und die Referenz dafür, ob ein Feld Pflicht ist.

Was gibt ein zu großes Karussell zurück?

Meta dokumentiert keinen Fehler für eine children-Liste, die die Grenzen sprengt. Der Index der Threads API Reference listet neun Endpunktseiten und keine Seite mit Fehlercodes, und developers.facebook.com/documentation/threads/reference/error-codes löst nicht auf. Die Troubleshooting-Seite deckt nur zwei Dinge ab: Container-status-Werte und Fehler bei der Medienverarbeitung.

Jeder dieser Werte beschreibt eine einzelne Mediendatei, keine fehlerhafte children-Liste. Der einzige Fehlercode auf dem Publish-Pfad, den Meta irgendwo in der Threads-Dokumentation benennt, ist THREADS_API__LINK_LIMIT_EXCEEDED, der auslöst, wenn ein Beitrag mehr als fünf Links trägt.

Es gibt also nichts, was sich beim Namen abfangen ließe. Prüfe die Länge von children vor dem Aufruf in Schritt 2, weise lokal alles unter 2 und über 20 zurück, und behandle das, was die API für eine Liste außerhalb der Grenzen zurückgibt, als undokumentiertes Verhalten, das sich ohne Changelog-Eintrag ändern kann.

Zählt ein Karussell als ein Beitrag oder als zwanzig?

Als einer. Meta sagt es an beiden Stellen, an denen man die Regel suchen würde: „Carousel posts count as a single post against a profile's rate limit“ im Karussell-Abschnitt und „Publishing a carousel counts as a single post“ in der Notiz über Schritt 3.

Das macht das Karussell zum größten Hebel, den jemand auf das Threads-Veröffentlichungsvolumen hat. Ein Profil, das auf 250 über die API veröffentlichte Beiträge in einem beweglichen 24-Stunden-Zeitraum begrenzt ist, kann 5.000 Medien bewegen, wenn jede Veröffentlichung ein volles Karussell mit 20 Elementen ist, gegenüber 250, wenn jeder Beitrag ein Bild trägt. Zwanzig Einzelbeiträge kosten zwanzig Slots; dieselben zwanzig Bilder als ein Karussell kosten einen.

Wie schlägt sich das Threads-Karussell gegen das von Instagram?

Beide laufen auf Metas Infrastruktur, und keine der beiden Obergrenzen passt zur anderen. Instagrams Leitfaden zum Content Publishing hält fest: „Carousels are limited to 10 images, videos, or a mix of the two“, also die Hälfte der Threads-Zahl, und auch das Veröffentlichungskontingent liegt niedriger.

Denselben Satz in beide zu spiegeln braucht daher eine Aufteilungsregel, denn ein Threads-Karussell mit 18 Bildern passt in keinen Instagram-Beitrag. Die Instagram-Seite dieser Rechnung, samt dem zweiten Satz zur Beitragszahl, den Meta auf seiner eigenen Seite offen lässt, steht in dem Instagram-API-Limit von 100 Posts pro 24 Stunden.

Was muss jedes Karussell-Element erfüllen?

Die Obergrenze von 20 Elementen ist eine Anzahl, kein Größenbudget, und jedes Child wird für sich gegen dieselben Medienspezifikationen geprüft, die auch für Einzelbeiträge gelten. Bilder müssen JPEG oder PNG sein, maximal 8 MB, mit einem Seitenverhältnis innerhalb von 10:1, mit einer Mindestbreite von 320 und einem Maximum von 1440, auf das Meta automatisch skaliert. Videos müssen MOV oder MP4 sein, maximal 1 GB, maximal 300 Sekunden, 23 bis 60 FPS, mit maximal 1920 horizontalen Pixeln.

Ein einzelnes übergroßes Child bringt in Schritt 1 seinen eigenen Container zu Fall, womit der Karussell-Container nie entsteht. Medien vor dem ersten Aufruf zu prüfen ist billiger, als in Schritt 2 zu entdecken, dass eine von neunzehn IDs fehlt, eine Gewohnheit, die für Karussell-Beiträge in jedem Netzwerk gilt.

Der Beitragstext hat seine eigene Obergrenze von 500 Zeichen auf dem Karussell-Container, geregelt von denselben Regeln, die in wie das Threads-API-Zeichenlimit von 500 Zeichen topic_tag behandelt stehen.

Häufig gestellte Fragen

Kann ein Threads-Karussell Bilder und Videos mischen?

Ja. Metas Wortlaut ist „20 images, videos, or a mix of the two“ auf jeder Seite, die das Limit nennt, also kann ein Karussell jede Kombination halten, solange die Gesamtzahl zwischen 2 und 20 bleibt und jedes Element seine eigene Medienspezifikation erfüllt.

Wie viele Elemente muss ein Threads-Karussell mindestens haben?

Zwei. Meta hält „Carousels require a minimum of two children“ in der Beitragsanleitung fest und wiederholt es auf der Überblicksseite als „a minimum of 2 children“. Ein Karussell mit einem Element ist kein gültiger Container, veröffentliche ein einzelnes Bild also als normalen IMAGE-Beitrag.

Verbraucht ein Karussell mit 20 Elementen 20 Slots des täglichen Veröffentlichungskontingents?

Nein. Meta hält fest: „Carousel posts count as a single post against a profile's rate limit“, also verbraucht ein volles Karussell mit 20 Elementen eine der 250 Veröffentlichungen, die in einem beweglichen 24-Stunden-Zeitraum zur Verfügung stehen.

Wo steht der Text eines Karussell-Beitrags?

Am Karussell-Container aus Schritt 2, wo text als optionaler Parameter neben media_type=CAROUSEL und children geführt wird. Die einzelnen Element-Container aus Schritt 1 nehmen ebenfalls text an, und Meta sagt nie, was dieser Wert bei einem Karussell-Element bewirkt.

Verbraucht das Anlegen von Karussell-Element-Containern Kontingent?

Meta setzt das Veröffentlichungslimit „on the POST /{threads-user-id}/threads_publish endpoint“ durch, also in Schritt 3, damit verbrauchen die Element-Container aus Schritt 1 und der Karussell-Container aus Schritt 2 kein Veröffentlichungskontingent. Container verfallen allerdings: ein unveröffentlichter gibt EXPIRED zurück, beschrieben als „The container was not published within 24 hours and has expired.“

Wo ist das Karussell-Limit von 20 Elementen dokumentiert?

An vier Stellen auf zwei Meta-Seiten. Die Beitragsanleitung unter developers.facebook.com/documentation/threads/posts nennt es in der Karussell-Einleitung, in ihrer Limitations-Liste und in der Beschreibung des Parameters children; die Überblicksseite unter developers.facebook.com/documentation/threads/overview nennt es unter Other Limitations. Die Änderung von 10 auf 20 ist im Threads-Changelog unter dem 19. September 2024 protokolliert.

Ist is_carousel_item ein erforderlicher oder ein optionaler Parameter?

Metas eigene Seiten widersprechen sich hier. Der Posts-Guide markiert diesen Parameter in seiner Tabelle als „Erforderlich“, während die Referenz zu POST /{threads-user-id}/threads denselben Parameter als „Optional“ mit dem Standardwert false führt. Da beide Seiten denselben Standardwert nennen, kann der Parameter nicht zwingend sein, und die Referenzseite ist hier die verlässlichere.

Welche Dateiformate und Größenlimits gelten für ein Element im Threads-Karussell?

Jedes Element wird nach denselben Medienspezifikationen geprüft wie bei einem einzelnen Beitrag, unabhängig vom Karussell. Bilder müssen JPEG oder PNG sein, maximal 8 MB groß, mit einem Seitenverhältnis innerhalb von 10:1. Videos müssen MOV oder MP4 sein, maximal 1 GB und 300 Sekunden lang, mit 23 bis 60 Bildern pro Sekunde.

Wie lange sollte ich warten, bevor ich einen Karussell-Container veröffentliche?

Meta empfiehlt, nach dem Anlegen eines Containers etwa 30 Sekunden zu warten, bevor threads_publish aufgerufen wird, damit die Server genug Zeit zur Verarbeitung haben. Bei Video-Elementen sollte GET /{threads-container-id}?fields=status,error_message einmal pro Minute abgefragt werden, für maximal 5 Minuten, bevor der Container als bereit gilt.

Gibt es einen benannten Fehlercode für ein Karussell mit zu vielen oder zu wenigen Elementen?

Meta dokumentiert keinen. Der einzige benannte Fehlercode im gesamten Threads-Publishing-Pfad ist THREADS_API__LINK_LIMIT_EXCEEDED, der bei mehr als fünf Links in einem Beitrag greift. Für eine children-Liste außerhalb von 2 bis 20 gibt es keinen dokumentierten Fehler, die Länge sollte also vor dem Aufruf in Schritt 2 lokal geprüft werden.