---
title: "上传参考音频 / Upload reference audio"
method: POST
path: "/agent/v1/uploads"
---

# 上传参考音频 / Upload reference audio

`POST /agent/v1/uploads`

## Request

- Base URL: `https://share.kindlemusic.cn`
- URL: `https://share.kindlemusic.cn/agent/v1/uploads`
- 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:audio`)

raw body，≤20971520 字节，换 uploadId（30 分钟）给 km_similar_by_audio。没有凭据时改用 km_request_upload 签的一次性地址。

## Headers

- `X-File-Name` string

## Response `200`

{ uploadId, expiresAt, sizeBytes, sha256 }

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