---
title: "生成选曲清单链接 / Publish a shareable pick list"
method: POST
path: "/agent/v1/km_create_result_set"
---

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

`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`)

把挑好的曲目发布成一个可分享的选曲清单页面，用户打开即可试听、对比、下载小样。
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 交给用户。

## Request body

- object
  - `title` string, required: 清单标题（中文）。
  - `summary` string: 一段中文导语，用敬语「您」，可空。
  - `tier` 'essential' | 'premium': Omit to derive from the tracks' library_type.
  - `anchorKind` 'none' | 'audio' | 'track'
  - `anchorLabel` string: e.g. 参考音频《demo.wav》00:12–00:35
  - `expiresAt` string, nullable: ISO datetime, or null for no expiry.
  - `searchIds` string[]: searchId values from the km_search / km_similar_* calls that produced these picks (attribution).
  - `sections` object[], required: At most 20 sections, 50 tracks each, 200 tracks total.
    - `title` string, required
    - `note` string
    - `cueStart` number: Scene start in seconds.
    - `cueEnd` number: Scene end in seconds.
    - `tracks` object[], required
      - `id` union, required: Track id from km_search.
        - string
        - number
      - `note` string: Why this track fits, in Chinese, addressing the user as「您」.
      - `library_type` string: Pass through from the search result so the tier can be derived.

## Response `200`

tool 结果（与 MCP tools/call 返回的 JSON 相同）

- object

## Other responses

- `400`: 入参错误或 km 业务错误：{ error, message, hint? } / { error:"km_error", code, message }
- `401`: 需要 scope 的 tool 缺少或带了无效凭据

---

[API](https://skmtc.dev/kindlemusic/apis/kindle-music-agent-api.md) · [All operations](https://skmtc.dev/kindlemusic/apis/kindle-music-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kindlemusic/apis/kindle-music-agent-api/revisions/2673f364b5b0?raw)