Сбои публикации в TikTok: spam_risk_too_many_posts, picture_size_check_failed и другие причины
TikTok называет причину сбоя поста в поле reason эндпоинта статуса API for Business или в поле fail_reason Content Posting API. Ошибки проверки, например picture_size_check_failed, означают, что файл не соответствует правилу формата и его нужно изменить. video_pull_failed значит, что TikTok не смог скачать файл в течение часа. spam_risk_too_many_posts означает слишком много публикаций через API за 24 часа. Сбой с пометкой internal можно просто повторить.
easyCoexistence отслеживает каждый пост в TikTok, который публикует, до тех пор, пока TikTok не завершит его или не отклонит, для Claude, ChatGPT или вашей собственной платформы: сбой приходит с причиной TikTok по письму, на экране «Посты» и как событие post.failed, готовое к повтору.
Поле /business/publish/status/ возвращается только при статусе FAILED, со значениями вроде frame_rate_check_failed.
Название этого же поля в Content Posting API в ответах /v2/post/publish/status/fetch/.
Время ожидания загрузки, после которого TikTok завершает пост ошибкой video_pull_failed или photo_pull_failed.
Окно, из-за которого возникает spam_risk_too_many_posts; TikTok советует опубликовать этот пост из мобильного приложения.
Чаще всего easyCoexistence пишет владельцу о сбоях постов в одном канале; пост ждёт в разделе «Требует внимания».
Где TikTok сообщает, почему пост не был опубликован?
После вызова публикации, который лишь запускает задачу: код 0 означает, что TikTok принял её, но не то, что пост выйдет. GET /business/publish/status/ затем возвращает FAILED с полем reason, а приложение, подписанное на вебхуки публикации, получает post.publish.failed с той же причиной и publish_id. Эндпоинт /v2/post/publish/status/fetch/ в Content Posting API возвращает это поле как fail_reason:
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"reason": "frame_rate_check_failed",
"status": "FAILED"
}
}Что означает каждая причина сбоя и как её исправить?
Причины TikTok, как их описывает справочник событий публикации постов, рядом с исправлением для каждой. Первые четыре: проверки файла, которые TikTok выполняет после загрузки; все они помечены как не подлежащие повтору. В таблице сбоев TikTok для duration_check_failed по-прежнему указано 60 секунд как максимальная длина видео, тогда как эндпоинт видео указывает 600 или значение max_video_post_duration_sec самого аккаунта:
| What TikTok found | The fix | |
|---|---|---|
| file_format_check_failed | The file's format breaks TikTok's specifications | MP4, MOV or WebM video; JPG, JPEG or WebP photos |
| duration_check_failed | The video's length is outside the limits | At least 3 seconds, within the account's maximum |
| frame_rate_check_failed | Below 23 or above 60 frames per second | Export at 23 to 60 FPS |
| picture_size_check_failed | Height or width under 360 pixels | At least 360 pixels on each side |
| video_pull_failed, photo_pull_failed | The download failed or ran past one hour | A public URL that is not bandwidth-limited, then a retry |
| internal | Part of TikTok's service was unavailable | A retry |
| auth_removed | The owner removed the app's access mid-processing | No retry; the owner authorizes the app again |
| spam_risk_too_many_posts | Too many API posts in the last 24 hours | Posting from the TikTok mobile app, or waiting |
| spam_risk_user_banned_from_posting | The account is banned from making new posts | No retry while the account cannot post |
| spam_risk_text | The caption reads as risky or spammy | New text before posting again |
| spam_risk | High spam risk, such as attempts made too often | No retry, as TikTok advises |
| publish_cancelled | The upload or download was cancelled | Publishing again if the post is still wanted |
Какие сбои можно повторить?
Те, что вызваны загрузкой или самим TikTok. Остальным нужны другой файл или подпись, пауза либо ничего:
- Повторить как есть: internal, а также
video_pull_failedилиphoto_pull_failed, когда URL публичен и отвечает достаточно быстро. - Повторить с новым файлом:
file_format_check_failed,duration_check_failed,frame_rate_check_failedиpicture_size_check_failed. - Повторить с новой подписью:
spam_risk_text. - Подождать или опубликовать из приложения TikTok:
spam_risk_too_many_posts. - Не повторять:
auth_removedиspam_risk, как советует TikTok, а такжеspam_risk_user_banned_from_posting.
Чем отличаются сбои Content Posting API?
Те же причины, другое поле и эндпоинт, а также отказы, которые происходят до начала обработки. /v2/post/publish/status/fetch/ возвращает fail_reason, допускает 30 запросов в минуту на пользовательский токен и добавляет рекомендацию не повторять для spam_risk_user_banned_from_posting и spam_risk_text. Некоторые отказы приходят на этапе вызова init с HTTP 403:
spam_risk_too_many_posts: креатор достиг ежедневного лимита публикаций через API.unaudited_client_can_only_post_to_private_accounts: непроверенное приложение пыталось опубликовать пост для публичного аккаунта.url_ownership_unverified:PULL_FROM_URLс домена или префикса, который приложение не подтвердило.privacy_level_option_mismatch:privacy_levelотсутствует или не входит в варианты креатора.reached_active_user_cap: приложение достигло дневной квоты активных пользователей для публикации.
Что сбоит до того, как TikTok получит пост?
То, что easyCoexistence может поймать первым, с собственным сообщением вместо причины TikTok. Медиа запланированного поста копируется в момент планирования, и ссылка, которая возвращает веб-страницу, ошибку 404, не тот тип или файл больше 30 МБ для изображения либо 1 ГБ для видео, отклоняется уже тогда. Ссылки на фото с расширениями .png, .gif, .bmp, .heic, .avif или .svg отклоняются до отправки, канал, которому нужно переподключение на момент публикации, завершается сбоем reconnect, а удаление канала отменяет его запланированные посты.
Как easyCoexistence сообщает о сбое публикации в TikTok?
Через очередь публикации, которая следит за каждым постом TikTok после вызова публикации, проверяя /business/publish/status/ примерно каждые 20 секунд до PUBLISH_COMPLETE. Статус FAILED завершает пост ошибкой, в которой причина TikTok указана в скобках, например frame_rate_check_failed, а каждый сбой несёт failure_kind:
- refused: TikTok ответил отказом, например при статусе FAILED и его причине.
- uncertain: на вызов публикации не пришёл ясный ответ, либо TikTok не подтвердил публикацию в течение 2 часов, поэтому пост может быть уже опубликован (
may_be_published). - reconnect: TikTok отклонил токен аккаунта, и аккаунту нужен новый вход.
- internal: easyCoexistence завершился сбоем до передачи поста, поэтому ничего не ушло.
Как найти и повторить неудачный пост?
Владелец получает письмо о сбое, обнаруженном в фоне, не чаще одного раза в 3 часа на канал, а URL для событий платформы получает post.failed. Пост показывается в разделе «Требует внимания» на экране «Посты» с кнопками «Повторить», «Переподключить» и «Отклонить», а list_scheduled_posts возвращает его в Claude или ChatGPT. retry_scheduled_post публикует его снова, сейчас, из файлов, которые хранятся 7 дней после сбоя; если may_be_published равно true, сначала проверьте list_social_posts и передайте confirm, только если поста нет. Пост, которому нужен новый файл или подпись, вместо этого ставится в расписание заново.
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 }Распространённые ошибки
- Повтор проверки с тем же файлом. TikTok помечает сбои формата, длительности, частоты кадров и размера изображения как не подлежащие повтору.
- Немедленный повтор spam_risk_too_many_posts. TikTok считает посты API за 24 часа и советует публиковать из мобильного приложения.
- Повтор поста с пометкой may_be_published без проверки. TikTok мог уже опубликовать его; проверьте последние посты аккаунта, иначе он выйдет дважды.
- Поиск fail_reason в API for Business. Его эндпоинт статуса называет поле reason, а fail_reason относится к Content Posting API.
От US$ 9 до US$ 0,75 за подключение в месяц, со снижением по мере добавления подключений, с бесплатным пробным периодом в 3 дня.
Часто задаваемые вопросы
Что означает picture_size_check_failed в TikTok?
TikTok скачал пост и обнаружил, что изображение меньше минимума в 360 пикселей по высоте и ширине; нужен файл большего размера, поскольку TikTok помечает сбой как не подлежащий повтору.
Что такое video_pull_failed?
TikTok не смог скачать видео по его URL или не уложился в часовой лимит ожидания. Проверьте, что URL публичен и не ограничен по пропускной способности, затем повторите попытку.
Сколько длится spam_risk_too_many_posts?
TikTok считает посты, созданные через API за последние 24 часа, примерно 15 в день на аккаунт, и пока советует публиковать из мобильного приложения TikTok.
Повторяет ли easyCoexistence неудачный пост TikTok самостоятельно?
Нет. После статуса FAILED от TikTok пост ждёт в разделе «Требует внимания», владелец получает письмо, а отправить снова можно кнопкой «Повторить» или через retry_scheduled_post.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на