---
title: "反代 HLS 子层 m3u8"
method: GET
path: "/songs/{id}/hls/playlist"
tags: ["电台与 HLS"]
---

# 反代 HLS 子层 m3u8

`GET /songs/{id}/hls/playlist`

HLS 反代开启时，由 ServeProxy 改写后的 m3u8 内回链触发。拉取上游 m3u8 → 同源校验 → 改写 URI → 回写给 player。

## Path parameters

- `id` integer, required

## Query parameters

- `u` string, required

## Response `200`

改写后的 m3u8 文本

## Other responses

- `400` — song_id 或 u 参数无效
- `403` — 非同源 URL 拒绝代理（SSRF 防护）
- `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/e4d4950ef665/schema)