---
title: "获取歌单封面"
method: GET
path: "/playlists/{id}/cover"
tags: ["歌单管理"]
---

# 获取歌单封面

`GET /playlists/{id}/cover`

返回歌单封面图片文件。可选 query 参数 w：把本地封面等比缩放到该宽度（物理像素，绝不放大、上限 1024）后以 JPEG 返回，用于 Web 端降低 GPU 纹理体积（songloft-org/songloft#309）；缺省或非法时返回原图。缩略仅作用于本地封面，远程代理封面忽略 w。

## Path parameters

- `id` integer, required

## Query parameters

- `w` integer

## Response `200`

封面图片

## Other responses

- `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/77467de6ed1b/schema)