---
title: "获取歌曲歌词"
method: GET
path: "/songs/{id}/lyric"
tags: ["歌曲管理"]
---

# 获取歌曲歌词

`GET /songs/{id}/lyric`

根据 song.ID 返回 LyricPayload JSON，含 lyric/tlyric/rlyric/lxlyric。优先级：旁挂 .lrc 文件 > DB url > DB payload > 歌词搜索插件。manual 歌词不被旁挂覆盖。传 refresh=1 时强制重新抓取：跳过库中自动获取的旧歌词(空/scraped/cached)重跑歌词搜索插件，响应挂 no-store 不缓存；file/embedded/manual 等权威歌词不被覆盖。

## Path parameters

- `id` integer, required

## Query parameters

- `refresh` boolean

## Response `200`

LyricPayload

- object

## Other responses

- `404` — 歌曲或歌词不存在
- `502` — 歌词获取失败

---

[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/revisions/ee41778dbf8f/schema)