---
title: "更新歌曲歌词"
method: PUT
path: "/songs/{id}/lyrics"
tags: ["歌曲管理"]
---

# 更新歌曲歌词

`PUT /songs/{id}/lyrics`

更新指定歌曲的歌词内容和来源。url 来源传 lyric_remote_url,其它来源传 lyric/tlyric/rlyric/lxlyric 四字段。响应里的 file_write_status 表示是否把元数据回写到本地音频文件:written=已写入,unchanged=未变更(非本地歌曲/无文件路径/不支持的扩展名/url 来源),skipped=标签已一致无需写入,failed=尝试写入但失败(DB 已成功)。lyric_source=manual 用于标记用户手动调整,scanner 重扫时不会覆盖

## Path parameters

- `id` integer, required

## Request body

- object
  - `lxlyric` string
  - `lyric` string
  - `lyric_remote_url` string
  - `lyric_source` string
  - `rlyric` string
  - `tlyric` string

## Response `200`

更新成功

- object
  - `file_write_status` string
  - `message` string

## Other responses

- `400` — 请求数据错误
- `404` — 歌曲不存在
- `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)