API দিয়ে TikTok পোস্টে মিউজিক যোগ করা
TikTok-এর ব্যবসায়িক API তার Commercial Music Library থেকে মিউজিক যোগ করে। ভিডিও ও ছবি পোস্টে post_info.music_sound_info-এ ট্র্যাকের music_sound_id লাগে। ভিডিওতে এর সঙ্গে ট্র্যাকের ভলিউম, শুরু ও শেষের সময় (মিলিসেকেন্ডে) এবং ভিডিওর নিজের শব্দের ভলিউমও দেওয়া যায়। ছবি পোস্ট সুপারিশকৃত মিউজিকের জন্য auto_add_music-ও নিতে পারে। ট্র্যাকের আইডি আসে GET /discovery/cml/trending_list/ থেকে।
easyCoexistence Claude, ChatGPT বা আপনার নিজের কোড থেকে publish_tiktok_post দিয়ে TikTok ভিডিও ও ছবি পোস্ট প্রকাশ করে, এখনই বা নির্দিষ্ট সময়ে, 90 দিন আগ পর্যন্ত; ভিডিও তার ফাইলে মেশানো সাউন্ডট্র্যাক নিয়ে যায়।
/discovery/cml/trending_list/ যেসব সবচেয়ে জনপ্রিয় ট্র্যাক ফেরত দেয়, সেগুলো সবই অর্গানিক কনটেন্ট ও বিজ্ঞাপন তৈরির জন্য আগে থেকে ছাড়পত্রপ্রাপ্ত।
music_sound_volume ও video_original_sound_volume-এর পরিসর; API-র মাধ্যমে দুটোই ডিফল্টে 0, অথচ TikTok অ্যাপ শুরু করে 50 থেকে।
TikTok-এর Commercial Music Library-র গানগুলো, যা সারা বিশ্বের জন্য আগে থেকে ছাড়পত্রপ্রাপ্ত এবং ব্যবসায়িক কার্যক্রমে ব্যবহৃত হয়।
TikTok-এর বিজ্ঞাপনের মিউজিক তালিকা থেকে নেওয়া মিউজিক দিয়ে তৈরি ক্রিয়েটিভ কোথায় দেখানো হতে পারে, যদি না অধিকারধারীরা আলাদা অনুমতি দেয়।
developers.tiktok.com-এ লেখা আছে, Content Posting API-র ছবির এন্ডপয়েন্ট কেবল যে post_mode-এ auto_add_music প্রয়োগ করে, সেটিই একমাত্র।
TikTok-এর পাবলিশ এন্ডপয়েন্ট কোন মিউজিক ফিল্ড নেয়?
দুটো এন্ডপয়েন্টই মিউজিক রাখে post_info-এর ভেতরে, music_sound_info-এর অধীনে, এবং ট্র্যাককে তার Commercial Music Library আইডি দিয়ে চিহ্নিত করে। এর বাইরে এরা আলাদা: ভিডিও এন্ডপয়েন্টে মিক্সিং নিয়ন্ত্রণ যোগ হয়, আর ছবির এন্ডপয়েন্টে এমন একটি সুইচ থাকে যা 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
}
}
}'ট্র্যাক আইডি কোথা থেকে আসে?
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 লাইব্রেরির একটি নির্দিষ্ট ট্র্যাকের নাম দেয়, এবং ছবিতে ভলিউম, শুরু বা শেষের কোনো ফিল্ড নেই। developers.tiktok.com-এ Content Posting API-র ছবির এন্ডপয়েন্টে নিজস্ব auto_add_music আছে, যা কেবল post_mode DIRECT_POST হলে প্রয়োগ হয়; এর direct-post ভিডিও এন্ডপয়েন্টে কোনো মিউজিক ফিল্ড নথিভুক্ত নেই।
ব্যবসায়িক অ্যাকাউন্টের জন্য Commercial Music Library কী বোঝায়?
এটি সেই মিউজিক যা তারা ব্যবহার করতে পারে। TikTok-এর ব্যবসায়িক সহায়তা কেন্দ্র লাইব্রেরিকে বর্ণনা করে এক মিলিয়ন গানের একটি আগে থেকে ছাড়পত্রপ্রাপ্ত বৈশ্বিক সংগ্রহ হিসেবে, বলে যে ব্যবসা বাণিজ্যিক কাজে সাধারণ মিউজিক লাইব্রেরি ব্যবহার করতে পারে না, এবং তাদের দেখায় Commercial Music Library-র দিকে, যেখানে অর্গানিক কনটেন্ট, ডুয়েট, রিঅ্যাক্ট ও স্টিচ, ভিডিও বিজ্ঞাপন এবং ব্র্যান্ডেড কনটেন্ট সবই অন্তর্ভুক্ত। ব্যবসায়িক অ্যাকাউন্টে অ্যাপের Add Sound কেবল লাইব্রেরির সাউন্ড দেখায়, আর API একই সীমা টানে, কারণ music_sound_id একটি লাইব্রেরি আইডি নেয়।
API দিয়ে মিউজিকের ক্ষেত্রে কী করা যায় না?
কয়েকটি বিষয় এর ফিল্ডের বাইরে, যেমন TikTok-এর রেফারেন্সে বর্ণিত:
- TikTok-এর সাধারণ লাইব্রেরি থেকে কোনো সাউন্ডের নাম দেওয়া:
music_sound_idএকটি Commercial Music Library আইডি নেয়। - শিরোনাম দিয়ে লাইব্রেরি খোঁজা: /discovery/cml/
trending_list/ জনপ্রিয় ট্র্যাক ফিল্টার করে জেনার, দেশ ও সময়কাল দিয়ে। - একটি ড্রাফটে মিউজিক রাখা:
upload_to_draftTikTok-কে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-এর মাধ্যমে, metrics-এ impression_sources উল্লেখ থাকলে get_social_insights অ্যাকাউন্টের সবচেয়ে সাম্প্রতিক 20টি পোস্টের একটির জন্য এটি ফেরত দেয়, object_id হিসেবে পোস্টের item_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 বাদ দেওয়া। API-র মাধ্যমে এটি ডিফল্টে 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 দেখাতে পারে, তাই শুরু ও শেষ বাছার আগে এর প্রিভিউ দেখে নিন।
প্রতি সংযোগ প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সঙ্গে কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
API দিয়ে TikTok পোস্টে যেকোনো গান যোগ করা যায় কি?
Commercial Music Library-র গান, আইডি দিয়ে। ফাইলের ভেতরে আগে থেকে মেশানো মিউজিক ফাইলের সঙ্গেই বেরিয়ে যায়, তাই সেটি এমন মিউজিক হওয়া উচিত যা ব্যবহারের অধিকার আপনার আছে।
TikTok-এর API যোগ করা মিউজিকের জন্য কোন ভলিউম সেট করে?
ডিফল্টে 0। music_sound_volume ও video_original_sound_volume 0 থেকে 100 পর্যন্ত চলে, আর API-র মাধ্যমে দুটোই ডিফল্টে 0 থাকে, অথচ TikTok অ্যাপ শুরু করে 50 থেকে। তাই ট্র্যাকসহ প্রতিটি ভিডিওতে এগুলো আলাদা করে সেট করুন।
পরে কোনো বিজ্ঞাপনে ব্যবহার হলে পোস্টের মিউজিক কি গুরুত্বপূর্ণ?
TikTok তা যাচাই করে: /identity/music/authorization/ বিজ্ঞাপনের স্থান ও প্রচারের তারিখ অনুযায়ী জানায়, পোস্টের মিউজিক পুরোপুরি অনুমোদিত, অনুমোদন নেই, নাকি গানের আইডি নেই।
TikTok-এর Commercial Music Library-তে কতগুলো গান আছে?
TikTok-এর ব্যবসায়িক সহায়তা কেন্দ্র অনুযায়ী 1 মিলিয়ন, সবই বাণিজ্যিক ব্যবহারের জন্য আগে থেকে ছাড়পত্রপ্রাপ্ত। /discovery/cml/trending_list/ একবারে সর্বোচ্চ 100টি জনপ্রিয় গান ফেরত দেয়।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে