एपीआई के ज़रिए TikTok पोस्ट में संगीत जोड़ना
TikTok का API for Business अपनी Commercial Music Library से संगीत जोड़ता है: post_info.music_sound_info वीडियो और फ़ोटो दोनों पोस्ट पर किसी ट्रैक का music_sound_id लेता है, और वीडियो पर ट्रैक का वॉल्यूम, मिलीसेकंड में उसकी शुरुआत और अंत, तथा वीडियो की अपनी आवाज़ का वॉल्यूम भी। फ़ोटो पोस्ट अनुशंसित संगीत के लिए auto_add_music भी ले सकती है। ट्रैक ID GET /discovery/cml/trending_list/ से आते हैं।
easyCoexistence Claude, ChatGPT या अपने कोड से publish_tiktok_post के साथ TikTok वीडियो और फ़ोटो पोस्ट प्रकाशित करता है, अभी या 90 दिन आगे तक के तय समय पर, और वीडियो अपनी फ़ाइल में मिले साउंडट्रैक के साथ जाता है।
/discovery/cml/trending_list/ से मिलने वाले सबसे लोकप्रिय ट्रैक, सभी जैविक कंटेंट और विज्ञापन क्रिएटिव के लिए पहले से मंज़ूर।
music_sound_volume और video_original_sound_volume की रेंज; एपीआई के ज़रिए दोनों डिफ़ॉल्ट रूप से 0 होते हैं, जबकि TikTok ऐप 50 से शुरू होता है।
TikTok की Commercial Music Library के गाने, पहले से मंज़ूर वैश्विक लाइब्रेरी, जिसे कारोबार TikTok पर व्यावसायिक गतिविधि के लिए उपयोग करते हैं।
जहाँ TikTok के विज्ञापन म्यूज़िक सूची के संगीत से बने क्रिएटिव दिखाए जा सकते हैं, जब तक अधिकार धारक अलग अनुमति न दें।
वह एकमात्र post_mode जिसमें Content Posting API का फ़ोटो एंडपॉइंट auto_add_music लागू करता है, developers.tiktok.com पर।
TikTok के पब्लिश एंडपॉइंट कौन से संगीत फ़ील्ड लेते हैं?
दोनों एंडपॉइंट संगीत को post_info के भीतर music_sound_info में रखते हैं और ट्रैक को उसकी Commercial Music Library ID से नाम देते हैं। इसके आगे वे अलग हैं: वीडियो एंडपॉइंट मिक्सिंग नियंत्रण जोड़ता है, और फ़ोटो एंडपॉइंट एक स्विच जोड़ता है जिससे 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 |
वीडियो में ट्रैक कैसे जोड़ें?
POST /business/video/publish/ पर post_info के भीतर music_sound_info भेजें। ऑब्जेक्ट मौजूद होने पर music_sound_id और music_sound_volume अनिवार्य हैं। music_sound_start और music_sound_end ट्रैक का हिस्सा मिलीसेकंड में चुनते हैं, डिफ़ॉल्ट रूप से ट्रैक की शुरुआत से वीडियो की पूरी लंबाई तक, इसलिए 2 सेकंड का वीडियो ट्रैक के पहले 2,000 मिलीसेकंड लेता है। जब भी वीडियो की अपनी आवाज़ मायने रखती है, 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
}
}
}'ट्रैक ID कहाँ से आते हैं?
GET /discovery/cml/trending_list/ से, एक Discovery API एंडपॉइंट जो TikTok खाते का एक्सेस टोकन और business_id लेता है, जबकि Discovery हैशटैग एंडपॉइंट विज्ञापनदाता का लेते हैं; TikTok का संदर्भ इसे Creative Management के Discovery परमिशन के अंतर्गत रखता है। यह 100 तक लोकप्रिय ट्रैक लौटाता है, हर एक के साथ नाम, कलाकार, अवधि, रैंक, शैलियाँ, एक preview_url जो समाप्त नहीं होता, और 30 दिनों तक का trending_history। full_duration_song_clip और trending_song_clip में से हर एक song_clip_id रखता है, वह मान जिसे TikTok music_sound_id के लिए नाम देता है:
- genre: डिफ़ॉल्ट रूप से ALL, या 100 से अधिक मानों में से एक, जैसे POP, LATIN, LO-FI या SERTANEJO।
country_code: डिफ़ॉल्ट रूप से US।date_range: 1DAY, डिफ़ॉल्ट रूप से 7DAY, 30DAY या 90DAY।- /discovery/cml/
video_list/: किसी ट्रैक का उपयोग करने वाले शीर्ष 20 ट्रेंडिंग वीडियो, उसकेcommercial_music_idऔरcountry_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'फ़ोटो पोस्ट को संगीत कैसे मिलता है?
POST /business/photo/publish/ पर दो तरीके हैं। auto_add_music को true पर सेट करने पर TikTok अनुशंसित संगीत जोड़ता है, जिसे मालिक बाद में TikTok ऐप में बदल सकता है; music_sound_info.music_sound_id किसी विशेष लाइब्रेरी ट्रैक का नाम देता है, और फ़ोटो पर कोई volume, start या end फ़ील्ड नहीं होते। developers.tiktok.com पर, Content Posting API के फ़ोटो एंडपॉइंट का अपना auto_add_music है, जो केवल तब लागू होता है जब post_mode DIRECT_POST हो, और इसके direct-post वीडियो एंडपॉइंट में कोई संगीत फ़ील्ड दस्तावेज़ित नहीं है।
Commercial Music Library व्यावसायिक खातों के लिए क्या मायने रखती है?
यह वह संगीत है जिसका वे उपयोग कर सकते हैं। TikTok का Business Help Center इस लाइब्रेरी को 1 million गानों का पहले से मंज़ूर वैश्विक संग्रह बताता है, कहता है कि कारोबार सामान्य म्यूज़िक लाइब्रेरी का व्यावसायिक उपयोग नहीं कर सकते, और उन्हें जैविक कंटेंट, duets, reacts और stitches सहित, वीडियो विज्ञापनों और ब्रांडेड कंटेंट के लिए Commercial Music Library की ओर भेजता है। Business Account पर, ऐप में Add Sound केवल लाइब्रेरी की साउंड दिखाता है, और एपीआई वही रेखा खींचता है, क्योंकि music_sound_id लाइब्रेरी ID लेता है।
एपीआई से संगीत के साथ क्या नहीं हो सकता?
कुछ चीज़ें इसके फ़ील्ड से बाहर हैं, जैसा कि TikTok के संदर्भ बताते हैं:
- TikTok की सामान्य लाइब्रेरी से किसी साउंड का नाम देना:
music_sound_idCommercial Music Library ID लेता है। - शीर्षक से लाइब्रेरी खोजना: /discovery/cml/
trending_list/ लोकप्रिय ट्रैक को शैली, देश और अवधि से फ़िल्टर करता है। - ड्राफ़्ट पर संगीत रखना:
upload_to_draftTikTok कोpost_infoके बाकी हिस्से को अनदेखा करवाता है, औरis_draftकेवल शीर्षक और कैप्शन रखता है। - जैविक पोस्ट में अपना ट्रैक इस्तेमाल करना: /file/music/upload/ विज्ञापन क्रिएटिव के लिए
advertiser_idके तहत संगीत जोड़ता है, और वहाँ TikTok की सूचना कॉपीराइट की ज़िम्मेदारी अपलोड करने वाले पर छोड़ती है।
इसके उपाय क्या हैं?
तीन, हर एक वह जो TikTok के संदर्भ में दस्तावेज़ित है, साथ में एक जोखिम जिसे तौलना है:
- संगीत को फ़ाइल में मिलाएँ। TikTok की बाधाएँ वीडियो को audio-video कंटेंट बताती हैं, इसलिए फ़ाइल में मिला साउंडट्रैक उसी के साथ जाता है; ऐसा ऑडियो उपयोग करें जिसके अधिकार आपके पास हों।
- ड्राफ़्ट भेजें।
upload_to_draftयाis_draftऔर video.upload स्कोप के साथ, पोस्ट क्रिएटर के TikTok इनबॉक्स में जाती है, जिसे ऐप में संपादित करके पोस्ट किया जा सकता है। - फ़ोटो पोस्ट पर TikTok को चुनने दें।
auto_add_musicअनुशंसित संगीत जोड़ता है, और मालिक इसे बाद में TikTok ऐप में बदल सकता है। - मिश्रित ऑडियो का जोखिम: TikTok की पोस्ट सूची संगीत कॉपीराइट उल्लंघन को उन संभावित कारणों में गिनाती है जिनसे पोस्ट फ़िल्टर हो सकती है।
पता कैसे चलेगा कि किसी साउंड से व्यूज़ आए?
impression_sources के ज़रिए, /business/video/list/ का एक फ़ील्ड जो रैंक करता है कि पोस्ट के दर्शक उसे कहाँ से पाते हैं; इसका एक मान Sound है, उन व्यूज़ के लिए जो साउंड पेजों से आए। इसे video.insights स्कोप चाहिए और, बाकी गिनतियों की तरह, 24 से 48 घंटे देर से आता है। easyCoexistence के ज़रिए, get_social_insights खाते की 20 सबसे नई पोस्ट में से एक के लिए इसे लौटाता है, जब metrics में impression_sources नाम दिया गया हो, और पोस्ट का item_id object_id के रूप में।
easyCoexistence संगीत के साथ क्या करता है?
यह फ़ाइल में पहले से मौजूद साउंड को प्रकाशित करता है। publish_tiktok_post, अभी या scheduled_at के साथ, कैप्शन, फ़ोटो पोस्ट का शीर्षक और कमेंट सेटिंग भेजता है, बिना music_sound_info और बिना auto_add_music के, इसलिए वीडियो अपना साउंडट्रैक रखता है और फ़ोटो पोस्ट बिना संगीत के जाती है। आपका अपना कोड get_social_credentials के टोकन के साथ business/video/publish/ पर music_sound_info के साथ POST कर सकता है, लेकिन वह बॉडी जैसी लिखी है वैसी ही TikTok तक पहुँचती है, video_url समेत, और TikTok मीडिया केवल उन डोमेन या URL प्रीफ़िक्स से लाता है जो ऐप के लिए सत्यापित हों। /discovery/ पाथ विज्ञापनदाता का टोकन लेते हैं, इसलिए ट्रैक सूची खाते के टोकन की पहुँच से बाहर है।
आम गड़बड़ियाँ
- किसी ट्रैक को जोड़ते समय video_original_sound_volume छोड़ देना। एपीआई के ज़रिए यह डिफ़ॉल्ट रूप से 0 होता है, जबकि TikTok ऐप दोनों साउंड 50 से शुरू करता है, इसलिए जब भी वीडियो की अपनी आवाज़ मायने रखे, इसे सेट करें।
- ट्रैक का नाम या preview_url को music_sound_id के रूप में भेजना। TikTok का ट्रैक संदर्भ full_duration_song_clip या trending_song_clip से song_clip_id को वह मान बताता है जो भेजा जाना चाहिए।
- /discovery/cml/trending_list/ को विज्ञापनदाता टोकन के साथ बुलाना। ट्रैक एंडपॉइंट TikTok खाते का टोकन और business_id लेते हैं, जैसे Accounts API लेता है।
- अवधि 0 को टूटा हुआ ट्रैक समझना। TikTok नोट करता है कि लंबे टुकड़े का सिर्फ़ क्लिप हो सकने वाला ट्रैक 0 दिखा सकता है, इसलिए start और end चुनने से पहले उसका preview जाँचें।
प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन बढ़ने पर दर घटती है, और पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या मैं एपीआई के ज़रिए TikTok पोस्ट में कोई भी गाना जोड़ सकता हूँ?
Commercial Music Library के गाने, ID से। फ़ाइल में पहले से मिला संगीत वीडियो फ़ाइल के साथ ही जाता है, इसलिए वह संगीत होना चाहिए जिसके उपयोग के अधिकार आपके पास हों।
TikTok का एपीआई जोड़े गए संगीत के लिए कौन सा वॉल्यूम सेट करता है?
डिफ़ॉल्ट रूप से 0। music_sound_volume और video_original_sound_volume 0 से 100 तक चलते हैं, और एपीआई के ज़रिए दोनों डिफ़ॉल्ट रूप से 0 होते हैं, जबकि TikTok ऐप 50 से शुरू होता है, इसलिए ट्रैक वाले हर वीडियो पर इन्हें सेट करें।
क्या पोस्ट का संगीत मायने रखता है अगर पोस्ट बाद में विज्ञापन में इस्तेमाल हो?
TikTok इसकी जाँच करता है: /identity/music/authorization/ विज्ञापन के स्थानों और चलने की तारीखों के लिए बताता है कि पोस्ट का संगीत पूरी तरह अधिकृत है, अधिकृत नहीं है, या उसके पास song ID नहीं है।
TikTok की Commercial Music Library में कितने गाने हैं?
1 million, TikTok के Business Help Center के अनुसार, सभी व्यावसायिक उपयोग के लिए पहले से मंज़ूर। /discovery/cml/trending_list/ एक बार में 100 तक लोकप्रिय गाने लौटाता है।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित