> ## Documentation Index > Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt > Use this file to discover all available pages before exploring further. # 音乐详情 > 这是单首音乐的实时详情接口，按 `music_id` 和`region`拉音乐实体本身，适合查看该音频的基础信息和使用热度。返回展示的是音频本体的资料、作者和使用背景，更适合先判断这首声音本身有没有传播潜力，而不是马上看内容案例。 **接口用途推荐** - 适合做 BGM 追踪 - 热门音频研究 - 做配乐库、判断某个音频是否值得跟用 **注意事项** - 实时接口可能遇到风控，如果接口返回code=500，请继续重试（code=500不消耗当前调用额度）
🪙 1 credit每次请求
## Copy for AI

🤖 让 AI 帮你写调用代码

点击按钮复制一段结构化提示词，可直接交给 ChatGPT、Claude 或其他 AI 助手生成接口调用代码。

## OpenAPI ````yaml zh/tiktok.zh.openapi.json GET /v1/tiktok/music/detail openapi: 3.0.1 info: title: Tiktok API 中文文档 description: Tiktok API 的中文参考文档，包含接口用途、参数说明、响应状态和示例结构。 version: 1.0.0 servers: - url: https://api.keyapi.ai description: Production security: [] tags: - name: TikTok 达人 - name: TikTok 店铺 - name: TikTok 内容数据 - name: TikTok 趋势洞察 paths: /v1/tiktok/music/detail: get: tags: - TikTok 内容 summary: 音乐详情 description: >- 这是单首音乐的实时详情接口，按 `music_id` 和`region`拉音乐实体本身，适合查看该音频的基础信息和使用热度。返回展示的是音频本体的资料、作者和使用背景，更适合先判断这首声音本身有没有传播潜力，而不是马上看内容案例。 **接口用途推荐** - 适合做 BGM 追踪 - 热门音频研究 - 做配乐库、判断某个音频是否值得跟用 **注意事项** - 实时接口可能遇到风控，如果接口返回code=500，请继续重试（code=500不消耗当前调用额度） parameters: - name: music_id in: query description: 音乐ID required: true example: '6928004115846924290' schema: type: string example: '6928004115846924290' - name: region in: query description: '' required: true example: US schema: type: string example: US responses: '200': description: '' content: application/json: schema: type: object properties: {} example: code: 0 message: success data: ai_recommend_music: null ai_recommend_video: null behind_the_song_exist: false extra: fatal_item_ids: [] logid: 20260715120601DF3CE0B0C89B0A19E480 now: 1784117162000 log_pb: impr_id: 20260715120601DF3CE0B0C89B0A19E480 msg: success music_chart_rank: chart_music_info: >- {"currentTabId":0,"tabList":[{"tabId":0,"tabNameKey":"music_chart_top_50_title","tabName":"music_chart_top_50_title","currentMusicId":""},{"tabId":1,"tabNameKey":"music_chart_viral_50_title","tabName":"music_chart_viral_50_title","currentMusicId":""}]} desc: Music Charts link_style: bg_end_color: 2151916 bg_start_color: 2151916 music_info: album: Nikes allow_offline_music_to_detail_page: false artists: - avatar: uri: >- tos-useast8-avt-0068-tx2/7867c6f587125961ecf3874b21df17d0 url_list: - >- https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/7867c6f587125961ecf3874b21df17d0~tplv-tiktokx-cropcenter:168:168.webp?dr=9638&refresh_token=7b4f88e4&x-expires=1784203200&x-signature=D8a93F2M1d%2FgXZyEmvwpwoDBOJI%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=useast5 - >- https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/7867c6f587125961ecf3874b21df17d0~tplv-tiktokx-cropcenter:168:168.webp?dr=9638&refresh_token=691bca0c&x-expires=1784203200&x-signature=VJhAkz24SG4TuCiTbEouPexfsNg%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=useast5 - >- https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/7867c6f587125961ecf3874b21df17d0~tplv-tiktokx-cropcenter:168:168.jpeg?dr=9638&refresh_token=24906f5e&x-expires=1784203200&x-signature=2UponzmSF96k3%2FsaPeyY9DTihOQ%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=useast5 url_prefix: null enter_type: 2 follow_status: 0 follower_status: 0 handle: nimstarrr is_block: false is_blocked: false is_private_account: false is_verified: false is_visible: false nick_name: Nimstarr sec_uid: >- MS4wLjABAAAAPVzATqmW37ERaXZZv3yDA2Xo0mOMxQdhPqE471wtFgUdPh0uKzfz2d0Vj21DCyk3 status: 1 uid: '6809444586009003014' audition_duration: 60 author: Nimstarr & kid toni author_deleted: false author_position: null avatar_medium: height: 720 uri: musically-maliva-obj/1594805258216454 url_list: - >- https://p16-common-sign.tiktokcdn-us.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=9c8c893c&x-expires=1784203200&x-signature=jo9e65%2BCVOdK0kIzlTZbVqjp7y4%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=useast5 - >- https://p19-common-sign.tiktokcdn-us.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=3bfccedc&x-expires=1784203200&x-signature=3TUu3bvIAEzQP4HG%2F3WK5xZdQqs%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=useast5 - >- https://p16-common-sign.tiktokcdn-us.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=cda706e4&x-expires=1784203200&x-signature=2bn28Nlk3d5FcXaN8tUcMdTWYbQ%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=useast5 url_prefix: null width: 720 avatar_thumb: height: 720 uri: musically-maliva-obj/1594805258216454 url_list: - >- https://p19-common-sign.tiktokcdn-us.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=62869f39&x-expires=1784203200&x-signature=Yo5QbWAcgXnL77X8zsCnFv2o2VU%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=useast5 - >- https://p16-common-sign.tiktokcdn-us.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=1e2bc08e&x-expires=1784203200&x-signature=PUC6zboGMQ9WXvQWv5prhGLq%2BpI%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=useast5 - >- https://p19-common-sign.tiktokcdn-us.com/musically-maliva-obj/1594805258216454~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=1d252d9a&x-expires=1784203200&x-signature=x9l6Ki0D6xrrV1Y5qWbtfkA6vVE%3D&t=4d5b0474&ps=13740610&shp=544a444f&shcp=f6441914&idc=useast5 url_prefix: null width: 720 binded_challenge_id: 0 can_be_stitched: true can_not_reuse: false collect_stat: 0 commercial_right_type: 1 cover_large: height: 720 uri: tos-alisg-v-2774/ddced95b3b79404abab94c605af4cc1d url_list: - >- https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/ddced95b3b79404abab94c605af4cc1d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=4d5b0474&ps=933b5bde&shp=08d74b56&shcp=544a444f&idc=useast5 url_prefix: null width: 720 cover_medium: height: 720 uri: tos-alisg-v-2774/ddced95b3b79404abab94c605af4cc1d url_list: - >- https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/ddced95b3b79404abab94c605af4cc1d~tplv-tiktokx-cropcenter:200:200.jpeg?dr=9584&t=4d5b0474&ps=933b5bde&shp=08d74b56&shcp=544a444f&idc=useast5 url_prefix: null width: 720 cover_thumb: height: 720 uri: tos-alisg-v-2774/ddced95b3b79404abab94c605af4cc1d url_list: - >- https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/ddced95b3b79404abab94c605af4cc1d~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9584&t=4d5b0474&ps=933b5bde&shp=08d74b56&shcp=544a444f&idc=useast5 url_prefix: null width: 720 create_time: 1613051663 dmv_auto_show: false duration: 60 duration_high_precision: audition_duration_precision: 60 duration_precision: 60 shoot_duration_precision: 60 video_duration_precision: 60 external_song_info: [] extra: >- {"aed_music_dur":58.33,"amplitude_peak":1.1030183,"apple_song_id":1553223211,"beats":{"audio_effect_onset":"https://sf19.tiktokcdn-us.com/obj/tos-alisg-v-2774/9874ccf0d6534651aef2099ae8098e2a","beats_tracker":"https://sf19.tiktokcdn-us.com/obj/tos-alisg-v-2774/a836add63817405fa509a419e5ff70dc","energy_trace":"https://sf16.tiktokcdn-us.com/obj/tos-alisg-v-2774/61338bd0c87f4c2dab79cd6787bcebfa","merged_beats":"https://sf16.tiktokcdn-us.com/obj/tos-alisg-v-2774/f6b517e10a2d43e1b7ed56a189873446"},"can_read":true,"can_reuse":true,"erase_type":0,"erase_uid":0,"from_user_id":7568994679443047438,"full_song_beat_info":{},"full_song_beats":{},"has_edited":0,"is_batch_take_down_music":false,"is_ugc_mapping":false,"is_used":0,"loudness_lufs":-11.986184,"music_vid":"v10ad6g50000d49ip5fog65ou22j3gng","owner_id":0,"resource_status":0,"review_unshelve_reason":0,"reviewed":1,"schedule_search_time":0} has_commerce_right: false has_commerce_right_strict: false id: '6928004115846924290' id_str: '6928004115846924290' is_audio_url_with_cookie: false is_author_artist: true is_commerce_music: false is_commerce_music_strict: false is_matched_metadata: false is_original: false is_original_sound: false is_pgc: true is_shooting_allow: true log_extra: >- {"meta_song_matched_type":"pgc","ttm_matched_type":"","ttm_track_id":"","matched_meta_song_id":"","vid":"","owner_id":""} lyric_scene_copyright: lyric_sticker: true lyric_short_position: null lyrics: - lyric_id: '7277891515014744124' lyric_type: 2 lyric_url: >- https://v16m.tiktokcdn-us.com/17260021de74e1348ec3fed07460e1ee/6a57cc09/video/tos/alisg/tos-alisg-v-2774/owa3r1xwWRF4IbAEXAPw8MqhgiyASiABC5QEK/?a=1233&bti=NDg5QGo6dik1OzlmNC4uYCM6bTIuMDo%3D&&bt=46&ft=arR-IqGHmDgPD12xYGqI3wUKA-GuEeF~O5&mime_type=video_mp4&rc=M2tvNXM5cjg2OTMzNDlkM0BpM2tvNXM5cjg2OTMzNDlkM0BkMGpwMmQ0MXJhLS1kYTBzYSNkMGpwMmQ0MXJhLS1kYTBzcw%3D%3D&vvpl=1&l=20260715120601DF3CE0B0C89B0A19E480&btag=e00070000 - lyric_id: '7101818906964133890' lyric_type: 3 lyric_url: >- https://v16m.tiktokcdn-us.com/b4aeeda0e5cf48aa62da15f63b4f3e86/6a57cc09/video/tos/useast2a/tos-useast2a-v-2774/ow4WpFBZCDpFvHtIZgARCNAhIfuGD3AEfSIADA/?a=1233&bti=OnYpOjQ0Zik1OzlmOm0uMjM6ZDIuMDo%3D&&bt=46&ft=arR-IqGHmDgPD12xYGqI3wUKA-GuEeF~O5&mime_type=video_mp4&rc=anFpdG45cjQ2OTMzNDlkM0BpanFpdG45cjQ2OTMzNDlkM0AyLjFkMmRrMXJhLS1kYS9zYSMyLjFkMmRrMXJhLS1kYS9zcw%3D%3D&vvpl=1&l=20260715120601DF3CE0B0C89B0A19E480&btag=e00070000 matched_song: author: Nimstarr & kid toni chorus_info: duration_ms: 15168 start_ms: 70464 choruses: null cover_medium: height: 720 uri: tos-alisg-v-2774/ddced95b3b79404abab94c605af4cc1d url_list: - >- https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/ddced95b3b79404abab94c605af4cc1d~tplv-tiktokx-cropcenter:200:200.jpeg?dr=9584&t=4d5b0474&ps=933b5bde&shp=08d74b56&shcp=544a444f&idc=useast5 - >- https://p19-common.tiktokcdn-us.com/tos-alisg-v-2774/ddced95b3b79404abab94c605af4cc1d~tplv-tiktokx-cropcenter:200:200.jpeg?dr=9584&t=4d5b0474&ps=933b5bde&shp=08d74b56&shcp=544a444f&idc=useast5 url_prefix: null width: 720 full_duration: 139921 h5_url: '' id: '6928004113938532354' performers: null title: Nikes verses: null meme_song_info: {} mid: '6928004115846924290' multi_bit_rate_play_info: - bit_rate: 129600 dub_infos: null gear_name: higher play_addr: url_list: - >- http://v19.tiktokcdn-us.com/0528c7dbefe662b1bf17f5ec17b1708c/6a57cc45/video/tos/alisg/tos-alisg-ve-2774/o4xMwEiI8UP6Ad0vIiZKWWi1mB4XfGBwsOAZPo/?a=1233&bti=OnYpenFxQGo4NDZAOm1rbGhyYCMvNTNg&&bt=126&ft=GSDrKInz7ThZQsaGXq8Zmo&mime_type=audio_mp4&rc=OjtoaWVkPDM0ZTllZjU1ZUBpamptNXI5cjhsNzMzODlkNEBjYi5gYzA0Ni8xY14xYzJeYSNrMC9yMmRjbTZhLS1kYS1zcw%3D%3D&vvpl=1&l=20260715120601DF3CE0B0C89B0A19E480&btag=e00090000 - >- http://v16m.tiktokcdn-us.com/1dca32d4367123ba6b740a21dbefdf15/6a57cc45/video/tos/alisg/tos-alisg-ve-2774/o4xMwEiI8UP6Ad0vIiZKWWi1mB4XfGBwsOAZPo/?a=1233&bti=OnYpenFxQGo4NDZAOm1rbGhyYCMvNTNg&&bt=126&ft=GSDrKInz7ThZQsaGXq8Zmo&mime_type=audio_mp4&rc=OjtoaWVkPDM0ZTllZjU1ZUBpamptNXI5cjhsNzMzODlkNEBjYi5gYzA0Ni8xY14xYzJeYSNrMC9yMmRjbTZhLS1kYS1zcw%3D%3D&vvpl=1&l=20260715120601DF3CE0B0C89B0A19E480&btag=e00090000 url_prefix: null quality_type: 6 - bit_rate: 257675 dub_infos: null gear_name: highest play_addr: url_list: - >- http://v19.tiktokcdn-us.com/b907472a2fa7c5f1a8b0a2754d5b3f03/6a57cc45/video/tos/alisg/tos-alisg-ve-2774/o4ek0ggGSC6jC6HLIDrllFQwaDTmeJhAhzYXfr/?a=1233&bti=OnYpenFxQGo4NDZAOm1rbGhyYCMvNTNg&&bt=251&ft=GSDrKInz7ThZQsaGXq8Zmo&mime_type=audio_mp4&rc=ZzloOmc6OzZoNzZpZzZoaEBpamptNXI5cjhsNzMzODlkNEBfMi9eYS4vXzUxLTUyMjVgYSNrMC9yMmRjbTZhLS1kYS1zcw%3D%3D&vvpl=1&l=20260715120601DF3CE0B0C89B0A19E480&btag=e00090000 - >- http://v16m.tiktokcdn-us.com/b7de125c819ed6fbde65701c177bc6d9/6a57cc45/video/tos/alisg/tos-alisg-ve-2774/o4ek0ggGSC6jC6HLIDrllFQwaDTmeJhAhzYXfr/?a=1233&bti=OnYpenFxQGo4NDZAOm1rbGhyYCMvNTNg&&bt=251&ft=GSDrKInz7ThZQsaGXq8Zmo&mime_type=audio_mp4&rc=ZzloOmc6OzZoNzZpZzZoaEBpamptNXI5cjhsNzMzODlkNEBfMi9eYS4vXzUxLTUyMjVgYSNrMC9yMmRjbTZhLS1kYS1zcw%3D%3D&vvpl=1&l=20260715120601DF3CE0B0C89B0A19E480&btag=e00090000 url_prefix: null quality_type: 7 - bit_rate: 65631 dub_infos: null gear_name: medium play_addr: url_list: - >- http://v19.tiktokcdn-us.com/73f5ea9a52adf6df38b75e63f723798a/6a57cc45/video/tos/alisg/tos-alisg-ve-2774/oMI6XHgv0jA0FwUmA4iiwZBKWiBssEtMI8fxoZ/?a=1233&bti=OnYpenFxQGo4NDZAOm1rbGhyYCMvNTNg&&bt=64&ft=GSDrKInz7ThZQsaGXq8Zmo&mime_type=audio_mp4&rc=M2czOjs6ZWY8PDNmOThpM0BpamptNXI5cjhsNzMzODlkNEAxNmJiYmExXjAxNTA0Yi41YSNrMC9yMmRjbTZhLS1kYS1zcw%3D%3D&vvpl=1&l=20260715120601DF3CE0B0C89B0A19E480&btag=e00090000 - >- http://v16m.tiktokcdn-us.com/2c44274edcd4ab849d3e2e0dbbb70bcb/6a57cc45/video/tos/alisg/tos-alisg-ve-2774/oMI6XHgv0jA0FwUmA4iiwZBKWiBssEtMI8fxoZ/?a=1233&bti=OnYpenFxQGo4NDZAOm1rbGhyYCMvNTNg&&bt=64&ft=GSDrKInz7ThZQsaGXq8Zmo&mime_type=audio_mp4&rc=M2czOjs6ZWY8PDNmOThpM0BpamptNXI5cjhsNzMzODlkNEAxNmJiYmExXjAxNTA0Yi41YSNrMC9yMmRjbTZhLS1kYS1zcw%3D%3D&vvpl=1&l=20260715120601DF3CE0B0C89B0A19E480&btag=e00090000 url_prefix: null quality_type: 3 music_release_info: group_release_date: 1613088000 is_new_release_song: false mute_share: false offline_desc: '' owner_handle: '' owner_nickname: '' play_url: height: 720 uri: >- https://sf19.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oAFOwAfiDwiJ0Kvo8MAZsxBG1IIZiUWPB4MZLT url_list: - >- https://sf19.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oAFOwAfiDwiJ0Kvo8MAZsxBG1IIZiUWPB4MZLT url_prefix: null width: 720 position: null prevent_download: false preview_end_time: 0 preview_start_time: 6 recommend_status: 100 same_group_id_v3: '6928004630341224448' share_info: bool_persist: 0 now_invitation_card_image_urls: null share_desc: 'Check out this song! Nikes #TikTok' share_desc_info: >- Users all over the world are having fun making their own versions of the song Nikes on TikTok! Tap here >> share_quote: '' share_signature_desc: '' share_signature_url: '' share_title: >- Amazing! I just found a bunch of funny videos! #TikTok > Nikes share_title_myself: '' share_title_other: '' share_url: >- https://www.tiktok.com/music/Nikes-6928004115846924290?_r=1&sharer_language=en&source=h5_m&u_code=f08jm0cg58hd0d&_d=f08m6chjl2m3fl&share_music_id=6928004115846924290 shoot_duration: 60 sim_group_id_v3: 53265253122 source_platform: 10033 status: 1 strong_beat_url: height: 720 uri: >- https://sf19.tiktokcdn-us.com/obj/tos-alisg-v-2774/a07a933c327c436b9f488f8bb416ae4e url_list: - >- https://sf19.tiktokcdn-us.com/obj/tos-alisg-v-2774/a07a933c327c436b9f488f8bb416ae4e url_prefix: null width: 720 suggest_words: suggest_words: - scene: search_hint words: - word: Nikes word_id: '8135909805128194412' tag_list: null theme_tags: - Summer title: Nikes tt_to_dsp_song_infos: - button_type: 2 platform: 1 song_id: '1553223211' token: apple_music_token: developer_token: >- eyJhbGciOiJFUzI1NiIsImtpZCI6Ikc2Q0dLMjdWQzMifQ.eyJleHAiOjE3ODQ3MTMyMzAsImlhdCI6MTc4NDEwODQzMCwiaXNzIjoiTUo3OTdEOFU2RiJ9.JHhQfET8fGV5cTRjnmtA_15mcmAZH7Jy9ZdoFqv1WXcijv7lbnkal5fUQ54LwByLNmBnQERbeO_I04YfPeNv-w - button_type: 2 platform: 2 song_id: B094PD4237 - button_type: 2 platform: 3 song_id: 65ha6jDdEeQ05hbiDeSUjT - button_type: 2 platform: 8 song_id: '1240608492' - button_type: 2 platform: 9 song_id: '938479294' - button_type: 2 platform: 10 song_id: 4Cxhl5dzBzI uncert_artists: - name: kid toni user_count: 3916 vid_volume_info: '{"Loudness":-12,"Peak":0.91201}' video_duration: 60 rec_list: [] similar_music: [] similar_music_ids: null status_code: 0 status_msg: '' requestId: 09ae9c28-bc8d-43e9-8dcc-5e28de5216c3 headers: {} '400': description: 请求参数错误，请检查必填字段和参数格式 content: application/json: schema: type: object example: code: 400 data: null message: Missing required parameter '401': description: 鉴权失败，请检查 Authorization Header 中的 Bearer Token 或 API Key 是否有效 content: application/json: schema: type: object example: code: 401 data: null message: apiKey is null '402': description: 账户余额或额度不足 content: application/json: schema: type: object example: code: 402 data: null message: apiKey quota is not enough '429': description: 请求过于频繁，已触发限流 content: application/json: schema: type: object example: code: 429 data: null message: qps limit exceeded '500': description: 服务器内部错误，请稍后重试 content: application/json: schema: type: object example: code: 500 data: null message: Internal server error deprecated: false security: - JWT Bearer: [] x-codeSamples: - lang: curl label: cURL source: |- curl --request GET \ --url 'https://api.keyapi.ai/v1/tiktok/music/detail?music_id=6928004115846924290®ion=US' \ --header 'Authorization: Bearer ' - lang: python label: Python source: |- import requests response = requests.get( 'https://api.keyapi.ai/v1/tiktok/music/detail', params={"music_id": "6928004115846924290", "region": "US"}, headers={'Authorization': 'Bearer '} ) print(response.json()) - lang: javascript label: JavaScript source: >- const params = new URLSearchParams({"music_id": "6928004115846924290", "region": "US"}); const response = await fetch(`https://api.keyapi.ai/v1/tiktok/music/detail?${params}`, { method: 'GET', headers: { 'Authorization': 'Bearer ' } }); const data = await response.json(); console.log(data); components: securitySchemes: JWT Bearer: type: http scheme: bearer bearerFormat: JWT description: |- 接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer `。 可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。 ````