Ce que TikTok creator_info max_video_post_duration_sec vous dit avant de publier

Que renvoie TikTok creator_info max_video_post_duration_sec ?

Le champ TikTok creator_info max_video_post_duration_sec renvoie la vidéo la plus longue, en secondes, que ce créateur précis a le droit de publier. La formulation de TikTok ne laisse aucune place à une constante globale :

« 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. »

Elle arrive d'un seul endpoint, qui ne prend aucun corps de requête :

Le jeton d'accès identifie le créateur, donc l'appel est une consultation plutôt qu'une requête. TikTok décrit l'objectif de l'endpoint dans le même souffle que l'écran qu'il est censé dessiner : « 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. »

Que renvoie d'autre l'endpoint creator info ?

Huit champs, et chacun existe pour modifier ce que votre écran de publication affiche :

Le TTL de deux heures sur l'avatar passe facilement inaperçu et produit des images cassées sur tout écran qui met l'URL en cache pour la durée d'une session. Les deux indicateurs disabled fondent deux causes distinctes dans un seul booléen : un compte privé et un réglage explicite sur « No one » renvoient tous deux true, et la réponse ne vous donne aucun moyen de les distinguer.

Pourquoi la durée maximale varie-t-elle d'un créateur à l'autre ?

Parce que TikTok accorde les privilèges de durée par compte plutôt que par plateforme. Le Media Transfer Guide est la seule page qui cite des chiffres :

« 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. »

Cela donne un plancher documenté de 180 secondes et un plafond documenté de 600. La réponse d'exemple de TikTok ne renvoie ensuite ni l'un ni l'autre :

"max_video_post_duration_sec": 300

Trois cents secondes, c'est le palier intermédiaire, cinq minutes. L'exemple est cohérent avec les paliers, mais rien dans la référence n'indique que le champ se limite à 180, 300 et 600. Il est typé int32 sans énumération, donc un client qui aiguille sur trois valeurs codées en dur parie sur une hypothèse non documentée. Comparez la réponse à la vidéo que vous tenez, jamais à une constante.

Le centre d'aide grand public de TikTok ne comble pas le vide non plus. Son article « Making a post » dit aux créateurs de « Select a maximum length for your video » et ne publie aucun chiffre nulle part sur la page, ce qui explique pourquoi le récit in-app sur la durée d'une vidéo TikTok et le récit de l'API continuent de diverger. Pour une intégration, le champ de l'API est le seul chiffre réellement faisant autorité, et il ne fait autorité que pour le compte dont vous avez utilisé le jeton.

Quels niveaux de confidentialité reviennent avec lui ?

privacy_level_options renvoie une liste différente selon que le compte est public ou privé, et TikTok détaille les deux :

Les deux listes n'ont en commun que MUTUAL_FOLLOW_FRIENDS et SELF_ONLY. PUBLIC_TO_EVERYONE n'apparaît jamais pour un compte privé, et FOLLOWER_OF_CREATOR jamais pour un compte public. La référence Direct Post liste les quatre valeurs dans l'énumération privacy_level sans cette séparation, et c'est en lisant l'énumération au lieu de la réponse que les intégrations finissent par envoyer une valeur que le compte ne peut pas utiliser.

La sanction est précise. privacy_level_option_mismatch revient à l'init, et TikTok y accroche un avertissement : « 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. »

Les règles d'interface sont tout aussi prescriptives. TikTok exige que « Users must manually select the privacy status from a dropdown and there should be no default value », que les interactions désactivées soient grisées, et qu'aucune des bascules commentaire, Duet ou Stitch ne démarre cochée. Sur la durée, les mêmes directives disent : « 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. » Récupérer une valeur n'est pas de la conformité. Bloquer le post, si.

Les clients non audités ont une liste encore plus courte. TikTok les restreint à une visibilité SELF_ONLY et à « up to 5 users to post in a 24 hour window », chacun de ces comptes devant être privé au moment de la publication.

Ce que TikTok laisse en suspens

Trois zones d'ombre méritent une place sur une checklist plutôt qu'une découverte en production.

Le scope ne correspond pas au flux. Query Creator Info exige le scope video.publish. L'endpoint Upload sur /v2/post/publish/inbox/video/init/ exige video.upload. Un client qui se contente de déposer des brouillons dans la boîte de réception du créateur détient donc un jeton incapable d'appeler l'endpoint dont TikTok lui demande de respecter la valeur. TikTok n'aborde jamais le conflit ; la phrase sur le rognage dans le Media Transfer Guide est ce qui s'en approche le plus, puisqu'un upload trop long arrive chez le créateur pour qu'il le rogne plutôt que d'être rejeté d'emblée.

Un refus peut arriver en HTTP 200. Le tableau d'erreurs de creator info liste spam_risk_too_many_posts, spam_risk_user_banned_from_posting et reached_active_user_cap sous le statut HTTP « 200 (intentional) ». Un client qui n'aiguille que sur les codes de statut y lit un succès et affiche un écran de publication qui ne peut rien publier. La consigne de TikTok est de s'arrêter : « 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. »

Le plafond de publication est décrit, pas publié. TikTok écrit : « 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. » Aucun champ ne renvoie ce nombre, et « typically around » est tout ce que TikTok concède en matière de précision, ce qui reste plus flou que le chiffre net derrière la limite de publication de contenu d'Instagram.

Il n'existe aucun minimum documenté. La référence de l'API publie une durée maximale par créateur et rien sur le bas de l'échelle. Une vidéo trop courte ne se manifeste qu'après coup, sous la raison d'échec duration_check_failed de /v2/post/publish/status/fetch/, décrite ainsi : « Video does not meet our duration restrictions. »

Traitez l'appel creator info comme une pièce de chaque publication, pas de l'onboarding. Les options de confidentialité, les indicateurs d'interaction et la limite de durée changent dès que le créateur modifie un réglage, ce qui explique pourquoi tout outil qui programme des posts TikTok doit réinterroger au moment de publier plutôt que réutiliser ce qu'il a stocké la semaine dernière. La légende que vous attachez est régie séparément, par le plafond de 2200 runes UTF-16 détaillé dans la limite de caractères des légendes TikTok.

Questions fréquentes

max_video_post_duration_sec renvoie-t-il parfois autre chose que 180, 300 ou 600 ?

TikTok ne promet pas ces trois valeurs. Le champ est un int32, la référence ne publie aucune énumération, et seul le Media Transfer Guide mentionne des privilèges de 3, 5 et 10 minutes. Comparez votre vidéo au nombre renvoyé plutôt qu'à un ensemble codé en dur.

Que se passe-t-il si je publie une vidéo plus longue que la limite renvoyée ?

Via Direct Post, la tâche échoue avec la raison duration_check_failed. Via l'endpoint Upload, TikTok indique que « TikTok users may trim developer-sent videos inside the TikTok app to fit their accounts' actual maximum publish durations », donc le créateur règle le problème pendant le montage.

Une intégration réservée aux photos peut-elle ignorer ce champ ?

Oui, et TikTok le dit sans détour. max_video_post_duration_sec, duet_disabled et stitch_disabled portent tous la mention « IGNORE if your client only sends photo media through this API. »

À quelle fréquence puis-je appeler l'endpoint creator info ?

Vingt fois par minute et par jeton d'accès utilisateur. C'est le plafond publié le plus haut des endpoints de publication, qui plafonnent à 6 requêtes par minute pour les appels init et 30 pour l'interrogation du statut.

Pourquoi duet_disabled est-il true alors que le créateur n'a jamais désactivé Duet ?

Parce qu'un compte privé lève le même indicateur. TikTok renvoie true si « the creator account is private or they set the Duet interaction to "No one" in their privacy setting », et la réponse ne donne aucun moyen de distinguer les deux causes.

L'endpoint m'indique-t-il si le compte est public ou privé ?

Pas sous forme de champ, mais privacy_level_options le trahit. Une liste contenant PUBLIC_TO_EVERYONE appartient à un compte public, une liste contenant FOLLOWER_OF_CREATOR à un compte privé, puisque les deux valeurs n'apparaissent jamais ensemble.

Faut-il interroger creator info avant chaque publication, ou une seule fois lors de l'intégration ?

Avant chaque publication, pas seulement lors de l'intégration. Les options de confidentialité, les indicateurs d'interaction et la limite de durée changent dès que le créateur modifie un réglage, si bien qu'une valeur récupérée la semaine précédente peut déjà être obsolète. Les outils qui planifient des publications TikTok doivent interroger à nouveau au moment de la publication plutôt que réutiliser une réponse stockée.

Que se passe-t-il si mon application laisse le créateur choisir un niveau de confidentialité absent de privacy_level_options ?

TikTok renvoie l'erreur privacy_level_option_mismatch lors de l'init. Pour les applications en product-use, TikTok considère les occurrences répétées de cette erreur comme un signe de non-respect de ses directives, car les clients doivent afficher uniquement les options de confidentialité réellement disponibles pour le compte.

Quelles restrictions supplémentaires s'appliquent à une application TikTok qui n'a pas encore passé l'audit ?

TikTok limite les clients non audités au niveau de confidentialité SELF_ONLY et à la publication pour au plus 5 utilisateurs sur une fenêtre de 24 heures. Chacun de ces comptes doit être privé au moment de la publication.

TikTok publie-t-il un chiffre exact pour le plafond quotidien de publications par compte créateur ?

TikTok ne publie aucun chiffre exact. Il décrit une limite partagée entre tous les clients API qui est « généralement autour de 15 publications par jour/compte créateur » et peut varier selon le créateur, sans qu'aucun champ de réponse ne renvoie ce nombre.