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

Фото-посты и карусели TikTok через API: до 35 изображений

API для бизнеса TikTok публикует фото-пост из 1–35 изображений, каждое в формате JPG, JPEG или WebP размером до 20 МБ и не больше 1080 на 1920 пикселей в любой ориентации. TikTok загружает их по проверенному URL. У поста может быть заголовок до 90 единиц кода UTF-16, подпись, уровень конфиденциальности и обложка.

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

35

Наибольшее число изображений, которое может содержать фото-пост через эндпоинт публикации фото TikTok.

20 MB

Наибольший размер файла каждого изображения в фото-посте; файл должен быть в формате JPG, JPEG или WebP.

1080 x 1920

Наибольшее разрешение изображения в пикселях для фото-поста, или 1920 x 1080 для горизонтального изображения.

90

Количество единиц кода UTF-16, которое может содержать заголовок фото-поста; подпись вмещает до 4 000.

Что входит в фото-пост?

Один вызов POST /business/photo/publish/ передаёт изображения и данные поста:

  • photo_images: до 35 URL изображений на проверенном домене или префиксе URL.
  • photo_cover_index: номер изображения, которое используется как обложка, с отсчётом от 0; это значение по умолчанию.
  • post_info.title: до 90 единиц кода UTF-16.
  • post_info.caption: до 4 000 единиц кода UTF-16, с #хештегами и не более чем 30 @упоминаниями.
  • post_info.privacy_level: кто может видеть пост, в пределах вариантов, которые допускают настройки аккаунта.
  • post_info.disable_comment: отключает комментарии к посту.

Какие файлы изображений подходят?

JPG, JPEG или WebP, каждый до 20 МБ и не больше 1080 на 1920 пикселей, либо 1920 на 1080 для горизонтального изображения. TikTok проверяет формат только после загрузки файла, поэтому неподдерживаемый формат завершится позже с ошибкой file_format_check_failed. publish_tiktok_post отклоняет ссылки, оканчивающиеся на .png, .gif, .bmp, .heic, .avif или .svg, до отправки чего-либо.

Чем отличаются заголовок и подпись?

Это отдельные поля с отдельными ограничениями. Заголовок содержит до 90 единиц кода UTF-16. Подпись представляет собой описание поста, до 4 000 единиц, и может содержать #хештеги и @упоминания взаимных подписчиков аккаунта, не более 30. Оба поля считаются в единицах кода UTF-16, поэтому эмодзи может занимать две и более. publish_tiktok_post принимает их как title и caption.

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

privacy_level определяет, кто его видит: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR или SELF_ONLY, в пределах вариантов, которые GET /business/video/settings/ возвращает для аккаунта. TikTok предлагает PUBLIC_TO_EVERYONE только для открытых аккаунтов, и именно этот уровень задаёт publish_tiktok_post. Комментарии включены, если disable_comment не равен true. Аккаунт, который не принимает комментарии ни от кого, допускает только true.

Что происходит после вызова?

TikTok возвращает share_id и загружает изображения в фоновом режиме. get_tiktok_publish_status принимает этот share_id и показывает PROCESSING_DOWNLOAD, пока TikTok забирает изображения, PUBLISH_COMPLETE, когда пост прошёл модерацию, или FAILED с причиной, например photo_pull_failed. TikTok ограничивает фото-посты через этот эндпоинт шестью в минуту и 15 в день на аккаунт.

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

  • Отправка PNG-изображений. Фото-посты TikTok принимают только JPG, JPEG или WebP, поэтому сначала конвертируйте файлы перед публикацией.
  • Подсчёт заголовка по видимым символам. TikTok считает единицы кода UTF-16, поэтому заголовок с эмодзи достигнет 90 быстрее.
  • Изображения больше 1080 на 1920 пикселей. Это наибольшее разрешение для фото-постов TikTok, поэтому сначала уменьшите более крупные изображения.
  • Обложка не на первом месте. publish_tiktok_post использует первое изображение как обложку.
Настройка с EasyCoexistence

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

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

Сколько фото может быть в посте TikTok через API?

До 35, каждое в формате JPG, JPEG или WebP размером не более 20 МБ.

Могут ли фото-посты TikTok использовать PNG?

Нет. Фото-эндпоинт принимает JPG, JPEG и WebP, а TikTok отклоняет PNG после загрузки с ошибкой file_format_check_failed.

Какой может быть длина заголовка фото-поста?

До 90 единиц кода UTF-16. Подпись задаётся отдельным полем и содержит до 4 000 единиц.

Какое изображение становится обложкой?

То, на которое указывает photo_cover_index, с отсчётом от 0. publish_tiktok_post оставляет значение 0, поэтому обложкой будет первое изображение.

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

Требования к видео для TikTok API: формат, размер и длинаВидео для API for Business от TikTok: MP4, MOV или WebM, от 3 до 600 секунд, до 1 ГБ, 23–60 FPS, по URL, который TikTok загружает сам.Ограничения подписи TikTok через API: длина, хэштеги и упоминанияДлина подписи видео и фото в TikTok через API для Business, работа хэштегов и упоминаний, переносы строк и лимиты фотопостов.Лимиты публикаций TikTok API: сколько постов в деньСколько постов TikTok API публикует с одного аккаунта: шесть в минуту и 15 в день для эндпоинтов видео и фото, и что происходит сверх лимита.Как проверить статус публикации поста TikTok через APIКак отслеживать пост TikTok, опубликованный через API: share_id, статусы PROCESSING_DOWNLOAD, PUBLISH_COMPLETE и FAILED, ID постов и причины сбоя.Планирование публикаций в TikTok через APIКак планируются видео и фотопубликации TikTok через API: очередь, которая публикует в заданные дату и время, с правилами TikTok на момент отправки.

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

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

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

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