---
title: "刷新歌曲元数据"
method: POST
path: "/songs/refresh-metadata"
tags: ["歌曲管理"]
---

# 刷新歌曲元数据

`POST /songs/refresh-metadata`

对所有元数据缺失且本地有文件的歌曲（本地歌曲及已缓存的网络歌曲）从文件提取时长、比特率、采样率、格式及标签并回填。未缓存的网络歌曲不参与，其元数据在播放缓存落盘后自动回填。已在运行时返回 409。

## Response `202`

已启动

- object

## Other responses

- `409` — 已在运行
- `500` — 启动失败

---

[API](https://skmtc.net/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.net/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/songloft-org/songloft-api/versions/e4d4950ef665/schema)