Menambah muzik pada siaran TikTok melalui API
API TikTok for Business menambah muzik daripada Commercial Music Library: post_info.music_sound_info menerima music_sound_id bagi trek pada siaran video dan foto, dan pada video turut menerima kelantangan trek, masa mula dan tamat dalam milisaat serta kelantangan bunyi asal video. Siaran foto juga boleh menggunakan auto_add_music untuk muzik yang disyorkan. ID trek diperoleh daripada GET /discovery/cml/trending_list/.
easyCoexistence menerbitkan video dan siaran foto TikTok dengan publish_tiktok_post daripada Claude, ChatGPT atau kod anda sendiri, sama ada serta-merta atau pada masa yang ditetapkan sehingga 90 hari lebih awal, dan video keluar dengan runut bunyi yang dicampur ke dalam failnya.
Trek paling popular yang dikembalikan oleh /discovery/cml/trending_list/, kesemuanya telah diluluskan terlebih dahulu untuk kandungan organik dan penciptaan iklan.
Julat music_sound_volume dan video_original_sound_volume; melalui API, kedua-duanya lalai kepada 0, manakala aplikasi TikTok bermula pada 50.
Lagu dalam Commercial Music Library TikTok, perpustakaan global yang telah diluluskan terlebih dahulu dan digunakan oleh perniagaan untuk aktiviti komersial di TikTok.
Lokasi di mana kreatif yang dibuat dengan muzik daripada senarai muzik iklan TikTok boleh dipaparkan, melainkan pemegang hak memberikan kebenaran berasingan.
Satu-satunya post_mode di mana endpoint foto Content Posting API menggunakan auto_add_music, di developers.tiktok.com.
Medan muzik manakah yang diterima oleh endpoint penerbitan TikTok?
Kedua-dua endpoint membawa muzik di dalam post_info, di bawah music_sound_info, dan menamakan trek mengikut ID Commercial Music Library. Selain itu, ia berbeza: endpoint video menambah kawalan campuran, dan endpoint foto menambah suis yang membolehkan TikTok memilih muzik. Secara bersebelahan, seperti yang disenaraikan dalam rujukan 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 |
Bagaimana menambah trek pada video?
Hantar music_sound_info di dalam post_info pada POST /business/video/publish/. Apabila objek itu ada, music_sound_id dan music_sound_volume diperlukan. music_sound_start dan music_sound_end memilih bahagian trek dalam milisaat, daripada permulaan trek hingga panjang penuh video secara lalai, jadi video 2 saat mengambil 2,000 milisaat pertama trek. Tetapkan juga video_original_sound_volume setiap kali audio asal video penting, kerana nilai lalainya ialah 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
}
}
}'Dari mana ID trek diperoleh?
Daripada GET /discovery/cml/trending_list/, endpoint Discovery API yang memerlukan token akses akaun TikTok dan business_id, manakala endpoint hashtag Discovery memerlukan token pengiklan; rujukan TikTok meletakkannya di bawah kebenaran Discovery bagi Creative Management. Ia mengembalikan sehingga 100 trek popular, setiap satu dengan nama, artis, tempoh, kedudukan, genre, preview_url yang tidak tamat tempoh dan sehingga 30 hari trending_history. full_duration_song_clip dan trending_song_clip masing-masing memegang song_clip_id, nilai yang dinamakan TikTok sebagai music_sound_id:
- genre: ALL secara lalai, atau salah satu daripada lebih 100 nilai seperti POP, LATIN, LO-FI atau SERTANEJO.
country_code: US secara lalai.date_range: 1DAY, 7DAY secara lalai, 30DAY atau 90DAY.- /discovery/cml/
video_list/: 20 video trending teratas yang menggunakan trek, mengikutcommercial_music_iddancountry_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'Bagaimana siaran foto mendapat muzik?
Dua cara pada POST /business/photo/publish/. auto_add_music ditetapkan kepada true menjadikan TikTok menambah muzik yang disyorkan, yang boleh ditukar kemudian oleh pemilik dalam aplikasi TikTok; music_sound_info.music_sound_id menamakan trek perpustakaan tertentu, tanpa medan kelantangan, mula atau tamat pada foto. Di developers.tiktok.com, endpoint foto Content Posting API mempunyai auto_add_music sendiri, yang hanya digunakan apabila post_mode ialah DIRECT_POST, dan endpoint video direct-post tidak mendokumenkan medan muzik.
Apakah maksud Commercial Music Library untuk akaun perniagaan?
Ia ialah muzik yang boleh mereka gunakan. Pusat Bantuan Perniagaan TikTok menerangkan perpustakaan ini sebagai koleksi global yang telah diluluskan terlebih dahulu dengan 1 juta lagu, menyatakan bahawa perniagaan tidak boleh menggunakan perpustakaan muzik umum untuk tujuan komersial, dan menunjukkan mereka kepada Commercial Music Library untuk kandungan organik, termasuk duet, reaksi dan stitch, iklan video dan kandungan berjenama. Pada Akaun Perniagaan, Add Sound dalam aplikasi hanya menunjukkan bunyi perpustakaan, dan API menetapkan had yang sama, kerana music_sound_id menerima ID perpustakaan.
Apa yang tidak dapat dilakukan API dengan muzik?
Beberapa perkara berada di luar medannya, seperti yang diterangkan dalam rujukan TikTok:
- Menamakan bunyi daripada perpustakaan umum TikTok:
music_sound_idmenerima ID Commercial Music Library. - Mencari dalam perpustakaan mengikut tajuk: /discovery/cml/
trending_list/ menapis trek popular mengikut genre, negara dan tempoh. - Mengekalkan muzik pada draf:
upload_to_draftmenjadikan TikTok mengabaikan bakipost_info, danis_drafthanya mengekalkan tajuk dan kapsyen. - Menggunakan trek sendiri dalam siaran organik: /file/music/upload/ menambah muzik untuk kreatif iklan di bawah
advertiser_id, dan notis TikTok di situ meletakkan tanggungjawab hak cipta pada pemuat naik.
Apakah penyelesaian alternatif?
Tiga, setiap satu dibina atas apa yang didokumenkan dalam rujukan TikTok, ditambah satu risiko untuk dipertimbangkan:
- Campurkan muzik ke dalam fail. Kekangan TikTok menerangkan video sebagai kandungan audio-video, jadi runut bunyi yang dicampur akan keluar bersamanya; gunakan audio yang anda miliki hak ke atasnya.
- Hantar draf. Dengan
upload_to_draftatauis_draftdan skop video.upload, siaran akan sampai ke peti masuk TikTok pencipta, untuk disunting dan disiarkan dalam aplikasi. - Biarkan TikTok memilih pada siaran foto.
auto_add_musicmenambah muzik yang disyorkan, dan pemilik boleh menukarnya dalam aplikasi TikTok kemudian. - Risiko dengan audio yang dicampur: rujukan senarai siaran TikTok menamakan pelanggaran hak cipta muzik antara sebab yang mungkin siaran ditapis keluar.
Bagaimana melihat sama ada bunyi membawa tontonan?
Melalui impression_sources, medan /business/video/list/ yang menentukan di mana penonton siaran menemuinya; salah satu nilainya ialah Sound, untuk tayangan yang datang daripada halaman bunyi. Ia memerlukan skop video.insights dan, seperti kiraan lain, tiba lewat 24 hingga 48 jam. Melalui easyCoexistence, get_social_insights mengembalikannya bagi salah satu daripada 20 siaran terkini akaun apabila impression_sources dinamakan dalam metrics, dengan item_id siaran sebagai object_id.
Apa yang dilakukan easyCoexistence dengan muzik?
Ia menerbitkan bunyi yang sudah ada dalam fail anda. publish_tiktok_post, sama ada serta-merta atau dengan scheduled_at, menghantar kapsyen, tajuk siaran foto dan tetapan komen, tanpa music_sound_info dan tanpa auto_add_music, jadi video mengekalkan runut bunyinya sendiri dan siaran foto keluar tanpa muzik. Kod anda sendiri boleh membuat POST ke business/video/publish/ dengan music_sound_info dan token daripada get_social_credentials, tetapi badan itu sampai ke TikTok seperti ditulis, termasuk video_url, dan TikTok hanya mengambil media daripada domain atau awalan URL yang disahkan untuk aplikasi. Laluan /discovery/ menerima token pengiklan, jadi senarai trek berada di luar capaian token akaun.
Kesilapan biasa
- Tidak memasukkan video_original_sound_volume apabila menambah trek. Melalui API nilainya lalai kepada 0, manakala aplikasi TikTok memulakan kedua-dua bunyi pada 50, jadi tetapkannya setiap kali audio asal video penting.
- Menghantar nama trek atau preview_url sebagai music_sound_id. Rujukan trek TikTok menamakan song_clip_id, daripada full_duration_song_clip atau trending_song_clip, sebagai nilai yang perlu dihantar.
- Memanggil /discovery/cml/trending_list/ dengan token pengiklan. Endpoint trek memerlukan token akaun TikTok dan business_id, seperti Accounts API.
- Menganggap tempoh 0 sebagai trek rosak. TikTok menyatakan bahawa trek yang hanya klip daripada sebahagian karya yang lebih panjang mungkin menunjukkan 0, jadi semak pratontonannya sebelum memilih mula dan tamat.
US$ 9 hingga US$ 0.75 setiap sambungan sebulan, turun apabila anda menambah sambungan, dengan 3 hari percubaan percuma.
Soalan lazim
Bolehkah saya menambah mana-mana lagu pada siaran TikTok melalui API?
Lagu dalam Commercial Music Library, mengikut ID. Muzik yang sudah dicampur ke dalam fail video keluar bersama fail itu, jadi ia sepatutnya muzik yang anda ada hak untuk gunakan.
Apakah kelantangan yang ditetapkan API TikTok untuk muzik yang ditambah?
0 secara lalai. music_sound_volume dan video_original_sound_volume berjulat dari 0 hingga 100 dan kedua-duanya lalai kepada 0 melalui API, manakala aplikasi TikTok bermula pada 50, jadi tetapkannya pada setiap video yang ada trek.
Adakah muzik siaran penting jika siaran itu kemudian digunakan dalam iklan?
TikTok menyemaknya: /identity/music/authorization/ melaporkan, untuk lokasi dan tarikh larian iklan, sama ada muzik siaran itu diberi kuasa sepenuhnya, tiada kebenaran, atau tanpa ID lagu.
Berapa banyak lagu ada dalam Commercial Music Library TikTok?
1 juta, menurut Pusat Bantuan Perniagaan TikTok, semuanya telah diluluskan terlebih dahulu untuk kegunaan komersial. /discovery/cml/trending_list/ mengembalikan sehingga 100 yang popular pada satu-satu masa.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada