登录开始免费试用
easyCoexistence 官方 API

通过 API 为 TikTok 帖子添加音乐

TikTok 商业 API 从其 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 天定时发布;视频会以混入文件的配乐发出。

100

/discovery/cml/trending_list/ 返回的最热门曲目,均已预先获准用于自然内容和广告创作。

0 to 100

music_sound_volume 与 video_original_sound_volume 的取值范围;通过 API 两者默认均为 0,而 TikTok 应用默认从 50 开始。

1 million

Commercial Music Library 中的歌曲,是商业账户在 TikTok 上开展商业活动时使用的全球预先获准曲库。

TikTok only

使用 TikTok 广告音乐列表音乐制作的创意可投放地区,除非权利人另行授权。

DIRECT_POST

在 developers.tiktok.com 上,Content Posting API 照片端点应用 auto_add_music 的唯一 post_mode。

TikTok 的发布端点接受哪些音乐字段?

两个端点都把音乐放在 post_info 内的 music_sound_info 中,并通过 Commercial Music Library ID 指定曲目。除此之外两者有所不同:视频端点增加混音控制,照片端点增加一个让 TikTok 自行选择音乐的开关。以下为 TikTok 参考文档中的并列对比:

Video postPhoto post
The trackmusic_sound_info.music_sound_idmusic_sound_info.music_sound_id
Track volumemusic_sound_volume, 0 to 100, required with a trackNo field
Part of the trackmusic_sound_start and music_sound_end, in millisecondsNo field
The video's own soundvideo_original_sound_volume, 0 to 100Not applicable
Recommended musicNo fieldauto_add_music, false by default
As a draftupload_to_draft drops the rest of post_infois_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 秒视频会取曲目的前 2000 毫秒。如果视频自身的声音很重要,也请设置 video_original_sound_volume,因为它默认为 0:

A 15-second video with seconds 15 to 30 of a library track
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 条热门视频。
Popular pop tracks in Brazil over the last 7 days
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 时生效,其直接发布视频端点则未记录任何音乐字段。

Commercial Music Library 对商业账户意味着什么?

它是商业账户可以使用的音乐范围。TikTok 商业帮助中心称该库为预先获准的全球曲库,共 100 万首歌曲,并称商业账户不能将普通音乐库用于商业用途,并引导其使用 Commercial Music Library,用于自然内容(包括合拍、回应与拼接)、视频广告和品牌内容。在商业账户中,应用里的“Add Sound”只显示音乐库中的声音,而 API 也划出同样的界限,因为 music_sound_id 只接受音乐库 ID。

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 在该端点的说明中表明版权责任由上传者承担。

有哪些变通方法?

三种,均基于 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/ 发起 POST 请求并附带 music_sound_info,但该请求体会按原样发送给 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,与 TikTok 账户 API 相同。
  • 把时长显示为 0 的曲目当作损坏。TikTok 指出,仅为较长作品片段的曲目可能显示为 0,因此在选择起点和终点之前,请先检查其预览。
使用 EasyCoexistence 完成这些操作

每个连接每月 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 开始,因此请为每个带曲目的视频分别设置。

帖子的音乐在之后用于广告时是否重要?

TikTok 会进行检查。/identity/music/authorization/ 会针对广告的投放地区和投放日期,报告帖子的音乐是否已完全授权、缺少授权,或没有歌曲 ID。

TikTok 的 Commercial Music Library 中有多少首歌曲?

根据 TikTok 商业帮助中心,共 100 万首,均已预先获准用于商业用途。/discovery/cml/trending_list/ 每次最多返回 100 首热门歌曲。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间