Dodavanje muzike u TikTok objave preko API-ja
TikTok API za poslovanje dodaje muziku iz Commercial Music Library: post_info.music_sound_info prihvata music_sound_id numere na video i foto objavama, a na videima i jačinu numere, početak i kraj u milisekundama i jačinu sopstvenog zvuka videa. Foto objave mogu da prihvate i auto_add_music za preporučenu muziku. ID-jevi numera dolaze iz GET /discovery/cml/trending_list/.
easyCoexistence objavljuje TikTok videe i foto objave pomoću publish_tiktok_post iz Claude, ChatGPT-a ili vašeg koda, odmah ili u zadato vreme do 90 dana unapred, a video izlazi sa zvučnim zapisom umešanim u fajl.
Najpopularnije numere koje vraća /discovery/cml/trending_list/, sve unapred odobrene za organski sadržaj i kreiranje oglasa.
Opseg vrednosti music_sound_volume i video_original_sound_volume; preko API-ja su oba podrazumevano 0, dok aplikacija TikTok kreće od 50.
Pesme u TikTokovoj Commercial Music Library, unapred odobrenoj globalnoj biblioteci koju firme koriste za komercijalne aktivnosti na TikToku.
Mesta na kojima mogu da se prikazuju kreativni sadržaji napravljeni muzikom iz TikTokove liste za oglase, osim ako nosioci prava ne daju zasebnu dozvolu.
Jedini post_mode u kome foto endpoint Content Posting API-ja primenjuje auto_add_music, na developers.tiktok.com.
Koja polja za muziku prihvataju TikTokovi endpointi za objavljivanje?
Oba endpointa nose muziku unutar post_info, pod music_sound_info, i numeru imenuju njenim ID-jem iz Commercial Music Library. Osim toga, razlikuju se: endpoint za video dodaje kontrole miksovanja, a endpoint za foto dodaje prekidač koji TikToku omogućava da sam izabere muziku. Uporedo, kako ih navode TikTokove reference:
| 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 |
Kako dodati numeru na video?
Pošaljite music_sound_info unutar post_info na POST /business/video/publish/. Kada je objekat tu, music_sound_id i music_sound_volume su obavezni. music_sound_start i music_sound_end biraju deo numere u milisekundama, podrazumevano od početka numere do pune dužine videa, pa video od 2 sekunde uzima prvih 2.000 milisekundi numere. Postavite i video_original_sound_volume kad god je zvuk samog videa bitan, jer je podrazumevano 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
}
}
}'Odakle dolaze ID-jevi numera?
Iz GET /discovery/cml/trending_list/, Discovery API endpointa koji prihvata access token TikTok naloga i business_id, dok ga endpointi za hashtagove prihvataju od oglašivača. TikTok ga u svojoj referenci svrstava pod dozvolu Discovery u okviru Creative Management. Vraća do 100 popularnih numera, svaku sa imenom, izvođačem, trajanjem, rangom, žanrovima, preview_url koji ne ističe i do 30 dana trending_history. full_duration_song_clip i trending_song_clip imaju svaki song_clip_id, vrednost koju TikTok naziva music_sound_id:
- genre: ALL podrazumevano, ili jedna od više od 100 vrednosti, na primer POP, LATIN, LO-FI ili SERTANEJO.
country_code: US podrazumevano.date_range: 1DAY, 7DAY podrazumevano, 30DAY ili 90DAY.- /discovery/cml/
video_list/: prvih 20 trenutno popularnih videa koji koriste numeru, prema njenomcommercial_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'Kako foto objave dobijaju muziku?
Na dva načina na POST /business/photo/publish/. auto_add_music postavljen na true nalaže TikToku da doda preporučenu muziku, koju vlasnik kasnije može da promeni u aplikaciji TikTok. music_sound_info.music_sound_id imenuje određenu numeru iz biblioteke, bez polja za jačinu, početak i kraj na fotografijama. Na developers.tiktok.com, foto endpoint Content Posting API-ja ima sopstveni auto_add_music, primenjen samo kada je post_mode DIRECT_POST, a njegov direktni endpoint za video ne navodi polje za muziku.
Šta Commercial Music Library znači za poslovne naloge?
To je muzika koju smeju da koriste. TikTokov centar za pomoć za poslovanje opisuje biblioteku kao unapred odobrenu globalnu kolekciju od milion pesama, navodi da firme ne mogu da koriste opštu muzičku biblioteku u komercijalne svrhe i upućuje ih na Commercial Music Library za organski sadržaj, uključujući duete, reakcije i stitch objave, video oglase i brendirani sadržaj. Na poslovnom nalogu, Add Sound u aplikaciji prikazuje samo zvukove iz biblioteke, a API povlači istu granicu, jer music_sound_id prihvata ID iz biblioteke.
Šta API ne može da uradi sa muzikom?
Nekoliko stvari je van njegovih polja, kako ih opisuju TikTokove reference:
- Imenovati zvuk iz opšte TikTokove biblioteke:
music_sound_idprihvata ID iz Commercial Music Library. - Pretražiti biblioteku po naslovu: /discovery/cml/
trending_list/ filtrira popularne numere po žanru, zemlji i periodu. - Zadržati muziku na nacrtu:
upload_to_draftčini da TikTok ignoriše ostatakpost_info, ais_draftzadržava samo naslov i opis. - Koristiti sopstvenu numeru u organskoj objavi: /file/music/upload/ dodaje muziku za kreativne oglase pod
advertiser_id, a TikTokovo upozorenje tu odgovornost za autorska prava prepušta onome ko otprema fajl.
Koja su zaobilazna rešenja?
Tri, svako zasnovano na onome što TikTokove reference dokumentuju, plus jedan rizik koji treba uzeti u obzir:
- Umešajte muziku u fajl. TikTokova ograničenja opisuju video kao audio-video sadržaj, pa muzika umešana u zvučni zapis ide zajedno sa njim; koristite zvuk na koji imate prava.
- Pošaljite nacrt. Uz
upload_to_draftiliis_drafti opseg video.upload, objava stiže u TikTok inbox kreatora, da je uredi i objavi u aplikaciji. - Neka TikTok izabere muziku na foto objavama.
auto_add_musicdodaje preporučenu muziku, a vlasnik je kasnije može zameniti u aplikaciji TikTok. - Rizik kod miksovanog zvuka: TikTokova referenca za listu objava navodi kršenje autorskih prava na muziku među verovatnim razlozima zbog kojih se objava filtrira.
Kako videti da li je zvuk doneo preglede?
Preko impression_sources, polja /business/video/list/ koje rangira odakle su gledaoci objave pronašli; jedna od vrednosti je Sound, za preglede koji su došli sa stranica zvuka. Potreban je opseg video.insights i, kao i ostali brojevi, stiže sa zakašnjenjem od 24 do 48 sati. Preko easyCoexistence, get_social_insights vraća to za jednu od 20 najnovijih objava naloga kada je impression_sources naveden u metrics, uz item_id objave kao object_id.
Šta easyCoexistence radi sa muzikom?
Objavljuje zvuk koji je već u vašem fajlu. publish_tiktok_post, odmah ili sa scheduled_at, šalje opis, naslov foto objave i podešavanje komentara, bez music_sound_info i bez auto_add_music, pa video zadržava sopstveni zvučni zapis, a foto objava izlazi bez muzike. Vaš sopstveni kod može da POST-uje na business/video/publish/ sa music_sound_info i tokenom iz get_social_credentials, ali to telo stiže do TikToka onako kako je napisano, uključujući video_url, a TikTok preuzima medijske fajlove samo sa domena ili prefiksa URL-a verifikovanih za aplikaciju. Putanje /discovery/ uzimaju token oglašivača, pa lista numera nije u dosegu tokena naloga.
Česte greške
- Izostavljanje video_original_sound_volume pri dodavanju numere. Preko API-ja je podrazumevano 0, dok aplikacija TikTok oba zvuka pokreće na 50, pa ga postavite kad god je zvuk samog videa bitan.
- Prosleđivanje imena numere ili preview_url kao music_sound_id. TikTokova referenca za numere navodi song_clip_id, iz full_duration_song_clip ili trending_song_clip, kao vrednost koju treba proslediti.
- Pozivanje /discovery/cml/trending_list/ tokenom oglašivača. Endpointi za numere prihvataju token TikTok naloga i business_id, kao što to radi Accounts API.
- Tumačenje trajanja 0 kao pokvarene numere. TikTok napominje da numera koja je samo isečak duže kompozicije može prikazati 0, pa proverite njen pregled pre nego što izaberete početak i kraj.
Od US$ 9 do US$ 0,75 po vezi mesečno, uz pad kako dodajete veze, uz besplatni probni period od 3 dana.
Često postavljana pitanja
Mogu li da dodam bilo koju pesmu u TikTok objavu preko API-ja?
Pesme iz Commercial Music Library, po ID-u. Muzika već umešana u fajl videa ide zajedno sa fajlom, pa treba da bude muzika na koju imate pravo korišćenja.
Koju jačinu TikTokov API postavlja za dodatu muziku?
0 podrazumevano. music_sound_volume i video_original_sound_volume kreću se od 0 do 100, a preko API-ja su oba podrazumevano 0, dok aplikacija TikTok kreće od 50, pa ih postavite na svakom videu sa numerom.
Da li je muzika objave bitna ako se objava kasnije koristi u oglasu?
TikTok to proverava: /identity/music/authorization/ izveštava, za lokacije oglasa i datume prikazivanja, da li je muzika objave u potpunosti autorizovana, da li autorizacija nedostaje ili nema ID pesme.
Koliko pesama ima u TikTokovoj Commercial Music Library?
Milion, prema TikTokovom centru za pomoć za poslovanje, sve unapred odobrene za komercijalnu upotrebu. /discovery/cml/trending_list/ vraća do 100 popularnih odjednom.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na