Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Échecs de publication TikTok : spam_risk_too_many_posts, picture_size_check_failed et autres motifs d'échec

TikTok indique la cause d'un échec dans reason, sur l'endpoint de statut de l'API for Business, ou dans fail_reason sur la Content Posting API. Les échecs de contrôle, comme picture_size_check_failed, signifient que le fichier ne respecte pas une règle de format et doit être modifié ; video_pull_failed signifie que TikTok n'a pas pu télécharger le fichier dans l'heure ; spam_risk_too_many_posts signifie que trop de publications API ont été faites en 24 heures. Un échec marqué internal peut simplement être relancé.

easyCoexistence suit chaque publication TikTok qu'il publie jusqu'à ce que TikTok la termine ou la fasse échouer, pour Claude, ChatGPT ou votre propre plateforme : un échec arrive avec le motif de TikTok par e-mail, sur l'écran Publications et sous forme d'événement post.failed, prêt à être relancé.

reason

Le champ /business/publish/status/ n'est renvoyé que lorsque le statut est FAILED, avec des valeurs comme frame_rate_check_failed.

fail_reason

Le nom que donne la Content Posting API à ce même champ, dans les réponses de /v2/post/publish/status/fetch/.

1 hour

Délai de téléchargement au terme duquel TikTok fait échouer une publication avec video_pull_failed ou photo_pull_failed.

24 hours

Fenêtre à l'origine de spam_risk_too_many_posts ; TikTok suggère de publier cette publication depuis son application mobile.

3 hours

Le plus souvent, easyCoexistence envoie un e-mail au titulaire pour une publication TikTok en échec sur un canal ; la publication attend sous « À traiter ».

Où TikTok indique-t-il pourquoi une publication a échoué ?

Après l'appel de publication, qui ne fait que lancer la tâche : son code 0 signifie que TikTok l'a acceptée, pas que la publication sera en ligne. GET /business/publish/status/ renvoie alors FAILED avec reason, et une application abonnée aux webhooks de publication reçoit post.publish.failed avec ce même motif et le publish_id. L'endpoint /v2/post/publish/status/fetch/ de la Content Posting API renvoie ce champ sous le nom fail_reason :

A failed post in /business/publish/status/, from TikTok's example
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "reason": "frame_rate_check_failed",
    "status": "FAILED"
  }
}

Que signifie chaque motif d'échec, et comment le corriger ?

Les motifs de TikTok, tels que décrits dans sa référence des événements de publication, avec la correction associée à chacun. Les quatre premiers sont des contrôles que TikTok effectue sur le fichier après le téléchargement, tous marqués comme non relançables. La table des échecs de TikTok indique encore 60 secondes comme durée maximale pour duration_check_failed, alors que l'endpoint vidéo en documente 600, ou la valeur propre au compte, max_video_post_duration_sec :

What TikTok foundThe fix
file_format_check_failedThe file's format breaks TikTok's specificationsMP4, MOV or WebM video; JPG, JPEG or WebP photos
duration_check_failedThe video's length is outside the limitsAt least 3 seconds, within the account's maximum
frame_rate_check_failedBelow 23 or above 60 frames per secondExport at 23 to 60 FPS
picture_size_check_failedHeight or width under 360 pixelsAt least 360 pixels on each side
video_pull_failed, photo_pull_failedThe download failed or ran past one hourA public URL that is not bandwidth-limited, then a retry
internalPart of TikTok's service was unavailableA retry
auth_removedThe owner removed the app's access mid-processingNo retry; the owner authorizes the app again
spam_risk_too_many_postsToo many API posts in the last 24 hoursPosting from the TikTok mobile app, or waiting
spam_risk_user_banned_from_postingThe account is banned from making new postsNo retry while the account cannot post
spam_risk_textThe caption reads as risky or spammyNew text before posting again
spam_riskHigh spam risk, such as attempts made too oftenNo retry, as TikTok advises
publish_cancelledThe upload or download was cancelledPublishing again if the post is still wanted

Quels échecs peuvent être relancés ?

Ceux causés par le téléchargement ou par TikTok lui-même. Les autres demandent un autre fichier ou une autre légende, une pause, ou rien du tout :

  • Relancer tel quel : internal, et video_pull_failed ou photo_pull_failed une fois l'URL publique et assez rapide.
  • Relancer avec un nouveau fichier : file_format_check_failed, duration_check_failed, frame_rate_check_failed et picture_size_check_failed.
  • Relancer avec une nouvelle légende : spam_risk_text.
  • Attendre, ou publier depuis l'application TikTok : spam_risk_too_many_posts.
  • Ne pas relancer : auth_removed et spam_risk, comme le conseille TikTok, ou spam_risk_user_banned_from_posting.

En quoi les échecs de la Content Posting API diffèrent-ils ?

Mêmes motifs, autre champ et autre endpoint, et refus intervenant avant le début du traitement. /v2/post/publish/status/fetch/ renvoie fail_reason, autorise 30 requêtes par minute et par token utilisateur, et ajoute un conseil de non-relance pour spam_risk_user_banned_from_posting et spam_risk_text. Plusieurs refus arrivent plutôt à l'appel d'initialisation, avec un HTTP 403 :

  • spam_risk_too_many_posts : le créateur a atteint le plafond quotidien de publications de l'API.
  • unaudited_client_can_only_post_to_private_accounts : une application non auditée a tenté de publier pour un compte public.
  • url_ownership_unverified : PULL_FROM_URL depuis un domaine ou un préfixe que l'application n'a pas vérifié.
  • privacy_level_option_mismatch : un privacy_level manquant ou hors des options du créateur.
  • reached_active_user_cap : l'application a atteint son quota quotidien d'utilisateurs actifs pour la publication.

Qu'est-ce qui échoue avant que TikTok ne voie la publication ?

Ce qu'easyCoexistence peut détecter en premier, avec un message propre plutôt qu'un motif TikTok. Le média d'une publication programmée est copié au moment de la programmation ; un lien qui renvoie une page web, une réponse 404, le mauvais type, ou un fichier de plus de 30 Mo pour une image ou de plus de 1 Go pour une vidéo est alors refusé. Les liens d'image se terminant par .png, .gif, .bmp, .heic, .avif ou .svg sont refusés avant tout envoi, un canal qui doit être reconnecté au moment de la publication échoue avec reconnect, et la suppression d'un canal annule ses publications programmées.

Comment easyCoexistence signale-t-il une publication TikTok en échec ?

Par sa file de publication, qui suit chaque publication TikTok après l'appel de publication, en consultant /business/publish/status/ environ toutes les 20 secondes jusqu'à PUBLISH_COMPLETE. Un statut FAILED fait échouer la publication, dont le message d'erreur mentionne le motif TikTok entre parenthèses, comme frame_rate_check_failed, et chaque échec porte un failure_kind :

  • refused : TikTok a répondu non, comme pour un statut FAILED et son motif.
  • uncertain : l'appel de publication n'a pas reçu de réponse claire, ou TikTok n'a pas confirmé dans les 2 heures, de sorte que la publication peut être en ligne (may_be_published).
  • reconnect : TikTok a refusé le token du compte, qui doit être reconnecté.
  • internal : easyCoexistence a échoué avant de transmettre la publication, donc rien n'est parti.

Comment retrouver et relancer une publication en échec ?

Le titulaire reçoit un e-mail pour un échec détecté en arrière-plan, au plus un par canal toutes les 3 heures, et l'URL d'événements d'une plateforme reçoit post.failed. La publication apparaît sous « À traiter » sur l'écran Publications, avec Relancer, Reconnecter et Ignorer, et list_scheduled_posts la renvoie à Claude ou à ChatGPT. retry_scheduled_post la publie de nouveau, immédiatement, à partir des fichiers conservés 7 jours après un échec ; lorsque may_be_published vaut true, consultez d'abord list_social_posts et ne passez confirm que si la publication est absente. Une publication qui demande un nouveau fichier ou une nouvelle légende est reprogrammée à la place.

Failed posts through MCP
list_scheduled_posts { "account_id": "<ACCOUNT_ID>", "status": ["failed"] }

retry_scheduled_post { "post_id": "<POST_ID>" }

// may_be_published is true and the post is not on the account
retry_scheduled_post { "post_id": "<POST_ID>", "confirm": true }

Erreurs courantes

  • Relancer un échec de contrôle avec le même fichier. TikTok marque les échecs de format, de durée, de fréquence d'images et de taille d'image comme non relançables.
  • Relancer spam_risk_too_many_posts tout de suite. TikTok compte les publications API sur 24 heures et suggère de publier depuis l'application mobile.
  • Relancer une publication marquée may_be_published sans vérifier. TikTok a peut-être déjà publié ; consultez les dernières publications du compte, sinon elle sera publiée deux fois.
  • Chercher fail_reason dans l'API for Business. Son endpoint de statut nomme le champ reason ; fail_reason appartient à la Content Posting API.
Faire cela avec EasyCoexistence

De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Que signifie picture_size_check_failed sur TikTok ?

TikTok a téléchargé la publication et constaté que son image mesure moins que le minimum de 360 pixels en hauteur et en largeur ; il faut un fichier plus grand, car TikTok marque cet échec comme non relançable.

Qu'est-ce que video_pull_failed ?

TikTok n'a pas pu télécharger la vidéo depuis son URL, ou pas dans le délai d'une heure. Vérifiez que l'URL est publique et non limitée en bande passante, puis relancez.

Combien de temps dure spam_risk_too_many_posts ?

TikTok compte les publications faites via l'API sur les dernières 24 heures, soit environ 15 par jour et par compte, et suggère en attendant de publier depuis l'application mobile TikTok.

easyCoexistence relance-t-il automatiquement une publication TikTok en échec ?

Non, pas après un statut FAILED de TikTok : la publication attend sous « À traiter », le titulaire reçoit un e-mail, et Relancer ou retry_scheduled_post l'envoie de nouveau.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le