API හරහා TikTok posts වලට සංගීතය එක් කිරීම
TikTok API for Business සංගීතය එක් කරන්නේ එහි Commercial Music Library වෙතින්: post_info.music_sound_info මගින් video සහ photo posts දෙකටම track එකේ music_sound_id ගන්නා අතර, video වලදී track එකේ ශබ්ද මට්ටම, milliseconds වලින් ආරම්භය සහ අවසානය, සහ video එකේම ශබ්දයේ මට්ටමද ගනී. Photo posts වලට නිර්දේශිත සංගීතය සඳහා auto_add_music ද ගත හැක. Track IDs ලැබෙන්නේ GET /discovery/cml/trending_list/ වලින්.
easyCoexistence, Claude, ChatGPT හෝ ඔබේ කේතයෙන්, publish_tiktok_post සමඟ TikTok videos සහ photo posts පළ කරයි, දැන් හෝ දින 90 ක් දක්වා ඉදිරියට සකසන ලද වේලාවක, සහ video එකක් එහි ගොනුවට මිශ්ර කළ soundtrack එක සමඟ පිටවේ.
/discovery/cml/trending_list/ මගින් ලැබෙන වඩාත් ජනප්රිය tracks, සියල්ල organic content සහ ad නිර්මාණය සඳහා පූර්ව-අනුමත.
music_sound_volume සහ video_original_sound_volume හි පරාසය; API හරහා දෙකම පෙරනිමියෙන් 0 වන අතර, TikTok app එක 50 න් ආරම්භ වේ.
TikTok හි Commercial Music Library හි ගීත, ව්යාපාර TikTok හි වාණිජ ක්රියාකාරකම් සඳහා භාවිතා කරන පූර්ව-අනුමත ගෝලීය පුස්තකාලය.
TikTok ads music list එකේ සංගීතය භාවිත කළ creatives සේවා සැපයිය හැකි ස්ථාන, හිමිකරුවන් වෙනම අවසර නොදුන්නොත් හැර.
developers.tiktok.com හි, Content Posting API හි photo endpoint එක auto_add_music යොදන එකම post_mode එක.
TikTok හි publish endpoint වලට ගෙන යන සංගීත fields මොනවාද?
දෙකම සංගීතය post_info ඇතුළත, music_sound_info යටතේ රැගෙන යන අතර track එක Commercial Music Library ID එකෙන් නම් කරයි. ඊට අමතරව ඒවා වෙනස් වේ: video endpoint එකට මිශ්රණ පාලන එකතු වන අතර, photo endpoint එකට TikTok විසින් සංගීතය තෝරාගැනීමට ඉඩ දෙන ස්විචයක් එකතු වේ. 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 |
Video එකකට track එකක් එක් කරන්නේ කෙසේද?
POST /business/video/publish/ හි post_info ඇතුළත music_sound_info යවන්න. Object එක ඇතුළත වූ පසු music_sound_id සහ music_sound_volume අනිවාර්ය වේ. music_sound_start සහ music_sound_end මගින් track එකේ කොටස milliseconds වලින් තෝරයි; පෙරනිමියෙන් track එකේ ආරම්භයේ සිට video එකේ සම්පූර්ණ දිග දක්වා, එබැවින් තත්පර 2 ක video එකක් track එකේ පළමු 2,000 milliseconds ගනී. Video එකේම ශබ්දය වැදගත් වන විට video_original_sound_volume ද සකසන්න; එය පෙරනිමියෙන් 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
}
}
}'Track IDs ලැබෙන්නේ කොහෙන්ද?
GET /discovery/cml/trending_list/ වලින්, TikTok account එකක access token සහ business_id ගන්නා Discovery API endpoint එකකි; Discovery hashtag endpoints ගන්නේ advertiser එකේ ඒවා. TikTok ගේ යොමු ලේඛනය මෙය Creative Management හි Discovery permission යටතේ සටහන් කරයි. එය ජනප්රිය tracks 100 දක්වා ලබා දෙන අතර, සෑම එකක්ම නම, artist, දිග, rank, genres, කල් ඉකුත් නොවන preview_url සහ දින 30 දක්වා trending_history සමඟ. full_duration_song_clip සහ trending_song_clip එක බැගින් song_clip_id එකක් දරයි; TikTok එය music_sound_id ලෙස නම් කරන අගයයි:
- genre: පෙරනිමිය ALL, හෝ POP, LATIN, LO-FI හෝ SERTANEJO වැනි අගය 100 කට වැඩි එකක්.
country_code: පෙරනිමිය US.date_range: 1DAY, පෙරනිමියෙන් 7DAY, 30DAY හෝ 90DAY.- /discovery/cml/
video_list/: එහිcommercial_music_idසහcountry_codeමගින්, track එක භාවිත කරන ඉහළම trending videos 20.
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'Photo posts වලට සංගීතය ලැබෙන්නේ කෙසේද?
POST /business/photo/publish/ හි මාර්ග දෙකකින්. auto_add_music true ලෙස සැකසීමෙන් TikTok නිර්දේශිත සංගීතය එක් කරයි, එය හිමිකරුට පසුව TikTok app එකේ වෙනස් කළ හැක; music_sound_info.music_sound_id මගින් විශේෂිත library track එකක් නම් කරයි, photos සඳහා volume, start හෝ end fields නැත. developers.tiktok.com හි Content Posting API හි photo endpoint එකට තමන්ගේම auto_add_music ඇත, එය post_mode DIRECT_POST වන විට පමණක් යෙදේ; එහි direct-post video endpoint එකේ සංගීත field එකක් ලේඛනගත කර නැත.
ව්යාපාර accounts සඳහා Commercial Music Library හි අර්ථය කුමක්ද?
එය ඔවුන්ට භාවිත කළ හැකි සංගීතයයි. TikTok ගේ Business Help Center මෙම library එක විස්තර කරන්නේ ගීත මිලියන 1 ක පූර්ව-අනුමත ගෝලීය එකතුවක් ලෙසයි, ව්යාපාරවලට සාමාන්ය සංගීත library එක වාණිජ භාවිතයට භාවිත කළ නොහැකි බවත් කියයි; organic content, duets, reacts සහ stitches ඇතුළුව, video ads සහ branded content සඳහා Commercial Music Library වෙත යොමු කරයි. Business Account එකක, app එකේ Add Sound පෙන්වන්නේ library ශබ්ද පමණි, API එකත් එම රේඛාවම අඳින්නේ, මන්ද music_sound_id ගන්නේ library ID එකකි.
API හට සංගීතය සමඟ කළ නොහැකි දේ මොනවාද?
යම් දේවල් එහි fields වලින් පිටත පවතී, TikTok ගේ යොමු ලේඛන විස්තර කරන ආකාරයට:
- TikTok ගේ සාමාන්ය library එකෙන් ශබ්දයක් නම් කිරීම:
music_sound_idගන්නේ Commercial Music Library ID එකකි. - Title අනුව library එක සෙවීම: /discovery/cml/
trending_list/ ජනප්රිය tracks genre, රට සහ කාලය අනුව පෙරයි. - Draft එකක සංගීතය තබා ගැනීම:
upload_to_draftමගින් TikTokpost_infoහි ඉතිරි කොටස නොසලකා හරියි, සහis_draftමගින් title සහ caption පමණක් තබයි. - Organic post එකක ඔබේම track භාවිත කිරීම: /file/music/upload/ මගින්
advertiser_idයටතේ ad creatives සඳහා සංගීතය එක් කරයි, සහ එහි TikTok දැනුම් දීම ප්රකාශන වගකීම upload කරන්නා වෙත තබයි.
Workarounds මොනවාද?
තුනක්, ඒ සෑම එකක්ම TikTok ගේ යොමු ලේඛනවල ලේඛනගත කර ඇති දේ මත ගොඩනැගී ඇත, සහ තක්සේරු කළ යුතු අවදානමක් එක:
- සංගීතය ගොනුවට මිශ්ර කරන්න. TikTok ගේ සීමා video එක audio-video අන්තර්ගතයක් ලෙස විස්තර කරන බැවින්, මිශ්ර කළ soundtrack එක එය සමඟ පිටවේ; ඔබට හිමිකම් ඇති audio භාවිත කරන්න.
- Draft එකක් යවන්න.
upload_to_draftහෝis_draftසහ video.upload scope සමඟ, post එක නිර්මාණකරුගේ TikTok inbox එකට පැමිණේ, app එකේ සංස්කරණය කර පළ කිරීමට. - Photo posts වලට TikTok තේරීමට ඉඩ දෙන්න.
auto_add_musicනිර්දේශිත සංගීතය එක් කරයි, හිමිකරුට පසුව TikTok app එකේ එය වෙනස් කළ හැක. - මිශ්ර audio සමඟ අවදානම: TikTok ගේ post list යොමු ලේඛනය music copyright violations ලෙස නම් කරයි, post එකක් පෙරා දමනු ලැබීමට ඉඩ ඇති හේතු අතරින් එකක් ලෙස.
සංගීතයක් views ගෙනාවාදැයි බලන්නේ කෙසේද?
impression_sources හරහා, එය /business/video/list/ field එකක් වන අතර post එකේ viewers එය සොයාගත් ස්ථාන ශ්රේණිගත කරයි; එහි අගයන් අතරින් එකක් Sound ය, sound පිටු වලින් පැමිණි views සඳහා. එයට video.insights scope අවශ්ය වන අතර, අනෙක් ගණන් මෙන්, පැය 24 සිට 48 දක්වා ප්රමාදව ලැබේ. easyCoexistence හරහා, get_social_insights එය ගිණුමේ අවසාන post 20 න් එකක් සඳහා ලබා දෙයි, metrics හි impression_sources නම් කළ විට, post එකේ item_id object_id ලෙස.
easyCoexistence සංගීතය සමඟ කරන්නේ කුමක්ද?
එය දැනටමත් ඔබේ ගොනුවේ ඇති ශබ්දය පළ කරයි. publish_tiktok_post, දැන් හෝ scheduled_at සමඟ, caption, photo post එකේ title සහ comment සැකසීම යවයි, music_sound_info සහ auto_add_music නැතිව; එබැවින් video එකක් තමන්ගේම soundtrack එක තබාගන්නා අතර photo post එකක් සංගීතයකින් තොරව පිටවේ. ඔබේ කේතයට get_social_credentials වෙතින් ලබාගත් token සමඟ music_sound_info සහිතව business/video/publish/ වෙත POST කළ හැක, නමුත් එම body එක video_url ඇතුළුව ලිඛිත ආකාරයට TikTok වෙත ළඟා වන අතර, TikTok media ලබා ගන්නේ app සඳහා සත්යාපනය කළ domains හෝ URL prefixes වලින් පමණි. /discovery/ paths advertiser කෙනෙකුගේ token ගන්නා බැවින්, track ලැයිස්තුව ගිණුමේ token එකේ පරාසයෙන් බැහැරයි.
සාමාන්ය වැරදි
- Track එකක් එක් කරන විට video_original_sound_volume ඉවත් කිරීම. API හරහා එය පෙරනිමියෙන් 0 වන අතර, TikTok app එක ශබ්ද දෙකම 50 න් ආරම්භ කරයි, එබැවින් video එකේම ශබ්දය වැදගත් වන විට එය සකසන්න.
- Track එකේ නම හෝ preview_url music_sound_id ලෙස යැවීම. TikTok ගේ track යොමුව song_clip_id නම් කරයි, full_duration_song_clip හෝ trending_song_clip වලින්, යැවිය යුතු අගය ලෙස.
- /discovery/cml/trending_list/ advertiser token සමඟ කැඳවීම. Track endpoints ගන්නේ TikTok account එකේ token සහ business_id ය, Accounts API එක මෙන්.
- Duration 0 ක් තිබීම කැඩුණු track එකක් ලෙස කියවීම. TikTok සටහන් කරන්නේ දිගු කෘතියක clip එකක් පමණක් වන track එකක් 0 පෙන්විය හැකි බවයි, එබැවින් ආරම්භය සහ අවසානය තේරීමට පෙර එහි preview එක පරීක්ෂා කරන්න.
සම්බන්ධතාවයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට අඩුවෙයි, පළමු දින 3 ක නොමිලේ trial කාලය සමඟ.
නිතර අසන ප්රශ්න
API හරහා TikTok post එකකට ඕනෑම ගීතයක් එක් කළ හැකිද?
Commercial Music Library හි ගීත, ID අනුව. Video ගොනුවට දැනටමත් මිශ්ර කළ සංගීතය ගොනුව සමඟ පිටවේ, එබැවින් එය භාවිත කිරීමට ඔබට හිමිකම් ඇති සංගීතය විය යුතුය.
TikTok API එක එක් කළ සංගීතයට සකසන්නේ කුමන ශබ්ද මට්ටමද?
පෙරනිමිය 0. music_sound_volume සහ video_original_sound_volume 0 සිට 100 දක්වා පරාසයේ වන අතර, API හරහා දෙකම පෙරනිමියෙන් 0 වේ, TikTok app එක 50 න් ආරම්භ වන අතර, එබැවින් track එකක් ඇති සෑම video එකකම ඒවා සකසන්න.
Post එකේ සංගීතය, පසුව ad එකක භාවිත වුවහොත් එයට වැදගත්ද?
TikTok එය පරීක්ෂා කරයි: /identity/music/authorization/ මගින්, ad හි ස්ථාන සහ ධාවන දින සඳහා, post එකේ සංගීතය සම්පූර්ණයෙන් අවසර ලැබ ඇත්දැයි, අවසරය නැත්දැයි, හෝ song ID එකක් නැත්දැයි වාර්තා කරයි.
TikTok ගේ Commercial Music Library හි ගීත කීයක් තිබේද?
ගීත මිලියන 1 ක්, TikTok ගේ Business Help Center අනුව, සියල්ලම වාණිජ භාවිතයට පූර්ව-අනුමත. /discovery/cml/trending_list/ එකවර වැඩිම 100 ක් ලබා දෙයි.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ