Was TikTok creator_info max_video_post_duration_sec dir vor dem Posten verrät

Was liefert TikTok creator_info max_video_post_duration_sec zurück?

Das Feld TikTok creator_info max_video_post_duration_sec liefert das längste Video in Sekunden, das genau dieser Creator veröffentlichen darf. Der Wortlaut von TikTok lässt keinen Raum für eine globale Konstante:

„The longest video duration in seconds that the TikTok creator can post. Different users have different maximum video-duration privileges. Developers should use this field to stop video posts that are too long. IGNORE if your client only sends photo media through this API.“

Es kommt von einem einzigen Endpunkt, der überhaupt keinen Request-Body entgegennimmt:

Das Access Token identifiziert den Creator, der Aufruf ist also eher ein Nachschlagen als eine Abfrage. TikTok beschreibt den Zweck des Endpunkts im selben Atemzug wie den Screen, den er zeichnen soll: „When rendering the Export to TikTok page, your app must invoke the API and use the latest creator information returned to display the account's available privacy level options and video/photo interaction settings.“

Was kommt sonst noch vom Creator-Info-Endpunkt zurück?

Acht Felder, und jedes einzelne existiert, um zu ändern, was dein Posting-Screen anzeigt:

Die Avatar-TTL von zwei Stunden übersieht man leicht, und sie erzeugt kaputte Bilder auf jedem Screen, der die URL für eine Session cacht. Die beiden disabled-Flags falten zwei getrennte Ursachen in einen Boolean: Ein privates Konto und eine ausdrückliche Einstellung auf „No one“ liefern beide true, und die Antwort gibt dir keine Möglichkeit zu unterscheiden.

Warum schwankt die maximale Videodauer je Creator?

Weil TikTok Dauer-Privilegien pro Konto vergibt statt pro Plattform. Der Media Transfer Guide ist die einzige Seite, die Zahlen nennt:

„All TikTok creators can post 3-minute videos, while some have access to post 5-minute or 10-minute videos. The longest video a developer can send via the initialize Upload Video endpoint is 10 minutes. TikTok users may trim developer-sent videos inside the TikTok app to fit their accounts' actual maximum publish durations.“

Damit steht ein dokumentierter Boden bei 180 Sekunden und eine dokumentierte Decke bei 600. Die eigene Beispielantwort von TikTok liefert dann weder das eine noch das andere:

"max_video_post_duration_sec": 300

Dreihundert Sekunden sind die mittlere Stufe, fünf Minuten. Das Beispiel passt zu den Stufen, aber nichts in der Referenz sagt, dass das Feld auf 180, 300 und 600 beschränkt ist. Es ist als int32 typisiert, ohne Enum, ein Client, der auf drei fest verdrahtete Werte verzweigt, wettet also auf eine undokumentierte Annahme. Vergleiche die Antwort mit dem Video, das du in der Hand hast, nie mit einer Konstante.

Das Verbraucher-Hilfecenter von TikTok schließt die Lücke ebenfalls nicht. Sein Artikel „Making a post“ sagt Creatorn, sie sollen „Select a maximum length for your video“, und nennt auf der ganzen Seite keine Zahl, weshalb die In-App-Geschichte darum, wie lang ein TikTok-Video sein darf, und die API-Geschichte immer weiter auseinanderdriften. Für eine Integration ist das API-Feld die einzige wirklich maßgebliche Zahl, und maßgeblich ist sie nur für das Konto, dessen Token du benutzt hast.

Welche Privatsphäre-Optionen kommen dazu zurück?

privacy_level_options liefert eine andere Liste, je nachdem, ob das Konto öffentlich oder privat ist, und TikTok schreibt beide aus:

Die beiden Listen teilen sich nur MUTUAL_FOLLOW_FRIENDS und SELF_ONLY. PUBLIC_TO_EVERYONE taucht bei einem privaten Konto nie auf, und FOLLOWER_OF_CREATOR nie bei einem öffentlichen. Die Direct-Post-Referenz listet alle vier Werte im privacy_level-Enum ohne diese Trennung, und genau deshalb senden Integrationen am Ende einen Wert, den das Konto nicht nutzen kann, wenn sie das Enum statt der Antwort lesen.

Die Strafe dafür ist eindeutig. privacy_level_option_mismatch kommt beim init zurück, und TikTok hängt eine Warnung daran: „All clients are required to correctly display the creator account's privacy level options and honor the users' choice. Occurances of this error for product-use applications suggest violations to TikTok's product-use guidance.“

Die UX-Regeln sind genauso streng. TikTok verlangt, dass „Users must manually select the privacy status from a dropdown and there should be no default value“, dass deaktivierte Interaktionen ausgegraut sind und dass keiner der Schalter für Kommentare, Duet oder Stitch vorausgewählt startet. Zur Dauer sagen dieselben Guidelines: „API clients must check if the duration of the to-be-posted video follows the max_video_post_duration_sec returned in the creator_info API.“ Einen Wert zurückzubekommen ist keine Compliance. Den Beitrag zu blockieren schon.

Nicht auditierte Clients bekommen eine noch kürzere Liste. TikTok beschränkt sie auf SELF_ONLY als Sichtbarkeit und auf „up to 5 users to post in a 24 hour window“, wobei jedes dieser Konten zum Zeitpunkt des Postens privat ist.

Was TikTok offenlässt

Drei Lücken gehören auf eine Checkliste, statt in der Produktion entdeckt zu werden.

Der Scope passt nicht zum Ablauf. Query Creator Info verlangt den Scope video.publish. Der Upload-Endpunkt unter /v2/post/publish/inbox/video/init/ verlangt video.upload. Ein Client, der nur Entwürfe in den Posteingang des Creators legt, hält damit ein Token, das den Endpunkt gar nicht aufrufen kann, dessen Wert er laut TikTok einhalten soll. TikTok geht auf den Widerspruch nie ein; der Satz zum Zuschneiden im Media Transfer Guide kommt einer Auflösung am nächsten, denn ein zu langer Inbox-Upload landet beim Creator zum Kürzen, statt direkt abgelehnt zu werden.

Eine Ablehnung kann als HTTP 200 ankommen. Die Fehlertabelle von Creator Info führt spam_risk_too_many_posts, spam_risk_user_banned_from_posting und reached_active_user_cap unter dem HTTP-Status „200 (intentional)“. Ein Client, der nur auf Statuscodes verzweigt, liest das als Erfolg und zeigt einen Posting-Screen, der nicht posten kann. TikToks Anweisung lautet, aufzuhören: „When the creator_info API returns that the creator can not make more posts at this moment, API Clients must stop the current publishing attempt and prompt users to try again later.“

Das Posting-Limit wird beschrieben, nicht veröffentlicht. TikTok schreibt: „There is a limit on the number of posts that can be made to a creator account in a 24-hour window via Direct Post API. The upper limit may vary among creators (typically around 15 posts per day/ creator account) and is shared across all API Clients using Direct Post.“ Kein Feld liefert diese Zahl, und „typically around“ ist so genau, wie TikTok wird, was eine weichere Aussage ist als die glatte Zahl hinter dem Limit für Content Publishing bei Instagram.

Es gibt kein dokumentiertes Minimum. Die API-Referenz veröffentlicht eine maximale Dauer pro Creator und nichts zum unteren Ende. Ein zu kurzes Video zeigt sich erst im Nachhinein, als Fail-Reason duration_check_failed von /v2/post/publish/status/fetch/, beschrieben als „Video does not meet our duration restrictions.“

Behandle den Creator-Info-Aufruf als Teil jeder Veröffentlichung, nicht als Teil des Onboardings. Die Privatsphäre-Optionen, die Interaktions-Flags und das Dauerlimit ändern sich alle, sobald der Creator eine Einstellung ändert, und genau deshalb muss jedes Tool, das TikTok-Beiträge plant, zum Veröffentlichungszeitpunkt neu abfragen, statt den letzte Woche gespeicherten Wert wiederzuverwenden. Die Caption, die du anhängst, unterliegt einer eigenen Regel, der Obergrenze von 2200 UTF-16-Runen aus dem TikTok Caption-Zeichenlimit.

Häufig gestellte Fragen

Liefert max_video_post_duration_sec je etwas anderes als 180, 300 oder 600?

TikTok sagt diese drei Werte nicht zu. Das Feld ist ein int32, die Referenz veröffentlicht kein Enum, und nur der Media Transfer Guide erwähnt Privilegien von 3, 5 und 10 Minuten. Vergleiche dein Video mit der zurückgelieferten Zahl statt mit einem fest verdrahteten Satz.

Was passiert, wenn ich ein Video über dem zurückgelieferten Limit poste?

Über Direct Post scheitert der Job mit der Fail-Reason duration_check_failed. Über den Upload-Endpunkt sagt TikTok, dass „TikTok users may trim developer-sent videos inside the TikTok app to fit their accounts' actual maximum publish durations“, der Creator löst es also während des Bearbeitens.

Darf eine reine Foto-Integration dieses Feld ignorieren?

Ja, und TikTok sagt das direkt. max_video_post_duration_sec, duet_disabled und stitch_disabled sind alle markiert mit „IGNORE if your client only sends photo media through this API.“

Wie oft darf ich den Creator-Info-Endpunkt aufrufen?

Zwanzigmal pro Minute pro User Access Token. Das ist die höchste veröffentlichte Obergrenze der Posting-Endpunkte, die bei 6 Anfragen pro Minute für init-Calls und 30 fürs Status-Polling liegen.

Warum ist duet_disabled true, obwohl der Creator Duet nie abgeschaltet hat?

Weil ein privates Konto dasselbe Flag setzt. TikTok liefert true, wenn „the creator account is private or they set the Duet interaction to "No one" in their privacy setting“, und die Antwort bietet keine Möglichkeit, die beiden Ursachen zu unterscheiden.

Sagt mir der Endpunkt, ob das Konto öffentlich oder privat ist?

Nicht als Feld, aber privacy_level_options verrät es. Eine Liste mit PUBLIC_TO_EVERYONE gehört zu einem öffentlichen Konto und eine mit FOLLOWER_OF_CREATOR zu einem privaten, denn die beiden Werte tauchen nie zusammen auf.

Muss ich creator_info vor jedem Post abfragen oder reicht einmal beim Onboarding?

Vor jedem Post, nicht nur beim Onboarding. Die Privatsphäre-Optionen, die Interaktions-Flags und das Dauerlimit ändern sich, sobald der Creator eine Einstellung anpasst, also kann ein vor einer Woche abgerufener Wert längst veraltet sein. Tools, die TikTok-Posts planen, müssen zum Zeitpunkt der Veröffentlichung erneut abfragen, statt eine gespeicherte Antwort wiederzuverwenden.

Was passiert, wenn meine App einen Privatsphäre-Level zulässt, der nicht in privacy_level_options steht?

TikTok liefert beim Init den Fehler privacy_level_option_mismatch zurück. Bei Product-Use-Anwendungen wertet TikTok wiederholte Vorkommen dieses Fehlers als Hinweis auf einen Verstoß gegen die Product-Use-Richtlinien, weil Clients nur die tatsächlich verfügbaren Privatsphäre-Optionen des Kontos anzeigen dürfen.

Welche zusätzlichen Grenzen gelten für eine TikTok-App, die noch kein Audit durchlaufen hat?

TikTok beschränkt nicht auditierte Clients auf den Privatsphäre-Level SELF_ONLY und auf das Posten für bis zu 5 Nutzer innerhalb von 24 Stunden. Jedes dieser Konten muss zum Zeitpunkt des Postens privat sein.

Nennt TikTok eine genaue Zahl für das tägliche Posting-Limit pro Creator-Konto?

TikTok veröffentlicht keine genaue Zahl. Beschrieben wird ein Limit, das für alle API-Clients gemeinsam gilt und "typischerweise bei etwa 15 Posts pro Tag/Creator-Konto" liegt und je nach Creator variieren kann, ohne dass ein Feld in irgendeiner Antwort diese Zahl zurückliefert.