---
title: "流式播放歌曲"
method: GET
path: "/songs/{id}/play"
tags: ["歌曲管理"]
---

# 流式播放歌曲

`GET /songs/{id}/play`

按 song.ID 流式返回音频。内部根据 song.type 分发到本地文件 / 缓存下载 / 直链下载 / 电台 302。

## Path parameters

- `id` integer, required

## Query parameters

- `format` string
- `quality` string
- `track` integer
- `prefetch` string
- `media` string
- `hls` string
- `normalize` string
- `radio_transcode` string
- `seek` number
- `speed` number

## Response `200`

音频文件

## Other responses

- `202` — 预拉取已触发
- `302` — 电台流重定向
- `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/d5abb8b643e9/schema)