曲目剪辑版本 / Cutdown versions of a track

列出同一首曲子的全部剪辑版本(Full Length / 60 Sec / 30 Sec / 20 Sec / 15 Sec 等)。 Lists every cutdown version of one track (Full Length / 60 Sec / 30 Sec / 20 Sec / 15 Sec …).

⚠️ km_search 只索引主曲(Solr 里 track_is_main=Y),剪辑版拿不到,只能靠本工具取。 km_search only indexes main tracks; the shorter cutdowns are invisible to it and can ONLY be fetched here.

何时用 / When: 广告、TVC、预告片这类有硬性时长的项目,交付候选之前对每首都查一次—— 有现成的 60s/30s/15s 版本,客户就不必自己剪;没有就要在交付说明里讲清楚需要自行剪辑。

入参 / Args: albumCode = 曲目的 album_code;trackNumber = 主曲的 track_number(都取自 km_search 返回的曲目对象)。 libraryType 可选:原样透传 km_search 里那首曲子的 library_type,用来判定 web_url 的 essential / premium 段(本端点自身不返回该字段)。

返回 / Returns: { albumCode, trackNumber, total, versions[] },versions 按时长从长到短排,字段与 km_search 的曲目对象同构。 看 track_version(版本名)、track_duration(秒)、orginal_time(mm:ss)、track_mixout(如 Backing Vocals Only,即去人声版)。 注意:剪辑版只有版本名 / 时长 / mixout / 英文描述,track_bpm 与四维标签(mood/genre/instrumentation/tempo)只有主曲那行有——它们本来就是同一首曲子,按主曲的值理解即可。 专辑号或曲目号不存在时返回空 versions[],不报错。

返回的 track_url 仅供试听/临时分析,见 audioNotice。 Returned track_url values are for audition / temporary analysis only; see audioNotice.

post/agent/v1/km_track_versions

Request

  • Base URL: https://share.kindlemusic.cn
  • URL: https://share.kindlemusic.cn/agent/v1/km_track_versions
  • Auth: one of:
    • none
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://share.kindlemusic.cn/oauth/authorize, token URL https://share.kindlemusic.cn/oauth/token)

Request body

albumCodestring required

Album code as returned by km_search (field "album_code"), e.g. "NYB17".

libraryTypestring

Pass through library_type from the km_search result so web_url gets the right tier.

Response

tool 结果(与 MCP tools/call 返回的 JSON 相同)

object required

Changes

No recorded changes to this operation across all 1 revision of this API.