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

Добавление музыки в публикации TikTok через API

API for Business от TikTok добавляет музыку из Commercial Music Library: post_info.music_sound_info принимает music_sound_id трека для видео и фотопубликаций, а для видео также громкость трека, его начало и конец в миллисекундах и громкость собственного звука видео. Фотопубликации могут получить и auto_add_music для рекомендуемой музыки. ID треков берутся из GET /discovery/cml/trending_list/.

easyCoexistence публикует видео и фотопубликации TikTok через publish_tiktok_post из Claude, ChatGPT или собственного кода, сразу или в заданное время до 90 дней вперёд, а видео уходит с саундтреком, подмешанным в его файл.

100

Самые популярные треки, которые возвращает /discovery/cml/trending_list/, все заранее одобрены для органического контента и рекламных креативов.

0 to 100

Диапазон music_sound_volume и video_original_sound_volume; через API оба по умолчанию равны 0, а приложение TikTok начинает с 50.

1 million

Треки Commercial Music Library TikTok, заранее одобренной глобальной библиотеки, которую бизнес использует для коммерческой деятельности в TikTok.

TikTok only

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

DIRECT_POST

Единственный post_mode, в котором эндпоинт фото Content Posting API применяет auto_add_music, на developers.tiktok.com.

Какие поля музыки принимают публикующие эндпоинты TikTok?

Оба эндпоинта несут музыку внутри post_info, в объекте music_sound_info, и называют трек по его ID из Commercial Music Library. В остальном они различаются: эндпоинт видео добавляет настройки микширования, а эндпоинт фото добавляет переключатель, который позволяет TikTok выбрать музыку. Ниже оба списка рядом, как их приводят справочники TikTok:

Video postPhoto post
The trackmusic_sound_info.music_sound_idmusic_sound_info.music_sound_id
Track volumemusic_sound_volume, 0 to 100, required with a trackNo field
Part of the trackmusic_sound_start and music_sound_end, in millisecondsNo field
The video's own soundvideo_original_sound_volume, 0 to 100Not applicable
Recommended musicNo fieldauto_add_music, false by default
As a draftupload_to_draft drops the rest of post_infois_draft keeps only the title and caption

Как добавить трек к видео?

Отправьте music_sound_info внутри post_info в POST /business/video/publish/. Когда объект есть, music_sound_id и music_sound_volume обязательны. music_sound_start и music_sound_end задают часть трека в миллисекундах: по умолчанию от начала трека до полной длины видео, так что видео в 2 секунды берёт первые 2 000 миллисекунд трека. Задайте и video_original_sound_volume, если важен собственный звук видео, так как по умолчанию он равен 0:

A 15-second video with seconds 15 to 30 of a library track
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "business_id": "<OPEN_ID>",
    "video_url": "https://media.example.com/tiktok/launch.mp4",
    "post_info": {
      "caption": "Our new blend is here #coffee",
      "is_brand_organic": false,
      "is_branded_content": false,
      "music_sound_info": {
        "music_sound_id": "<SONG_CLIP_ID>",
        "music_sound_volume": 40,
        "music_sound_start": 15000,
        "music_sound_end": 30000,
        "video_original_sound_volume": 80
      }
    }
  }'

Откуда берутся ID треков?

Из GET /discovery/cml/trending_list/, эндпоинта Discovery API, который принимает токен доступа аккаунта TikTok и business_id, тогда как эндпоинты хэштегов Discovery принимают токен рекламодателя. Справочник TikTok относит его к разрешению Discovery в Creative Management. Он возвращает до 100 популярных треков, у каждого есть название, исполнитель, длительность, ранг, жанры, preview_url, который не истекает, и до 30 дней trending_history. full_duration_song_clip и trending_song_clip содержат каждый song_clip_id, значение, которое TikTok называет для music_sound_id:

  • genre: ALL по умолчанию или одно из более чем 100 значений, например POP, LATIN, LO-FI или SERTANEJO.
  • country_code: US по умолчанию. date_range: 1DAY, по умолчанию 7DAY, 30DAY или 90DAY.
  • /discovery/cml/video_list/: 20 самых популярных видео в тренде, которые используют трек, по его commercial_music_id и country_code.
Popular pop tracks in Brazil over the last 7 days
curl -G 'https://business-api.tiktok.com/open_api/v1.3/discovery/cml/trending_list/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'genre=POP' \
  --data-urlencode 'country_code=BR' \
  --data-urlencode 'date_range=7DAY'

Как фотопубликации получают музыку?

Двумя способами на POST /business/photo/publish/. auto_add_music со значением true заставляет TikTok добавить рекомендуемую музыку, которую владелец позже может сменить в приложении TikTok. music_sound_info.music_sound_id называет конкретный трек библиотеки, и у фото нет полей громкости, начала и конца. На developers.tiktok.com у эндпоинта фото Content Posting API есть собственный auto_add_music, который применяется только когда post_mode равен DIRECT_POST, а его эндпоинт прямой публикации видео не документирует поля музыки.

Что Commercial Music Library значит для бизнес-аккаунтов?

Это музыка, которую им разрешено использовать. Справочный центр TikTok для бизнеса описывает библиотеку как заранее одобренную глобальную коллекцию из 1 миллиона песен, сообщает, что бизнес не может использовать общую музыкальную библиотеку в коммерческих целях, и направляет к Commercial Music Library для органического контента, включая дуэты, реакции и стичи, видеорекламы и брендированный контент. В бизнес-аккаунте «Добавить звук» в приложении показывает только звуки библиотеки, и API проводит ту же границу, так как music_sound_id принимает ID из библиотеки.

Что API не может делать с музыкой?

Некоторые вещи лежат вне его полей, как их описывают справочники TikTok:

  • Назвать звук из общей библиотеки TikTok: music_sound_id принимает ID из Commercial Music Library.
  • Искать библиотеку по названию: /discovery/cml/trending_list/ фильтрует популярные треки по жанру, стране и периоду.
  • Сохранить музыку в черновике: upload_to_draft заставляет TikTok игнорировать остальной post_info, а is_draft оставляет только название и подпись.
  • Использовать свой трек в органической публикации: /file/music/upload/ добавляет музыку для рекламных креативов под advertiser_id, а уведомление TikTok там оставляет ответственность за авторские права на загрузившем.

Какие есть обходные пути?

Три, каждый опирается на то, что документируют справочники TikTok, плюс один риск, который стоит взвесить:

  • Смешайте музыку в файл. Ограничения TikTok описывают видео как аудиовизуальный контент, поэтому подмешанный саундтрек уходит вместе с ним; используйте аудио, на которое у вас есть права.
  • Отправьте черновик. С upload_to_draft или is_draft и разрешением video.upload публикация попадает во входящие автора в TikTok, чтобы отредактировать и опубликовать её в приложении.
  • Пусть TikTok выберет на фотопубликациях. auto_add_music добавляет рекомендуемую музыку, а владелец может заменить её позже в приложении TikTok.
  • Риск со смешанным звуком: справочник списка публикаций TikTok называет нарушения авторских прав на музыку среди вероятных причин, по которым публикация фильтруется.

Как узнать, принёс ли звук просмотры?

Через impression_sources, поле /business/video/list/, которое ранжирует, откуда зрители нашли публикацию. Одно из его значений: Sound, просмотры со страниц звуков. Для него нужно разрешение video.insights, и, как и другие показатели, данные приходят с опозданием на 24–48 часов. Через easyCoexistence get_social_insights возвращает его для одной из 20 последних публикаций аккаунта, если impression_sources указан в metrics, с item_id публикации как object_id.

Что easyCoexistence делает с музыкой?

Публикует звук, который уже есть в вашем файле. publish_tiktok_post, сразу или с scheduled_at, отправляет подпись, название фотопубликации и настройку комментариев, без music_sound_info и без auto_add_music, так что видео сохраняет собственный саундтрек, а фотопубликация уходит без музыки. Ваш код может отправить POST на business/video/publish/ с music_sound_info и токеном из get_social_credentials, но это тело уходит в TikTok как есть, включая video_url, а TikTok забирает медиа только с доменов или префиксов URL, подтверждённых для приложения. Пути /discovery/ принимают токен рекламодателя, поэтому список треков недоступен токену аккаунта.

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

  • Оставить video_original_sound_volume пустым при добавлении трека. Через API он по умолчанию равен 0, а приложение TikTok начинает оба звука с 50, поэтому задавайте его, когда важен собственный звук видео.
  • Передавать название трека или preview_url как music_sound_id. Справочник TikTok называет значением для передачи song_clip_id из full_duration_song_clip или trending_song_clip.
  • Вызывать /discovery/cml/trending_list/ с токеном рекламодателя. Эндпоинты треков принимают токен аккаунта TikTok и business_id, как и Accounts API.
  • Считать длительность 0 признаком сломанного трека. TikTok отмечает, что трек, который является лишь фрагментом более длинного произведения, может показывать 0, поэтому проверьте его превью перед выбором начала и конца.
Настройка с EasyCoexistence

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

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

Можно ли добавить любую песню к публикации TikTok через API?

Песни из Commercial Music Library, по ID. Музыка, уже подмешанная в файл видео, уходит вместе с файлом, поэтому это должна быть музыка, на использование которой у вас есть права.

Какую громкость API TikTok ставит для добавленной музыки?

0 по умолчанию. music_sound_volume и video_original_sound_volume идут от 0 до 100, оба по умолчанию равны 0 через API, а приложение TikTok начинает с 50, поэтому задавайте их у каждого видео с треком.

Важна ли музыка публикации, если её позже используют в рекламе?

TikTok проверяет её: /identity/music/authorization/ сообщает для мест и дат показа, полностью ли разрешена музыка публикации, не хватает ли разрешения или нет ID песни.

Сколько песен в Commercial Music Library TikTok?

1 миллион по данным справочного центра TikTok для бизнеса, все заранее одобрены для коммерческого использования. /discovery/cml/trending_list/ возвращает до 100 популярных за раз.

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

Как опубликовать видео в TikTok через APIПубликуйте видео в TikTok через API for Business: эндпоинт публикации, тело JSON, share_id из ответа и проверка статуса в curl и Python.Фото-посты и карусели TikTok через API: до 35 изображенийФото-посты TikTok через API: от 1 до 35 изображений JPEG или WebP до 20 МБ каждое, заголовок до 90 символов, подпись и обложка.Что умеет TikTok API в 2026 году и что остаётся в приложенииЧто делает TikTok API for Business в 2026 году: посты, комментарии, аналитику и вебхуки. Что остаётся в приложении: личные сообщения, звуки и правки видео.Лучшее время для публикации в TikTok по собственным данным APIНайдите лучшие часы публикации аккаунта TikTok в audience_activity, почасовых счётчиках подписчиков из API, и запланируйте посты на эти часы.Подсказки хэштегов TikTok и популярные хэштеги через APIAPI TikTok для хэштегов: 10 подсказок на ключевое слово на 35 языках, топ-200 популярных хэштегов, токены и подписи из них.

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

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

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

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