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

Требования к видео для TikTok API: формат, размер и длина

Видео, опубликованное через API for Business от TikTok, должно быть файлом MP4, MOV или WebM размером до 1 ГБ и длиной от 3 до 600 секунд (или меньше, если у аккаунта лимит ниже). Минимальные высота и ширина кадра составляют 360 пикселей, частота кадров от 23 до 60 кадров в секунду. TikTok сам скачивает файл, поэтому URL видео должен находиться на домене или префиксе URL, право на который приложение для публикации подтвердило.

easyCoexistence публикует видео TikTok через publish_tiktok_post из Claude, ChatGPT или собственного кода: передайте HTTPS-ссылку на файл, подпись и то, включены ли комментарии.

1 GB

Самый большой видеофайл, который принимает эндпоинт публикации, в контейнере MP4, MOV или WebM.

3 to 600 s

Минимальная и максимальная длительность видео, которые TikTok указывает для публикации через API.

360 px

Минимальные высота и ширина опубликованного видео; также нужны от 23 до 60 кадров в секунду.

30 min

Минимальный срок, в течение которого TikTok рекомендует держать URL видео действительным, так как TikTok сам скачивает файл.

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

Спецификация TikTok для видео, опубликованного через POST /business/video/publish/. TikTok проверяет его после того, как скачает файл:

  • Контейнер: MP4, MOV или WebM.
  • Размер: до 1 ГБ.
  • Длина: не менее 3 секунд и не более 600, или меньше, если собственный лимит аккаунта ниже.
  • Изображение: не менее 360 пикселей по высоте и ширине.
  • Частота кадров: от 23 до 60 кадров в секунду.

Может ли каждый аккаунт публиковать видео длиной 600 секунд?

Не всегда. GET /business/video/settings/ возвращает max_video_post_duration_sec, максимальную длительность видео, которое аккаунт может опубликовать сам. Более длинное видео не публикуется. Тот же запрос показывает, разрешены ли в настройках аккаунта комментарии, Duet и Stitch для его публикаций. С easyCoexistence ваш код читает эти настройки с токеном и business_id из get_social_credentials.

Где должно находиться видео?

По публичному URL по протоколу HTTP или HTTPS, который TikTok загружает сам. TikTok рекомендует, чтобы ссылка оставалась действительной не менее 30 минут. С 16 ноября 2023 года TikTok также не принимает непроверенные URL видео: разработчик подтверждает владение доменом с помощью DNS-записи TXT или префиксом URL с файлом подписи, размещённым под ним. После этого публиковать можно любой URL, который начинается с подтверждённого префикса.

Как easyCoexistence передаёт ваш файл в TikTok?

Через собственный подтверждённый префикс URL. publish_tiktok_post принимает вашу HTTPS-ссылку, передаёт TikTok подписанную ссылку на медиамаршрут easyCoexistence, которая истекает через 6 часов, и получает файл по вашей ссылке в момент, когда TikTok его скачивает, не сохраняя его по пути. Ваша ссылка не требует собственного подтверждения, но должна быть HTTPS и открываться без входа в систему до публикации поста.

Что происходит после того, как TikTok скачает видео?

TikTok проверяет файл и перекодирует его. Опубликованный пост может показываться в более низком разрешении и битрейте, чем оригинал, в зависимости от устройства и сети зрителя. Файл, который нарушает правило, не публикуется: его статус становится FAILED с причиной, например file_format_check_failed, frame_rate_check_failed или picture_size_check_failed. TikTok помечает такие ошибки как не подлежащие повторной попытке с тем же файлом.

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

  • Отправка ссылки http://. publish_tiktok_post принимает только HTTPS-ссылки и отклоняет вызов до того, как его увидит TikTok.
  • Экспорт ниже 23 кадров в секунду. TikTok скачивает файл, находит частоту кадров слишком низкой и завершает публикацию с ошибкой frame_rate_check_failed.
  • Предположение, что 600 секунд доступны каждому аккаунту. Видео длиннее max_video_post_duration_sec аккаунта не опубликуется, поэтому сначала проверьте этот параметр.
  • Удаление файла сразу после вызова. TikTok скачивает его после принятия запроса, а если ссылка перестала работать, публикация завершится с ошибкой video_pull_failed.
Настройка с EasyCoexistence

Сервис отдаёт файл TikTok через собственный подтверждённый медиамаршрут. От US$ 9 до US$ 0,75 за подключение в месяц, стоимость снижается по мере добавления подключений; первые 3 дня бесплатный пробный период.

Часто задаваемые вопросы

Какие форматы видео принимает API TikTok?

Файлы MP4, MOV и WebM размером до 1 ГБ, длиной от 3 до 600 секунд, не менее 360 пикселей по каждой стороне и с частотой от 23 до 60 кадров в секунду.

Можно ли загрузить видеофайл с моего компьютера?

Не через этот эндпоинт. Он принимает video_url и скачивает файл по этой ссылке, поэтому сначала видео нужна публичная HTTPS-ссылка.

Зачем TikTok нужен подтверждённый URL?

TikTok говорит, что подтверждение владения URL помогает соблюдать его правила в отношении контента, защищённого авторским правом, и безопасности пользователей. С 16 ноября 2023 года он не принимает непроверенные URL видео.

Снижает ли TikTok качество видео, опубликованного через API?

Может. TikTok перекодирует видео, и пост может показываться в более низком разрешении и битрейте, чем файл, в зависимости от устройства и соединения зрителя.

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

Фото-посты и карусели TikTok через API: до 35 изображенийФото-посты TikTok через API: от 1 до 35 изображений JPEG или WebP до 20 МБ каждое, заголовок до 90 символов, подпись и обложка.Ограничения подписи TikTok через API: длина, хэштеги и упоминанияДлина подписи видео и фото в TikTok через API для Business, работа хэштегов и упоминаний, переносы строк и лимиты фотопостов.Лимиты публикаций TikTok API: сколько постов в деньСколько постов TikTok API публикует с одного аккаунта: шесть в минуту и 15 в день для эндпоинтов видео и фото, и что происходит сверх лимита.Как проверить статус публикации поста TikTok через APIКак отслеживать пост TikTok, опубликованный через API: share_id, статусы PROCESSING_DOWNLOAD, PUBLISH_COMPLETE и FAILED, ID постов и причины сбоя.TikTok API for Business против Content Posting APIПочему API for Business от TikTok, а не developers.tiktok.com: комментарии и их вебхук, инсайты, какие аккаунты подключаются и как обновляются токены.Ошибка TikTok 40002: ошибка параметра в запросеОшибка TikTok 40002: параметр запроса отсутствует, записан неверно или не разрешён. Как читать сообщение TikTok и какие правила Accounts API проверить.

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

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

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

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