---
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` — 读取失败

## Changes

- **2026-07-23** `92876dc9d5a4` — 1 info
  - added the new optional `query` request parameter `w`

[Change history](https://skmtc.dev/songloft-org/apis/songloft-api/changes/playlists/:id/cover/get.md)

---

[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-service-production.skmtc.workers.dev/v1/apis/songloft-org/songloft-api/revisions/5b1368253f6c/schema)