Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

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.

100

Najpopularniejsze utwory, które zwraca /discovery/cml/trending_list/, wszystkie wcześniej zatwierdzone do treści organicznych i reklam.

0 to 100

Zakres music_sound_volume i video_original_sound_volume; przez API oba domyślnie wynoszą 0, a aplikacja TikTok zaczyna od 50.

1 million

Utwory w Commercial Music Library, wstępnie zatwierdzonej globalnej bibliotece, z której firmy korzystają w działaniach komercyjnych na TikToku.

TikTok only

Gdzie mogą być emitowane kreacje z muzyką z listy muzyki reklamowej TikToka, chyba że właściciele praw udzielą odrębnej zgody.

DIRECT_POST

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 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

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:

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
      }
    }
  }'

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 jego commercial_music_id i 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'

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_id przyjmuje 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_draft sprawia, że TikTok ignoruje resztę post_info, a is_draft zachowuje 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_draft lub is_draft i 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_music dodaje 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.
Z EasyCoexistence zrobisz to

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