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

# 刷新远程歌曲元数据

`POST /songs/refresh-metadata`

对所有元数据缺失的远程歌曲，通过 ffprobe 探测时长、比特率、采样率、格式及标签并回填。已在运行时返回 409。

## Response `202`

已启动

- object

## Other responses

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

---

[API](https://skmtc.dev/songloft-org/apis/songloft-api.md) · [All operations](https://skmtc.dev/songloft-org/apis/songloft-api/llms.txt) · [OpenAPI document](https://skmtc.dev/songloft-org/apis/songloft-api/revisions/7cbe0940a38b?raw)