生成选曲清单链接 / Publish a shareable pick list

把挑好的曲目发布成一个可分享的选曲清单页面,用户打开即可试听、对比、下载小样。 Publishes the selected tracks as a shareable pick-list page the user can open, audition and download from.

何时用 / When: 完成选曲、要把结果交付给用户时(这是整个流程的交付物)。

入参 / Args: sections ≤ 20,每 section tracks ≤ 50,总计 ≤ 200。中文文案一律用敬语「您」。 cueStart/cueEnd(秒)用于标注该段落对应的画面时间码。tracks 里带上 library_type,tier 会自动判定。 不存在或已下架的曲目会被剔除进 dropped[],不会整单失败。

返回 / Returns: { code, url, shortUrl, trackCount, dropped[] }。把 url 或 shortUrl 交给用户。

post/agent/v1/km_create_result_set

Request

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

Request body

titlestring required

清单标题(中文)。

summarystring

一段中文导语,用敬语「您」,可空。

tier'essential' | 'premium'

Omit to derive from the tracks' library_type.

anchorKind'none' | 'audio' | 'track'
anchorLabelstring

e.g. 参考音频《demo.wav》00:12–00:35

expiresAtstring nullable

ISO datetime, or null for no expiry.

searchIdsstring[]

searchId values from the km_search / km_similar_* calls that produced these picks (attribution).

Response

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

object required

Changes

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