Menambahkan musik ke unggahan TikTok lewat API
API untuk Bisnis TikTok menambahkan musik dari Commercial Music Library-nya: post_info.music_sound_info menerima music_sound_id sebuah lagu pada unggahan video dan foto, dan pada video juga volume lagu, awal dan akhir dalam milidetik, serta volume suara asli video. Unggahan foto juga dapat menerima auto_add_music untuk musik yang direkomendasikan. ID lagu berasal dari GET /discovery/cml/trending_list/.
easyCoexistence menerbitkan video dan unggahan foto TikTok dengan publish_tiktok_post dari Claude, ChatGPT, atau kode Anda sendiri, sekarang atau pada waktu yang ditetapkan hingga 90 hari ke depan, dan video terkirim dengan soundtrack yang sudah tercampur ke dalam file-nya.
Lagu terpopuler yang dikembalikan /discovery/cml/trending_list/, semuanya sudah diizinkan untuk konten organik dan pembuatan iklan.
Rentang music_sound_volume dan video_original_sound_volume; lewat API keduanya bernilai 0 secara default, sementara aplikasi TikTok mulai dari 50.
Lagu di Commercial Music Library TikTok, pustaka global yang sudah diizinkan sebelumnya dan digunakan bisnis untuk aktivitas komersial di TikTok.
Kreatif yang dibuat dengan musik dari daftar musik iklan TikTok dapat ditayangkan, kecuali pemegang hak memberikan izin terpisah.
Satu-satunya post_mode yang menerapkan auto_add_music pada endpoint foto Content Posting API, di developers.tiktok.com.
Field musik mana yang diterima endpoint publikasi TikTok?
Kedua endpoint membawa musik di dalam post_info, di bawah music_sound_info, dan menyebut lagu dengan ID Commercial Music Library-nya. Selebihnya keduanya berbeda: endpoint video menambahkan kontrol pencampuran, dan endpoint foto menambahkan sakelar yang membiarkan TikTok memilih musik. Berdampingan, seperti tercantum di referensi 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 cara menambahkan lagu ke video?
Kirim music_sound_info di dalam post_info pada POST /business/video/publish/. Setelah objek itu ada, music_sound_id dan music_sound_volume wajib diisi. music_sound_start dan music_sound_end memilih bagian lagu dalam milidetik, dari awal lagu hingga panjang penuh video secara default, sehingga video 2 detik mengambil 2,000 milidetik pertama lagu. Atur juga video_original_sound_volume setiap kali suara asli video penting, karena nilainya 0 secara default:
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 lagu berasal?
Dari GET /discovery/cml/trending_list/, endpoint Discovery API yang menerima access token akun TikTok dan business_id, sedangkan endpoint hashtag Discovery menerima token pengiklan. Referensi TikTok mencatatnya di bawah izin Discovery pada Creative Management. Endpoint ini mengembalikan hingga 100 lagu populer, masing-masing dengan nama, artis, durasi, peringkat, genre, sebuah preview_url yang tidak kedaluwarsa, dan hingga 30 hari dari trending_history. full_duration_song_clip dan trending_song_clip masing-masing memuat song_clip_id, nilai yang oleh TikTok disebut sebagai music_sound_id:
- genre: ALL secara default, atau salah satu dari lebih dari 100 nilai seperti POP, LATIN, LO-FI atau SERTANEJO.
country_code: US secara default.date_range: 1DAY, 7DAY secara default, 30DAY atau 90DAY.- /discovery/cml/
video_list/: 20 video trending teratas yang menggunakan sebuah lagu, berdasarkancommercial_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 unggahan foto mendapatkan musik?
Ada dua cara di POST /business/photo/publish/. auto_add_music yang diatur true membuat TikTok menambahkan musik rekomendasi, yang nantinya dapat diganti pemilik di aplikasi TikTok. music_sound_info.music_sound_id menyebut satu lagu tertentu dari pustaka, tanpa kolom volume, awal, atau akhir pada foto. Di developers.tiktok.com, endpoint foto Content Posting API memiliki auto_add_music sendiri, yang hanya berlaku saat post_mode adalah DIRECT_POST, dan endpoint video direct-post-nya tidak mendokumentasikan kolom musik.
Apa arti Commercial Music Library bagi akun bisnis?
Ini adalah musik yang boleh mereka gunakan. Pusat Bantuan Bisnis TikTok menggambarkan pustaka ini sebagai kumpulan global yang sudah diizinkan sebelumnya berisi 1 juta lagu, menyatakan bahwa bisnis tidak dapat menggunakan pustaka musik umum untuk penggunaan komersial, dan mengarahkan mereka ke Commercial Music Library untuk konten organik, termasuk duet, reaksi, dan stitch, iklan video, serta konten bermerek. Pada akun bisnis, Add Sound di aplikasi hanya menampilkan suara dari pustaka, dan API menarik garis yang sama, karena music_sound_id menerima ID pustaka.
Apa yang tidak dapat dilakukan API dengan musik?
Beberapa hal berada di luar kolomnya, sebagaimana dijelaskan referensi TikTok:
- Menyebut lagu dari pustaka umum TikTok:
music_sound_idmenerima ID Commercial Music Library. - Mencari pustaka berdasarkan judul: /discovery/cml/
trending_list/ menyaring lagu populer berdasarkan genre, negara, dan periode. - Menyimpan musik pada draf:
upload_to_draftmembuat TikTok mengabaikan sisapost_info, danis_drafthanya menyimpan judul dan keterangan. - Menggunakan lagu sendiri pada unggahan organik: /file/music/upload/ menambahkan musik untuk kreatif iklan di bawah
advertiser_id, dan pemberitahuan TikTok di sana menyerahkan tanggung jawab hak cipta kepada pengunggah.
Apa saja cara mengakalinya?
Tiga cara, masing-masing dibangun di atas apa yang didokumentasikan referensi TikTok, ditambah satu risiko yang perlu dipertimbangkan:
- Campurkan musik ke dalam file. Batasan TikTok menggambarkan video sebagai konten audio-video, sehingga soundtrack yang sudah tercampur ikut terkirim bersamanya; gunakan audio yang Anda miliki haknya.
- Kirim sebagai draf. Dengan
upload_to_draftatauis_draftdan scope video.upload, unggahan masuk ke kotak masuk TikTok milik kreator, untuk diedit dan diunggah di aplikasi. - Biarkan TikTok memilih pada unggahan foto.
auto_add_musicmenambahkan musik rekomendasi, dan pemilik dapat menggantinya di aplikasi TikTok nanti. - Risiko dengan audio tercampur: daftar unggahan TikTok menyebut pelanggaran hak cipta musik sebagai salah satu alasan yang mungkin membuat unggahan difilter.
Bagaimana melihat apakah sebuah suara mendatangkan tayangan?
Melalui impression_sources, kolom /business/video/list/ yang memeringkat dari mana penonton sebuah unggahan menemukannya; salah satu nilainya adalah Sound, untuk tayangan yang berasal dari halaman suara. Kolom ini membutuhkan scope video.insights dan, seperti hitungan lainnya, tiba terlambat 24 hingga 48 jam. Lewat easyCoexistence, get_social_insights mengembalikannya untuk salah satu dari 20 unggahan terbaru akun, jika impression_sources disebut dalam metrics, dengan item_id unggahan sebagai object_id.
Apa yang dilakukan easyCoexistence dengan musik?
Ia menerbitkan suara yang sudah ada di dalam file Anda. publish_tiktok_post, sekarang atau dengan scheduled_at, mengirim keterangan, judul unggahan foto, dan pengaturan komentar, tanpa music_sound_info dan tanpa auto_add_music, sehingga video tetap memakai soundtrack-nya sendiri dan unggahan foto terbit tanpa musik. Kode Anda sendiri dapat mengirim POST ke business/video/publish/ dengan music_sound_info dan token dari get_social_credentials, tetapi body tersebut sampai ke TikTok apa adanya, termasuk video_url, dan TikTok hanya mengambil media dari domain atau prefiks URL yang diverifikasi untuk aplikasi. Jalur /discovery/ membutuhkan token pengiklan, sehingga daftar lagu tidak terjangkau oleh token akun.
Kesalahan umum
- Membiarkan video_original_sound_volume kosong saat menambahkan lagu. Lewat API nilainya 0 secara default, sementara aplikasi TikTok memulai kedua suara di 50, jadi atur setiap kali suara asli video penting.
- Mengirim nama lagu atau preview_url sebagai music_sound_id. Referensi lagu TikTok menyebut song_clip_id, dari full_duration_song_clip atau trending_song_clip, sebagai nilai yang perlu dikirim.
- Memanggil /discovery/cml/trending_list/ dengan token pengiklan. Endpoint lagu menerima access token akun TikTok dan business_id, seperti API akun.
- Menganggap durasi 0 sebagai lagu yang rusak. TikTok mencatat bahwa lagu yang hanya berupa klip dari karya yang lebih panjang dapat menampilkan 0, jadi periksa pratinjaunya sebelum memilih awal dan akhir.
Mulai dari US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Bisakah saya menambahkan lagu apa pun ke unggahan TikTok lewat API?
Lagu dari Commercial Music Library, lewat ID. Musik yang sudah tercampur ke dalam file video ikut terkirim bersama file itu, jadi sebaiknya itu musik yang Anda punya hak untuk digunakan.
Berapa volume yang diatur API TikTok untuk musik yang ditambahkan?
0 secara default. music_sound_volume dan video_original_sound_volume berjalan dari 0 hingga 100 dan keduanya bernilai 0 secara default lewat API, sementara aplikasi TikTok mulai di 50, jadi atur keduanya pada setiap video yang memiliki lagu.
Apakah musik sebuah unggahan berpengaruh jika unggahan itu nanti dipakai dalam iklan?
TikTok memeriksanya: /identity/music/authorization/ melaporkan, untuk lokasi dan tanggal tayang iklan, apakah musik unggahan sudah diotorisasi penuh, belum diotorisasi, atau tanpa ID lagu.
Berapa lagu di Commercial Music Library TikTok?
1 juta, menurut Pusat Bantuan Bisnis TikTok, semuanya sudah diizinkan untuk penggunaan komersial. /discovery/cml/trending_list/ mengembalikan hingga 100 yang populer setiap kali.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada