إضافة الموسيقى إلى منشورات TikTok عبر API
تضيف واجهة TikTok للأعمال الموسيقى من مكتبة الموسيقى التجارية الخاصة بها: يأخذ music_sound_info داخل post_info معرّف music_sound_id الخاص بالمقطع في الفيديوهات ومنشورات الصور، وفي الفيديوهات أيضًا حجم المقطع وبدايته ونهايته بالميلي ثانية، وحجم الصوت الأصلي للفيديو. ويمكن لمنشورات الصور أن تأخذ أيضًا auto_add_music لاقتراح موسيقى. وتُستخرج معرّفات المقاطع من المسار GET /discovery/cml/trending_list/ الذي يُرجع المقاطع الرائجة.
تنشر easyCoexistence فيديوهات TikTok ومنشورات الصور باستخدام publish_tiktok_post من Claude أو ChatGPT أو من كودك الخاص، فورًا أو في موعد محدد حتى 90 يومًا مقدمًا، ويخرج الفيديو بالموسيقى الممزوجة في ملفه.
أشهر المقاطع التي يُرجعها /discovery/cml/trending_list/، وكلها معتمدة مسبقًا للمحتوى العضوي وإنشاء الإعلانات.
نطاق music_sound_volume وvideo_original_sound_volume؛ عبر الواجهة تكون القيمتان 0 افتراضيًا، بينما يبدأ تطبيق TikTok من 50.
أغانٍ في مكتبة الموسيقى التجارية لدى TikTok، المكتبة العالمية المعتمدة مسبقًا التي تستخدمها الأنشطة التجارية على المنصة.
قد تُعرض الإعلانات المصنوعة بموسيقى من قائمة TikTok الإعلانية في أماكن معيّنة، ما لم يمنح أصحاب الحقوق إذنًا منفصلًا.
في developers.tiktok.com، تطبّق نقطة نهاية الصور في Content Posting API الخاصية auto_add_music فقط عندما تكون قيمة post_mode هي DIRECT_POST، أي النشر المباشر.
ما حقول الموسيقى التي تقبلها نقاط نشر TikTok؟
تحمل نقطتا النهاية الموسيقى داخل post_info، ضمن music_sound_info، وتحددان المقطع بمعرّفه في مكتبة الموسيقى التجارية. وبعد ذلك تختلفان: تضيف نقطة نهاية الفيديو أدوات المزج، وتضيف نقطة نهاية الصور مفتاحًا يتيح لـ 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 |
كيف تضيف مقطعًا إلى فيديو؟
أرسل music_sound_info داخل post_info في POST /business/video/publish/. وبمجرد وجود الكائن تصبح music_sound_id وmusic_sound_volume مطلوبتين. يحدد music_sound_start وmusic_sound_end الجزء المختار من المقطع بالميلي ثانية، ويمتد افتراضيًا من بداية المقطع إلى المدة الكاملة للفيديو، فيستخدم فيديو مدته ثانيتان أول 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
}
}
}'من أين تأتي معرّفات المقاطع؟
من GET /discovery/cml/trending_list/، وهي نقطة نهاية في Discovery API تأخذ رمز الوصول الخاص بحساب TikTok ومعرّف business_id، بينما تأخذ نقاط الهاشتاغ في Discovery رمز المعلن. وتصنّفها مراجع TikTok ضمن صلاحية Discovery في Creative Management. ويُرجع حتى 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: الافتراضي هو 7DAY، والخيارات الأخرى هي 1DAY و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 فيحدد مقطعًا محددًا من المكتبة، ولا توجد حقول حجم أو بداية أو نهاية للصور. وفي developers.tiktok.com، تملك نقطة نهاية الصور في Content Posting API خاصيتها auto_add_music الخاصة، وتُطبَّق فقط عندما تكون post_mode هي DIRECT_POST، ونقطة نهاية الفيديو للنشر المباشر لا توثّق أي حقل موسيقى.
ماذا تعني مكتبة الموسيقى التجارية لحسابات الأعمال؟
هي الموسيقى التي يحق لهم استخدامها. تصف مراكز مساعدة الأعمال لدى TikTok المكتبة بأنها مجموعة عالمية معتمدة مسبقًا تضم مليون أغنية، وتقول إن الأعمال لا تستطيع استخدام مكتبة الموسيقى العامة للاستخدام التجاري، وتوجّهها إلى مكتبة الموسيقى التجارية للمحتوى العضوي، بما في ذلك الدويتو وreacts وstitches، والفيديوهات الإعلانية والمحتوى المدفوع العلامة التجارية. وفي حساب أعمال، يعرض Add Sound في التطبيق مقاطع المكتبة فقط، وتطبّق الواجهة الفصل نفسه، لأن music_sound_id يقبل معرّف مكتبة فقط.
ما الذي لا تستطيع الواجهة فعله بالموسيقى؟
هناك أمور خارج حقولها، كما تصفها مراجع TikTok:
- تسمية صوت من المكتبة العامة لـ TikTok:
music_sound_idيقبل معرّف مكتبة الموسيقى التجارية فقط - البحث في المكتبة بالعنوان: /discovery/cml/
trending_list/ يصفّي المقاطع الرائجة حسب النوع والدولة والفترة الزمنية - إبقاء الموسيقى على مسودة:
upload_to_draftيجعل TikTok يتجاهل بقيةpost_info، وis_draftيُبقي العنوان والتعليق فقط - استخدام مقطع خاص بك في منشور عضوي: /file/music/upload/ يضيف موسيقى لمواد الإعلانات ضمن
advertiser_id، وإشعار TikTok هناك يترك مسؤولية حقوق النشر على عاتق من رفع الملف
ما الحلول البديلة؟
ثلاثة، كل منها مبني على ما توثّقه مراجع TikTok، مع خطر واحد يجب وزنه:
- مزج الموسيقى في الملف. تصف قيود TikTok الفيديو بأنه محتوى صوتي مرئي، لذا فالصوت الممزوج فيه يخرج معه، فاستخدم صوتًا تملك حقوقه
- إرسال مسودة. مع
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 منشورًا في الحساب، إذا ذُكر impression_sources في metrics، ويُمرَّر فيه item_id للمنشور بوصفه object_id، أي معرّف المنشور.
ماذا تفعل easyCoexistence بالموسيقى؟
تنشر الصوت الموجود بالفعل في ملفك. يرسل publish_tiktok_post، سواء فورًا أو مع scheduled_at، التعليق وعنوان منشور الصورة وإعداد التعليقات، دون music_sound_info ودون auto_add_music، فيحتفظ الفيديو بموسيقاه الخاصة، وينشر منشور الصورة بلا موسيقى. يمكن للكود الخاص بك أن ينفذ POST إلى business/video/publish/ مع music_sound_info وtoken من get_social_credentials، لكن هذا الجسم يصل إلى TikTok كما هو، بما في ذلك video_url، وتجلب TikTok الوسائط فقط من النطاقات أو بادئات الروابط المتحقَّق منها للتطبيق. ومسارات /discovery/ تأخذ token مُعلِن، لذلك فقائمة المقاطع خارج نطاق token الحساب.
الأخطاء الشائعة
- ترك video_original_sound_volume عند إضافة مقطع. عبر الواجهة تكون قيمته الافتراضية 0، بينما يبدأ تطبيق TikTok الصوتين من 50، لذا اضبطه كلما كان صوت الفيديو الأصلي مهمًا.
- تمرير اسم المقطع أو preview_url كقيمة لـ music_sound_id. تسمّي وثيقة مقاطع TikTok الحقل song_clip_id، الموجود في full_duration_song_clip أو trending_song_clip، بوصفه القيمة الواجب تمريرها.
- استدعاء /discovery/cml/trending_list/ برمز معلن. تأخذ نقاط المقاطع رمز حساب TikTok وbusiness_id، كما تفعل Accounts API.
- قراءة مدة 0 على أنها مقطع معطوب. تنبه TikTok إلى أن المقطع الذي هو مجرد جزء من عمل أطول قد يظهر بمدة 0، لذا تحقّق من معاينته قبل اختيار البداية والنهاية.
US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها أول 3 أيام.
الأسئلة الشائعة
هل يمكنني إضافة أي أغنية إلى منشور TikTok عبر API؟
أغانٍ من مكتبة الموسيقى التجارية بمعرّفها. الموسيقى الممزوجة أصلًا في ملف الفيديو تخرج مع الملف، لذا يجب أن تكون موسيقى تملك حق استخدامها.
ما مستوى الصوت الذي تضبطه واجهة TikTok للموسيقى المضافة؟
0 افتراضيًا. تتراوح music_sound_volume وvideo_original_sound_volume من 0 إلى 100، وكلاهما قيمته الافتراضية 0 عبر الواجهة، بينما يبدأ تطبيق TikTok من 50، لذا اضبطهما في كل فيديو فيه مقطع.
هل تهم موسيقى المنشور إذا استُخدم لاحقًا في إعلان؟
يتحقق TikTok منها، إذ يبيّن /identity/music/authorization/ لمواقع الإعلان وتواريخ تشغيله ما إذا كانت موسيقى المنشور مصرّحًا بها بالكامل، أو بلا تصريح، أو بلا معرّف أغنية.
كم عدد الأغاني في مكتبة الموسيقى التجارية لدى TikTok؟
مليون أغنية بحسب مركز مساعدة الأعمال لدى TikTok، وكلها معتمدة مسبقًا للاستخدام التجاري. يُرجع /discovery/cml/trending_list/ حتى 100 منها رائجة في كل مرة.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في