ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Сбои публикации в 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, готовое к повтору.

reason

Поле /business/publish/status/ возвращается только при статусе FAILED, со значениями вроде frame_rate_check_failed.

fail_reason

Название этого же поля в Content Posting API в ответах /v2/post/publish/status/fetch/.

1 hour

Время ожидания загрузки, после которого TikTok завершает пост ошибкой video_pull_failed или photo_pull_failed.

24 hours

Окно, из-за которого возникает spam_risk_too_many_posts; TikTok советует опубликовать этот пост из мобильного приложения.

3 hours

Чаще всего 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:

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"
  }
}

Что означает каждая причина сбоя и как её исправить?

Причины TikTok, как их описывает справочник событий публикации постов, рядом с исправлением для каждой. Первые четыре: проверки файла, которые TikTok выполняет после загрузки; все они помечены как не подлежащие повтору. В таблице сбоев TikTok для duration_check_failed по-прежнему указано 60 секунд как максимальная длина видео, тогда как эндпоинт видео указывает 600 или значение 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

Какие сбои можно повторить?

Те, что вызваны загрузкой или самим 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, только если поста нет. Пост, которому нужен новый файл или подпись, вместо этого ставится в расписание заново.

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 }

Распространённые ошибки

  • Повтор проверки с тем же файлом. TikTok помечает сбои формата, длительности, частоты кадров и размера изображения как не подлежащие повтору.
  • Немедленный повтор spam_risk_too_many_posts. TikTok считает посты API за 24 часа и советует публиковать из мобильного приложения.
  • Повтор поста с пометкой may_be_published без проверки. TikTok мог уже опубликовать его; проверьте последние посты аккаунта, иначе он выйдет дважды.
  • Поиск fail_reason в API for Business. Его эндпоинт статуса называет поле reason, а fail_reason относится к Content Posting API.
Настройка с EasyCoexistence

От 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.

Читайте дальше

Как проверить статус публикации поста TikTok через APIКак отслеживать пост TikTok, опубликованный через API: share_id, статусы PROCESSING_DOWNLOAD, PUBLISH_COMPLETE и FAILED, ID постов и причины сбоя.Лимиты публикаций TikTok API: сколько постов в деньСколько постов TikTok API публикует с одного аккаунта: шесть в минуту и 15 в день для эндпоинтов видео и фото, и что происходит сверх лимита.Медиа-ссылки TikTok: проверенные домены и префиксы URLКак TikTok API for Business загружает медиа с проверенных доменов и префиксов URL: проверка через DNS TXT, файл подписи и эндпоинты подтверждения.Фото-посты и карусели TikTok через API: до 35 изображенийФото-посты TikTok через API: от 1 до 35 изображений JPEG или WebP до 20 МБ каждое, заголовок до 90 символов, подпись и обложка.Отправка видео в черновики создателя TikTok через APIКак API TikTok отправляет видео в черновики создателя: поток загрузки Content Posting API, upload_to_draft, is_draft и разрешение video.upload.Почему посты через TikTok API приватные: unaudited_client_can_only_post_to_private_accountsПочему Content Posting API держит посты приватными до аудита приложения, что значит ошибка 403 и чем API for Business отличается.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на