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 は、Claude、ChatGPT、または自分のコードから publish_tiktok_post を使って、TikTok の動画と写真投稿を公開します。
/discovery/cml/trending_list/ が返す人気楽曲です。いずれもオーガニックコンテンツと広告制作向けに事前許諾済みです。
music_sound_volume と video_original_sound_volume の範囲です。API 経由では両方とも既定値が 0 で、TikTok アプリでは 50 から始まります。
TikTok の Commercial Music Library の楽曲です。企業が TikTok 上の商用活動に使える、事前許諾済みのグローバルライブラリです。
権利者が別途許可しない限り、TikTok の広告用音楽リストの楽曲で作られたクリエイティブが配信される場合があります。
developers.tiktok.com によると、Content Posting API の写真エンドポイントで auto_add_music が適用される唯一の post_mode です。
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。POP、LATIN、LO-FI、SERTANEJO など 100 を超える値から選べます。
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/ には 2 つの方法があります。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 のビジネスヘルプセンターによると、このライブラリは事前許諾済みの世界規模のコレクションで 100 万曲あり、企業は一般の音楽ライブラリを商用利用できないとされています。オーガニックコンテンツ(デュエット、リアクション、スティッチを含む)、動画広告、ブランドコンテンツでは、Commercial Music Library を使うよう案内されています。ビジネスアカウントでは、アプリの「Add Sound」にライブラリの音源しか表示されません。music_sound_id もライブラリの ID を受け取るため、API も同じ線引きをしています。
API では音楽について何ができませんか?
TikTok のリファレンスに記載されているとおり、いくつかの操作はフィールドの範囲外です:
- TikTok の一般ライブラリから音源を指定する:
music_sound_idは Commercial Music Library の ID のみを受け付けます。 - タイトルでライブラリを検索する: /discovery/cml/
trending_list/ は人気楽曲をジャンル、国、期間で絞り込みます。 - 下書きで音楽を保持する:
upload_to_draftでは TikTok がpost_infoの他の項目を無視し、is_draftではタイトルとキャプションだけが残ります。 - オーガニック投稿で自分の楽曲を使う: /file/music/upload/ は
advertiser_idのもとで広告クリエイティブ用の音楽を追加します。TikTok の注意書きでは、著作権の責任はアップロードした側にあるとされています。
回避策はありますか?
3 つあり、いずれも TikTok のリファレンスに記載された機能に基づいています。加えて、考慮すべきリスクが 1 つあります:
- ファイルに音楽をミックスする: 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 件の投稿のうち 1 件について返します。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 できますが、そのボディは video_url を含めて書かれたまま TikTok に届きます。TikTok は、アプリで検証されたドメインまたは URL プレフィックスからのみメディアを取得します。/discovery/ のパスは広告主のトークンを受け取るため、楽曲一覧はアカウントのトークンの範囲外です。
よくある間違い
- 楽曲を追加するときに video_original_sound_volume を省略する。API 経由では既定値が 0 ですが、TikTok アプリでは両方の音声が 50 から始まるため、動画自体の音声が重要な場合は必ず設定してください。
- music_sound_id に楽曲の名前や preview_url を渡す。TikTok のリファレンスでは、full_duration_song_clip または trending_song_clip の song_clip_id を渡すよう定めています。
- 広告主のトークンで /discovery/cml/trending_list/ を呼ぶ。楽曲のエンドポイントは、Accounts API と同じく TikTok アカウントのトークンと business_id を受け取ります。
- 再生時間 0 を壊れた楽曲とみなす。TikTok は、より長い楽曲の一部だけのクリップは 0 と表示されることがあると注意しています。開始と終了を選ぶ前にプレビューを確認してください。
即時でも、最大 90 日先までの予約時刻でも可能です。動画は音楽をファイルにミックスした状態で配信されます。接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。
よくある質問
API で TikTok の投稿に好きな曲を追加できますか?
Commercial Music Library の楽曲を ID で指定できます。動画ファイルにすでにミックスされている音楽は、そのファイルと一緒に配信されるため、使用する権利を持つ音楽にしてください。
TikTok の API は、追加した音楽の音量をいくつに設定しますか?
既定では 0 です。music_sound_volume と video_original_sound_volume は 0 から 100 までの範囲で、API 経由では両方とも既定値が 0 です。TikTok アプリでは 50 から始まるため、楽曲を追加する動画ごとに設定してください。
投稿の音楽は、後で広告に使われる場合も問題になりますか?
はい。TikTok が確認します。/identity/music/authorization/ は、広告の配信地域と掲載期間について、投稿の音楽が完全に許諾されているか、許諾が不足しているか、楽曲 ID がないかを報告します。
TikTok の Commercial Music Library には何曲ありますか?
TikTok のビジネスヘルプセンターによると 100 万曲で、すべて商用利用に事前許諾されています。/discovery/cml/trending_list/ は一度に最大 100 件の人気楽曲を返します。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日