---
title: "获取视频 HLS 子资源"
method: GET
path: "/songs/{id}/video-hls/{path}"
tags: ["歌曲管理"]
---

# 获取视频 HLS 子资源

`GET /songs/{id}/video-hls/{path}`

返回视频 HLS 转码生成的子播放列表或 .ts 切片文件。由 hls.js 根据 master playlist 自动请求。支持多音轨场景下的子目录结构（stream_0/playlist.m3u8, stream_0/0001.ts 等）。

## Path parameters

- `id` integer, required
- `path` string, required

## Response `200`

HLS 子资源

## Other responses

- `400` — 无效请求
- `404` — 资源不存在

## Changes

- **2026-07-25** `7cc882f4c8db` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/songloft-org/apis/songloft-api/changes/songs/:id/video-hls/:path/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.dev/songloft-org/apis/songloft-api/revisions/03abcc98ecdf?raw)