Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Adăugarea muzicii la postările TikTok prin API

API-ul TikTok for Business adaugă muzică din Commercial Music Library: în post_info.music_sound_info se trimite music_sound_id al unei piese, atât la videoclipuri, cât și la fotografii. La videoclipuri se mai setează volumul piesei, începutul și sfârșitul ei în milisecunde și volumul sunetului original al videoclipului. Fotografiile pot primi și auto_add_music pentru muzică recomandată. ID-urile pieselor provin din GET /discovery/cml/trending_list/.

easyCoexistence publică videoclipuri și postări cu fotografii pe TikTok cu publish_tiktok_post din Claude, ChatGPT sau din propriul cod, acum sau la o oră stabilită, până la 90 de zile în avans, iar un videoclip pleacă cu coloana sonoră mixată în fișier.

100

Cele mai populare piese returnate de /discovery/cml/trending_list/, toate pre-aprobate pentru conținut organic și crearea de reclame.

0 to 100

Intervalul valorilor music_sound_volume și video_original_sound_volume; prin API, ambele au valoarea implicită 0, în timp ce aplicația TikTok pornește de la 50.

1 million

Piese din Commercial Music Library, biblioteca globală pre-aprobată pe care companiile o folosesc pentru activitatea lor comercială pe TikTok.

TikTok only

Unde pot fi difuzate creațiile făcute cu muzică din lista pentru reclame TikTok, dacă deținătorii drepturilor nu acordă o permisiune separată.

DIRECT_POST

Singura valoare post_mode în care endpoint-ul pentru fotografii al Content Posting API aplică auto_add_music, pe developers.tiktok.com.

Ce câmpuri pentru muzică acceptă endpoint-urile de publicare TikTok?

Ambele endpoint-uri transmit muzica în post_info, la music_sound_info, și identifică o piesă prin ID-ul ei din Commercial Music Library. Dincolo de asta diferă: endpoint-ul pentru videoclipuri adaugă controale de mixare, iar cel pentru fotografii adaugă un comutator care lasă TikTok să aleagă muzica. Comparativ, așa cum le listează referințele 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

Cum adaug o piesă la un videoclip?

Trimiteți music_sound_info în post_info, la POST /business/video/publish/. Odată prezent obiectul, music_sound_id și music_sound_volume sunt obligatorii. music_sound_start și music_sound_end aleg porțiunea din piesă, în milisecunde, implicit de la începutul piesei până la lungimea completă a videoclipului. Astfel, un videoclip de 2 secunde ia primele 2.000 de milisecunde ale piesei. Setați și video_original_sound_volume ori de câte ori contează sunetul original al videoclipului, pentru că implicit este 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
      }
    }
  }'

De unde provin ID-urile pieselor?

De la GET /discovery/cml/trending_list/, un endpoint al Discovery API care primește token-ul de acces al unui cont TikTok și business_id, iar endpoint-urile pentru hashtag-uri din Discovery cer token-ul unui anunțător. Referința TikTok îl trece la permisiunea Discovery din Creative Management. Returnează până la 100 de piese populare, fiecare cu numele, artistul, durata, rangul, genurile, un preview_url care nu expiră și până la 30 de zile de trending_history. full_duration_song_clip și trending_song_clip conțin fiecare un song_clip_id, valoarea pe care TikTok o numește music_sound_id:

  • genre: ALL implicit sau una dintre peste 100 de valori, precum POP, LATIN, LO-FI sau SERTANEJO.
  • country_code: US implicit. date_range: 1DAY, 7DAY implicit, 30DAY sau 90DAY.
  • /discovery/cml/video_list/: primele 20 de videoclipuri aflate în tendințe care folosesc o piesă, după commercial_music_id și un 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'

Cum se adaugă muzică la fotografii?

În două moduri, pe POST /business/photo/publish/. auto_add_music setat pe true face ca TikTok să adauge muzică recomandată, pe care proprietarul o poate schimba ulterior în aplicația TikTok. music_sound_info.music_sound_id indică o piesă anume din bibliotecă, fără câmpuri de volum, început sau sfârșit pentru fotografii. Pe developers.tiktok.com, endpoint-ul pentru fotografii al Content Posting API are propriul auto_add_music, aplicat doar când post_mode este DIRECT_POST, iar endpoint-ul său pentru publicarea directă a videoclipurilor nu documentează niciun câmp de muzică.

Ce înseamnă Commercial Music Library pentru conturile Business?

Este muzica pe care o pot folosi. Centrul de ajutor Business TikTok descrie biblioteca drept o colecție globală pre-aprobată de 1 milion de melodii, spune că firmele nu pot folosi biblioteca generală de muzică în scop comercial și le trimite la Commercial Music Library pentru conținut organic, inclusiv duete, reacții și stitch-uri, pentru reclame cu videoclipuri și pentru conținut de brand. Pe un cont Business, „Add Sound” din aplicație arată doar sunete din bibliotecă, iar API-ul trasează aceeași linie, întrucât music_sound_id acceptă un ID din bibliotecă.

Ce nu poate face API-ul cu muzica?

Câteva lucruri stau în afara câmpurilor sale, așa cum le descriu referințele TikTok:

  • Numirea unui sunet din biblioteca generală TikTok: music_sound_id acceptă un ID din Commercial Music Library.
  • Căutarea în bibliotecă după titlu: /discovery/cml/trending_list/ filtrează piesele populare după gen, țară și perioadă.
  • Păstrarea muzicii pe o ciornă: upload_to_draft face ca TikTok să ignore restul din post_info, iar is_draft păstrează doar titlul și legenda.
  • Folosirea unei piese proprii într-o postare organică: /file/music/upload/ adaugă muzică pentru creațiile de reclame sub un advertiser_id, iar avertismentul TikTok de acolo lasă responsabilitatea privind drepturile de autor în seama celui care încarcă.

Care sunt soluțiile ocolitoare?

Trei, fiecare construită pe ce documentează referințele TikTok, plus un risc de cântărit:

  • Mixarea muzicii în fișier. Constrângerile TikTok descriu videoclipul ca fiind conținut audio-video, deci o coloană sonoră mixată pleacă odată cu el; folosiți audio asupra căruia dețineți drepturile.
  • Trimiterea unei ciorne. Cu upload_to_draft sau is_draft și permisiunea video.upload, postarea ajunge în căsuța de primire a creatorului din TikTok, pentru a fi editată și publicată în aplicație.
  • Lăsarea TikTok să aleagă la fotografii. auto_add_music adaugă muzică recomandată, pe care proprietarul o poate schimba ulterior în aplicația TikTok.
  • Riscul cu sunetul mixat: lista de postări a TikTok menționează, printre motivele probabile pentru filtrarea unei postări, și încălcările drepturilor de autor asupra muzicii.

Cum văd dacă un sunet a adus vizualizări?

Prin impression_sources, un câmp al /business/video/list/ care clasează locurile de unde spectatorii au găsit o postare; una dintre valori este Sound, pentru vizualizările venite din paginile de sunet. Necesită permisiunea video.insights și, ca celelalte cifre, întârzie cu 24 până la 48 de ore. Prin easyCoexistence, get_social_insights îl returnează pentru una dintre cele mai recente 20 de postări ale contului, când impression_sources este menționat în metrics, cu valoarea item_id a postării ca object_id.

Ce face easyCoexistence cu muzica?

Publică sunetul deja din fișierul tău. publish_tiktok_post, fie imediat, fie cu scheduled_at, trimite legenda, titlul unei postări cu fotografie și setarea comentariilor, fără music_sound_info și fără auto_add_music, astfel că un videoclip își păstrează coloana sonoră proprie, iar o fotografie pleacă fără muzică. Propriul tău cod poate face POST la business/video/publish/ cu music_sound_info și cu token-ul din get_social_credentials, dar acel corp ajunge la TikTok așa cum este scris, inclusiv video_url, iar TikTok preia media doar de pe domenii sau prefixe de URL verificate pentru aplicație. Căile /discovery/ primesc token-ul unui anunțator, deci lista de piese este în afara accesului token-ului contului.

Greșeli frecvente

  • Lăsarea în afară a video_original_sound_volume la adăugarea unei piese. Prin API, valoarea implicită este 0, în timp ce aplicația TikTok pornește ambele sunete de la 50, așa că setați-o ori de câte ori contează sunetul original al videoclipului.
  • Trecerea numelui unei piese sau a câmpului preview_url drept music_sound_id. Referința TikTok numește song_clip_id, din full_duration_song_clip sau trending_song_clip, drept valoarea de transmis.
  • Apelarea /discovery/cml/trending_list/ cu un token de advertiser. Endpoint-urile pentru piese cer token-ul unui cont TikTok și business_id, la fel ca Accounts API.
  • Citirea unei durate de 0 drept o piesă defectă. TikTok notează că o piesă care este doar un fragment dintr-una mai lungă poate afișa 0, așa că verificați previzualizarea înainte de a alege începutul și sfârșitul.
Faceți acest lucru cu EasyCoexistence

De la US$ 9 la US$ 0,75 pe conexiune pe lună, pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Pot adăuga orice melodie la o postare TikTok prin API?

Melodii din Commercial Music Library, după ID. Muzica deja mixată într-un fișier video pleacă odată cu fișierul videoclipului, deci trebuie să fie muzică pentru care aveți drepturile de utilizare.

Ce volum setează API-ul TikTok pentru muzica adăugată?

0 implicit. music_sound_volume și video_original_sound_volume variază de la 0 la 100, iar ambele au valoarea implicită 0 prin API, în timp ce aplicația TikTok pornește de la 50, așa că setați-le la fiecare videoclip cu o piesă.

Contează muzica unei postări dacă postarea ajunge ulterior într-o reclamă?

TikTok verifică. /identity/music/authorization/ arată, pentru locațiile și datele de difuzare ale reclamei, dacă muzica postării este autorizată integral, lipsește autorizația sau nu are ID de melodie.

Câte melodii are Commercial Music Library a TikTok?

1 milion, potrivit Centrului de ajutor Business TikTok, toate pre-aprobate pentru utilizare comercială. /discovery/cml/trending_list/ returnează până la 100 de piese populare deodată.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la