Добавление музыки в публикации 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 дней вперёд, а видео уходит с саундтреком, подмешанным в его файл.
Самые популярные треки, которые возвращает /discovery/cml/trending_list/, все заранее одобрены для органического контента и рекламных креативов.
Диапазон music_sound_volume и video_original_sound_volume; через API оба по умолчанию равны 0, а приложение TikTok начинает с 50.
Треки Commercial Music Library TikTok, заранее одобренной глобальной библиотеки, которую бизнес использует для коммерческой деятельности в TikTok.
Где могут показываться креативы с музыкой из списка музыки для рекламы TikTok, если правообладатели не дали отдельного разрешения.
Единственный post_mode, в котором эндпоинт фото Content Posting API применяет auto_add_music, на developers.tiktok.com.
Какие поля музыки принимают публикующие эндпоинты TikTok?
Оба эндпоинта несут музыку внутри post_info, в объекте music_sound_info, и называют трек по его ID из Commercial Music Library. В остальном они различаются: эндпоинт видео добавляет настройки микширования, а эндпоинт фото добавляет переключатель, который позволяет TikTok выбрать музыку. Ниже оба списка рядом, как их приводят справочники TikTok:
| Video post | Photo post | |
|---|---|---|
| The track | music_sound_info.music_sound_id | music_sound_info.music_sound_id |
| Track volume | music_sound_volume, 0 to 100, required with a track | No field |
| Part of the track | music_sound_start and music_sound_end, in milliseconds | No field |
| The video's own sound | video_original_sound_volume, 0 to 100 | Not applicable |
| Recommended music | No field | auto_add_music, false by default |
| As a draft | upload_to_draft drops the rest of post_info | is_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:
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.
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, поэтому проверьте его превью перед выбором начала и конца.
От 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 популярных за раз.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на