Настройки публикации TikTok через API: приватность, комментарии, Duet и Stitch
API для бизнеса TikTok принимает настройки публикации в вызове publish, в основном внутри post_info. Для видео поддерживаются disable_comment, disable_duet и disable_stitch, обложка через thumbnail_offset или custom_thumbnail_url, маркировки is_brand_organic, is_branded_content и is_ai_generated. У фотопостов есть privacy_level, disable_comment, те же маркировки бренда и auto_add_music. GET /business/video/settings/ возвращает значения, которые разрешены для каждого аккаунта.
easyCoexistence публикует видео и фотопосты TikTok через publish_tiktok_post из Claude, ChatGPT или вашего кода, с подписью, заголовком фотопоста и включёнными или выключенными комментариями, а get_social_credentials даёт вашему коду токен, чтобы читать разрешённые настройки аккаунта.
Варианты приватности фотопостов публичного аккаунта: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS и SELF_ONLY.
Уровень приватности, который получает закрытый аккаунт вместо PUBLIC_TO_EVERYONE: видно только его подписчикам.
По умолчанию disable_comment, disable_duet и disable_stitch равны false, поэтому комментарии, Duet и Stitch остаются включёнными, пока не заданы иначе.
Пользовательское изображение обложки видео должно быть не менее 360 x 360 пикселей и не больше 20 МБ.
Маркировка is_branded_content применяется и имеет приоритет, если is_brand_organic тоже равно true.
Обязательное поле post_info фотопоста, ограниченное вариантами, которые возвращает GET /business/video/settings/ для аккаунта.
Какие настройки принимает каждый эндпоинт публикации?
/business/video/publish/ и /business/photo/publish/ имеют общие настройки и отличаются в других. Большинство находится внутри post_info, а custom_thumbnail_url и photo_cover_index располагаются на верхнем уровне тела запроса. Ниже они показаны рядом, как их перечисляет справочник TikTok. Там, где эндпоинт ничего не описывает для настройки, стоит «Нет поля»:
| Video post | Photo post | |
|---|---|---|
| Who sees it | No privacy field: the endpoint publishes public video posts | privacy_level, required |
| Comments | disable_comment | disable_comment |
| Duet and Stitch | disable_duet, disable_stitch | No field |
| Cover | custom_thumbnail_url or thumbnail_offset | photo_cover_index |
| Brand labels | is_brand_organic, is_branded_content | is_brand_organic, is_branded_content |
| AI label | is_ai_generated | No field |
| Music | music_sound_info, video_original_sound_volume | auto_add_music, music_sound_info |
| Location | location_id with location_name | location_id with location_name |
| Draft | upload_to_draft | is_draft |
Что разрешено аккаунту?
GET /business/video/settings/ с business_id возвращает ограничения аккаунта на его публикации. Прочитайте его перед публикацией, поскольку TikTok принимает только перечисленные в нём значения:
privacy_level_options:PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDSиSELF_ONLYдля публичного аккаунта;FOLLOWER_OF_CREATOR,MUTUAL_FOLLOW_FRIENDSиSELF_ONLYдля закрытого.comment_disabled: true, когда аккаунт не принимает комментарии ни от кого, и тогдаdisable_commentпринимает только true.duet_disabledиstitch_disabled: true, когда аккаунт разрешает Duet или Stitch только в режиме «Только вы» либо является закрытым; соответствующий переключатель тогда принимает только true.max_video_post_duration_sec: самое длинное видео, которое аккаунт может опубликовать; более длинное завершится ошибкой.
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/settings/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"comment_disabled": false,
"duet_disabled": false,
"max_video_post_duration_sec": 600,
"privacy_level_options": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
"stitch_disabled": false
}
}Кто может видеть публикацию?
У фотопоста это privacy_level, который вы отправляете: PUBLIC_TO_EVERYONE для людей в TikTok и вне его, MUTUAL_FOLLOW_FRIENDS для подписчиков, на которых аккаунт подписан в ответ, FOLLOWER_OF_CREATOR для подписчиков закрытого аккаунта, или SELF_ONLY. У эндпоинта видео поля приватности нет, так как он публикует публичные видео. Пост с настройкой «Друзья» или «Только вы» также нельзя посмотреть по его embed_url.
Как работают комментарии, Duet и Stitch?
Каждый из них является переключателем, который при значении true выключает функцию. disable_comment есть у обоих эндпоинтов; disable_duet и disable_stitch есть только у видео. По умолчанию все они равны false, что оставляет функцию включённой в рамках собственных настроек приватности аккаунта. Аккаунт, который не принимает комментарии ни от кого, или ограничивает Duet или Stitch режимом «Только вы», может публиковать только с переключателем, установленным в true.
Как выбирается обложка?
Для видео есть два способа. post_info.thumbnail_offset выбирает кадр по времени в миллисекундах, по умолчанию 0, с округлением до ближайшего кадра; время за концом видео отправляет вебхук об ошибке, и видео не публикуется. custom_thumbnail_url на верхнем уровне тела запроса задаёт изображение, и тогда TikTok игнорирует смещение. У фотопоста photo_cover_index выбирает одно из изображений, отсчёт ведётся с 0.
- Пользовательская обложка: JPG, JPEG, WebP или PNG, до 20 МБ.
- Размер: от 360 x 360 пикселей до 1080 x 1920 или 1920 x 1080.
- Расположение: домен или префикс URL, подтверждённый для приложения, как и само видео.
Что означают маркировки бренда?
Пометки, которые TikTok показывает на публикации. is_brand_organic со значением true помечает её как «Рекламный контент» для публикаций, которые продвигают собственный бизнес аккаунта. is_branded_content со значением true помечает её как «Платное партнёрство» для публикаций, сделанных в платном партнёрстве с брендом, и имеет приоритет, если оба равны true. У видео с is_branded_content параметр tto_invite_link может привязать публикацию к кампании TikTok One Creator Marketplace, к которой присоединился аккаунт.
Какие другие параметры есть в post_info?
Ещё несколько, каждый описан в эндпоинте, который его принимает:
is_ai_generated, для видео: помечает публикацию как созданную автором с пометкой ИИ-генерации; после публикации изменить нельзя.location_idиlocation_name: метка места, найденная через GET /business/publish/location/.music_sound_info: коммерческий звук по ID; для видео также его громкость от 0 до 100 и начало и конец в миллисекундах.auto_add_music, для фотопостов: добавляет рекомендуемую музыку, которую позже можно изменить в приложении TikTok.upload_to_draftилиis_draft: отправляет публикацию с видео во входящие автора как черновик с разрешением video.upload.is_ads_only, для видео: публикует пост, видимый только в рекламе, который не остаётся в профиле.
Какие настройки задаёт publish_tiktok_post?
Три берутся из вашего запроса: подпись, заголовок фотопоста и disable_comment. easyCoexistence отправляет is_brand_organic и is_branded_content как false, публикует фотопосты как PUBLIC_TO_EVERYONE с первым изображением в качестве обложки и не передаёт остальные настройки видео, поэтому применяются значения TikTok по умолчанию: disable_duet и disable_stitch равны false, thumbnail_offset равен 0, is_ai_generated равен false.
Как отправить остальные настройки?
Из вашего кода, с токеном и business_id аккаунта из get_social_credentials, по путям Business API под business/. GET к business/video/settings/ читает ограничения аккаунта. POST к business/video/publish/ или business/photo/publish/ может содержать полное описанное тело; оно уходит в TikTok как есть, включая URL медиа, поэтому они должны находиться на домене или префиксе URL, подтверждённом для приложения. publish_tiktok_post представляет собой вызов, который направляет вашу ссылку через подтверждённый медиамаршрут easyCoexistence.
GET https://business-api.tiktok.com/open_api/v1.3/business/video/settings/?business_id=<BUSINESS_ID>
Access-Token: <ACCESS_TOKEN>Распространённые ошибки
- Ожидание, что privacy_level работает для видео. Эндпоинт видео публикует публичные посты, а в его справочнике нет поля приватности; privacy_level принимают фотопосты.
- Включение комментариев для аккаунта, который их не принимает. Когда comment_disabled равно true, TikTok принимает disable_comment только как true.
- Задание thumbnail_offset за концом видео. TikTok отправляет вебхук об ошибке, и видео не публикуется.
- Отправка PUBLIC_TO_EVERYONE для закрытого аккаунта. Его privacy_level_options перечисляют FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS и SELF_ONLY.
От US$ 9 до US$ 0,75 за подключение в месяц, снижается по мере добавления подключений; первые 3 дня бесплатно.
Часто задаваемые вопросы
Можно ли опубликовать закрытое видео в TikTok через API?
Не через эндпоинт видео, который публикует публичные посты. Фотопосты принимают privacy_level, включая SELF_ONLY, а видео можно отправить во входящие автора как черновик через upload_to_draft.
Как выключить Duet и Stitch через API?
Задайте post_info.disable_duet и post_info.disable_stitch равными true в /business/video/publish/. Если аккаунт уже ограничивает их, TikTok принимает только true.
Можно ли добавить метку места через API TikTok?
Да. post_info принимает location_id с location_name для метки места, найденной через GET /business/publish/location/.
В чём разница между is_brand_organic и is_branded_content?
is_brand_organic добавляет метку «Рекламный контент» для собственного бизнеса аккаунта; is_branded_content добавляет метку «Платное партнёрство» и имеет приоритет, если оба равны true.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на