文档中心 > API类目 > 曲库开放平台歌曲API

xiami.content.songs.audio.getrefrain (获取副歌信息)

获取歌曲音频副歌

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
song_ids Number [] 必须 1769908308
  • 最大列表长度:999
  • 歌曲ID

    响应参数

    名称 类型 示例值 描述
    audios SongAudiosDto [] audios 音频信息
    • └ song_id
    • Number
    • 1769908308
    • 歌曲ID
    • audios
    • AudioDto []
    • audio_list
    • 音频信息
    • └ audio_id
    • Number
    • 123222
    • 音频ID
    • └ duration
    • Number
    • 300000
    • 音频时长(单位:毫秒)
    • └ listen_url
    • String
    • https://xxx.mp3?oooyyyooo
    • 音频地址 带有标准的CDN签名
    • └ file_size
    • Number
    • 5000
    • 文件大小(单位: 字节)
    • └ format
    • String
    • mp3
    • 音频格式:mp3|m4a|wav
    • └ rate
    • Number
    • 320
    • 码率: 32|64|128|192|320|>320 的整数值
    • └ quality
    • Number
    • 1
    • 品质:1(无损)|2(320k)|3(192k)|4(128k)|5(32k)|6(副歌)|7(64k)|8(128kAAC)|9(192kAAC)|10(256kAAC)|15(MQA)
    • └ sample_rate
    • Number
    • 32
    • 采样率
    • └ bits
    • Number
    • 64
    • 位信息
    • └ expire
    • Number
    • 1607702400000
    • 过期时间(unix timestamp)
    • └ refrain_end_time
    • Number
    • 136000
    • 副歌片段结束时间(单位:毫秒)
    • └ refrain_start_time
    • Number
    • 123000
    • 副歌片段开始时间(单位:毫秒)
    • └ video_part_start_time
    • Number
    • 136000
    • 热门片段开始时间(单位:毫秒)
    • └ video_part_end_time
    • Number
    • 146000
    • 热门片段结束时间(单位:毫秒)
    result_code ResultCode result_code 请求结果信息
    • └ msg
    • String
    • success
    • result message
    • └ code
    • Number
    • 0
    • result code

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XiamiContentSongsAudioGetrefrainRequest req = new XiamiContentSongsAudioGetrefrainRequest();
    req.setSongIds("1769908308");
    XiamiContentSongsAudioGetrefrainResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xiami_content_songs_audio_getrefrain_response>
        <audios>
            <song_audios_dto>
                <song_id>1769908308</song_id>
                <audios>
                    <audio_dto>
                        <audio_id>123222</audio_id>
                        <duration>300000</duration>
                        <listen_url>https://xxx.mp3?oooyyyooo</listen_url>
                        <file_size>5000</file_size>
                        <format>mp3</format>
                        <rate>320</rate>
                        <quality>1</quality>
                        <sample_rate>32</sample_rate>
                        <bits>64</bits>
                        <expire>1607702400000</expire>
                    </audio_dto>
                </audios>
                <refrain_end_time>136000</refrain_end_time>
                <refrain_start_time>123000</refrain_start_time>
                <video_part_start_time>136000</video_part_start_time>
                <video_part_end_time>146000</video_part_end_time>
            </song_audios_dto>
        </audios>
        <result_code>
            <msg>success</msg>
            <code>0</code>
        </result_code>
    </xiami_content_songs_audio_getrefrain_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部