---
title: "获取歌曲封面图片"
method: GET
path: "/songs/{id}/cover"
tags: ["歌曲管理"]
---

# 获取歌曲封面图片

`GET /songs/{id}/cover`

根据歌曲 ID 获取封面图片。优先使用本地封面文件（CoverPath），其次代理 CoverURL。CoverURL 支持以 "/" 开头的相对路径，服务端自动经 InternalURLResolver 解析为内部 URL（含 access_token），用于插件歌曲封面代理。可选 query 参数 w：把本地封面等比缩放到该宽度（物理像素，绝不放大、上限 1024）后以 JPEG 返回，用于 Web 端降低 GPU 纹理体积（songloft-org/songloft#309）；缺省或非法时返回原图。缩略仅作用于本地封面，远程代理封面忽略 w。

## Path parameters

- `id` integer, required

## Query parameters

- `w` integer

## Response `200`

封面图片

## Other responses

- `400` — 无效的歌曲 ID
- `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)