Dodawanie muzyki do postów TikTok przez API
API for Business w TikToku dodaje muzykę z Commercial Music Library: post_info.music_sound_info przyjmuje music_sound_id utworu w postach wideo i ze zdjęciami, a przy filmach także głośność utworu, jego początek i koniec w milisekundach oraz głośność dźwięku z samego filmu. Posty ze zdjęciami mogą też przyjąć auto_add_music dla polecanej muzyki. ID utworów pochodzą z GET /discovery/cml/trending_list/.
easyCoexistence publikuje filmy i posty ze zdjęciami TikToka za pomocą publish_tiktok_post z Claude, ChatGPT lub własnego kodu, od razu lub o ustalonej porze do 90 dni wcześniej, a film wychodzi ze ścieżką dźwiękową zmiksowaną w pliku.
Najpopularniejsze utwory, które zwraca /discovery/cml/trending_list/, wszystkie wcześniej zatwierdzone do treści organicznych i reklam.
Zakres music_sound_volume i video_original_sound_volume; przez API oba domyślnie wynoszą 0, a aplikacja TikTok zaczyna od 50.
Utwory w Commercial Music Library, wstępnie zatwierdzonej globalnej bibliotece, z której firmy korzystają w działaniach komercyjnych na TikToku.
Gdzie mogą być emitowane kreacje z muzyką z listy muzyki reklamowej TikToka, chyba że właściciele praw udzielą odrębnej zgody.
Jedyny post_mode, w którym endpoint zdjęć Content Posting API stosuje auto_add_music, na developers.tiktok.com.
Jakie pola muzyczne przyjmują endpointy publikacji TikToka?
Oba endpointy umieszczają muzykę w post_info, w polu music_sound_info, i wskazują utwór przez jego ID z Commercial Music Library. Poza tym się różnią: endpoint wideo dodaje opcje miksowania, a endpoint zdjęć dodaje przełącznik, który pozwala TikTokowi wybrać muzykę. Obok siebie, tak jak wymieniają je referencje TikToka:
| 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 |
Jak dodać utwór do filmu?
Wyślij music_sound_info wewnątrz post_info w POST /business/video/publish/. Gdy obiekt jest obecny, wymagane są music_sound_id i music_sound_volume. music_sound_start i music_sound_end wybierają fragment utworu w milisekundach, domyślnie od początku utworu do pełnej długości filmu, więc film 2-sekundowy wykorzysta pierwsze 2 000 milisekund utworu. Ustaw też video_original_sound_volume zawsze wtedy, gdy liczy się dźwięk z samego filmu, bo domyślnie wynosi 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
}
}
}'Skąd biorą się ID utworów?
Z GET /discovery/cml/trending_list/, endpointu Discovery API, który przyjmuje token dostępu konta TikTok i business_id, podczas gdy endpointy hashtagów Discovery przyjmują token reklamodawcy. Referencje TikToka umieszczają go w uprawnieniu Discovery w Creative Management. Zwraca do 100 popularnych utworów, każdy z nazwą, wykonawcą, czasem trwania, pozycją, gatunkami, preview_url, który nie wygasa, i do 30 dni trending_history. full_duration_song_clip i trending_song_clip zawierają każdy song_clip_id, czyli wartość, którą TikTok nazywa music_sound_id:
- genre: ALL domyślnie albo jedna z ponad 100 wartości, np. POP, LATIN, LO-FI lub SERTANEJO.
country_code: domyślnie US.date_range: 1DAY, domyślnie 7DAY, 30DAY lub 90DAY.- /discovery/cml/
video_list/: 20 najpopularniejszych filmów z danym utworem, według jegocommercial_music_idicountry_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'Skąd posty ze zdjęciami mają muzykę?
Na dwa sposoby w POST /business/photo/publish/. auto_add_music ustawione na true sprawia, że TikTok dodaje polecaną muzykę, którą właściciel może później zmienić w aplikacji TikTok. music_sound_info.music_sound_id wskazuje konkretny utwór z biblioteki, bez pól głośności, początku i końca dla zdjęć. Na developers.tiktok.com endpoint zdjęć Content Posting API ma własne auto_add_music, stosowane tylko wtedy, gdy post_mode to DIRECT_POST, a jego endpoint wideo do bezpośredniej publikacji nie dokumentuje żadnego pola muzycznego.
Co Commercial Music Library oznacza dla kont firmowych?
Jest to muzyka, z której mogą korzystać. Centrum Pomocy dla firm TikToka opisuje bibliotekę jako wstępnie zatwierdzony globalny zbiór 1 miliona utworów, mówi, że firmy nie mogą używać ogólnej biblioteki muzycznej w celach komercyjnych, i kieruje je do Commercial Music Library w przypadku treści organicznych, duetów, reakcji i stitchy, reklam wideo oraz treści markowych. Na koncie firmowym „Add Sound” w aplikacji pokazuje wyłącznie dźwięki z biblioteki, a API wyznacza tę samą granicę, ponieważ music_sound_id przyjmuje ID z biblioteki.
Czego API nie potrafi zrobić z muzyką?
Kilka rzeczy leży poza jego polami, jak opisują to referencje TikToka:
- Wskazać dźwięk z ogólnej biblioteki TikToka:
music_sound_idprzyjmuje ID z Commercial Music Library. - Wyszukać utwór w bibliotece po tytule: /discovery/cml/
trending_list/ filtruje popularne utwory według gatunku, kraju i okresu. - Zachować muzykę w szkicu:
upload_to_draftsprawia, że TikTok ignoruje resztępost_info, ais_draftzachowuje tylko tytuł i podpis. - Użyć własnego utworu w poście organicznym: /file/music/upload/ dodaje muzykę do kreacji reklamowych pod
advertiser_id, a uwaga TikToka w tym miejscu zostawia odpowiedzialność za prawa autorskie po stronie przesyłającego.
Jakie są obejścia?
Trzy, każde oparte na tym, co dokumentują referencje TikToka, oraz jedno ryzyko do rozważenia:
- Zmiksuj muzykę w pliku. Ograniczenia TikToka opisują wideo jako treść audio-wideo, więc zmiksowana ścieżka wychodzi razem z nim; używaj dźwięku, do którego masz prawa.
- Wyślij szkic. Z
upload_to_draftlubis_drafti zakresem video.upload post trafia do skrzynki twórcy w TikToku, gdzie można go edytować i opublikować w aplikacji. - Pozwól TikTokowi wybrać na zdjęciach.
auto_add_musicdodaje polecaną muzykę, którą właściciel może później podmienić w aplikacji TikTok. - Ryzyko przy zmiksowanym dźwięku: lista postów TikToka wymienia naruszenia praw autorskich do muzyki wśród prawdopodobnych powodów odfiltrowania posta.
Jak sprawdzić, czy dźwięk przyniósł wyświetlenia?
Przez impression_sources, pole /business/video/list/, które pokazuje, skąd widzowie posta na niego trafili; jedna z jego wartości to Sound, dla wyświetleń z podstron dźwięków. Wymaga zakresu video.insights i, jak pozostałe liczniki, pojawia się z opóźnieniem 24 do 48 godzin. Przez easyCoexistence get_social_insights zwraca je dla jednego z 20 ostatnich postów konta, gdy impression_sources jest wymienione w metrics, z item_id posta jako object_id.
Co easyCoexistence robi z muzyką?
Publikuje dźwięk, który już znajduje się w Twoim pliku. publish_tiktok_post, od razu lub z scheduled_at, wysyła podpis, tytuł posta ze zdjęciami i ustawienie komentarzy, bez music_sound_info i bez auto_add_music, więc film zachowuje własną ścieżkę dźwiękową, a post ze zdjęciami wychodzi bez muzyki. Twój własny kod może wysłać POST do business/video/publish/ z music_sound_info i tokenem z get_social_credentials, ale to ciało trafia do TikToka w niezmienionej postaci, łącznie z video_url, a TikTok pobiera media tylko z domen lub prefiksów URL zweryfikowanych dla aplikacji. Ścieżki /discovery/ wymagają tokenu reklamodawcy, więc lista utworów jest poza zasięgiem tokenu konta.
Typowe błędy
- Pominięcie video_original_sound_volume przy dodawaniu utworu. Przez API domyślnie wynosi 0, podczas gdy aplikacja TikTok ustawia oba dźwięki na 50, więc ustaw je zawsze, gdy liczy się dźwięk z samego filmu.
- Przekazanie nazwy utworu lub preview_url jako music_sound_id. Referencje TikToka wskazują song_clip_id z full_duration_song_clip lub trending_song_clip jako wartość do przekazania.
- Wywołanie /discovery/cml/trending_list/ tokenem reklamodawcy. Endpointy utworów przyjmują token konta TikTok i business_id, tak jak Accounts API.
- Traktowanie czasu trwania 0 jako uszkodzonego utworu. TikTok zaznacza, że utwór będący tylko fragmentem dłuższego może pokazać 0, więc sprawdź jego podgląd przed wyborem początku i końca.
Od US$ 9 do US$ 0,75 za połączenie miesięcznie, obniżając się wraz z dodawaniem połączeń, z pierwszymi 3 dniami w bezpłatnym okresie próbnym.
Najczęściej zadawane pytania
Czy mogę dodać dowolną piosenkę do posta na TikToku przez API?
Piosenki z Commercial Music Library, po ID. Muzyka już zmiksowana w pliku wideo wychodzi razem z plikiem, więc powinna to być muzyka, do której masz prawa.
Jaką głośność API TikToka ustawia dla dodanej muzyki?
Domyślnie 0. music_sound_volume i video_original_sound_volume przyjmują wartości od 0 do 100, a przez API oba domyślnie wynoszą 0, podczas gdy aplikacja TikTok zaczyna od 50, więc ustawiaj je na każdym filmie z utworem.
Czy muzyka w poście ma znaczenie, jeśli post później trafi do reklamy?
TikTok to sprawdza: /identity/music/authorization/ informuje, dla lokalizacji i dat emisji reklamy, czy muzyka posta jest w pełni autoryzowana, brakuje autoryzacji, czy nie ma ID utworu.
Ile utworów jest w Commercial Music Library TikToka?
1 milion według Centrum Pomocy dla firm TikToka, wszystkie wstępnie zatwierdzone do użytku komercyjnego. /discovery/cml/trending_list/ zwraca naraz do 100 popularnych.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w