透過 API 在 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 可透過 publish_tiktok_post,從 Claude、ChatGPT 或你自己的程式碼發布 TikTok 影片與相片貼文,可即時發布,也可於最多 90 天後的指定時間發布;影片會將配樂混入其檔案後發出。
/discovery/cml/trending_list/ 返回最受歡迎的曲目,全部已預先獲授權,可用於自然內容與廣告製作。
music_sound_volume 與 video_original_sound_volume 的範圍;透過 API 兩者預設為 0,而 TikTok 應用程式則由 50 開始。
TikTok 的 Commercial Music Library 中的歌曲,即商家在 TikTok 進行商業活動時使用、預先獲授權的全球音樂庫。
使用 TikTok 廣告音樂清單中音樂製作的創意,可能投放的地點,除非權利持有人另行授權。
唯一會讓內容發布 API 相片端點套用 auto_add_music 的 post_mode(於 developers.tiktok.com 所述)。
TikTok 的發布端點接受哪些音樂欄位?
兩個端點都將音樂放在 post_info 內的 music_sound_info 之下,並以商業音樂庫的 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:預設為 7DAY,可選 1DAY、30DAY 或 90DAY。- /discovery/cml/
video_list/:使用某曲目的commercial_music_id與country_code,返回使用該曲目、最熱門的 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'相片貼文如何加入音樂?
在 POST /business/photo/publish/ 有兩種方式。將 auto_add_music 設為 true,TikTok 會加入推薦音樂,擁有者日後可在 TikTok 應用程式中更改;music_sound_info.music_sound_id 則指定音樂庫中的特定曲目,相片沒有音量、起點或終點欄位。在 developers.tiktok.com 上,內容發布 API 的相片端點有其自己的 auto_add_music,只在 post_mode 為 DIRECT_POST 時套用,而其直接發布影片端點則沒有列出任何音樂欄位。
商業音樂庫對商業帳戶意味著什麼?
這是商業帳戶可以使用的音樂。TikTok 商業幫助中心表示,該音樂庫是預先獲授權、涵蓋全球、共有 100 萬首歌曲的集合;商家不得將一般音樂庫用於商業用途,並應改用商業音樂庫,適用於自然內容(包括合拍、Reacts 與 Stitch)、影片廣告與品牌內容。在商業帳戶上,應用程式中的「Add Sound」只顯示音樂庫中的聲音,API 也採用相同限制,因為 music_sound_id 只接受音樂庫的 ID。
API 不能對音樂做什麼?
有幾項功能超出其欄位範圍,如 TikTok 參考文件所述:
- 以 TikTok 一般音樂庫中的聲音指定:
music_sound_id只接受商業音樂庫的 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,當 metrics 中指定 impression_sources 時,get_social_insights 會返回帳戶最近 20 則貼文之一的該數據,並以貼文的 item_id 作為 object_id。
easyCoexistence 如何處理音樂?
它發布檔案中已有的聲音。publish_tiktok_post 無論即時發布或透過 scheduled_at 排程,都只傳送說明文字、相片貼文的標題與留言設定,不含 music_sound_info 與 auto_add_music,因此影片會保留自己的配樂,相片貼文則不附音樂發出。您自己的程式可憑 get_social_credentials 提供的權杖,以 music_sound_info 向 business/video/publish/ 發送 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 貼文中加入任何歌曲?
可使用商業音樂庫中的歌曲,以 ID 指定。已混入影片檔案的音樂會隨檔案一併發布,因此應使用你擁有使用權的音樂。
TikTok 的 API 為加入的音樂設定什麼音量?
預設為 0。music_sound_volume 與 video_original_sound_volume 的範圍為 0 至 100,透過 API 兩者預設均為 0,而 TikTok 應用程式則由 50 開始,因此在每段加入曲目的影片上都應分別設定。
若貼文日後用於廣告,其音樂會受到檢查嗎?
會。/identity/music/authorization/ 會就廣告的投放地點與播放日期,回報貼文的音樂是否已完全獲授權、缺少授權,或沒有歌曲 ID。
TikTok 的商業音樂庫有多少首歌曲?
根據 TikTok 商業幫助中心,共有 100 萬首,全部均已預先獲授權可作商業用途。/discovery/cml/trending_list/ 每次最多返回 100 首熱門歌曲。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期