---
title: "更新音量均衡配置"
method: PUT
path: "/settings/volume-normalize"
tags: ["设置"]
---

# 更新音量均衡配置

`PUT /settings/volume-normalize`

启用或关闭 EBU R128 音量均衡。启用后，所有不含显式 normalize 查询参数的播放请求将自动应用 loudnorm 滤镜（需要 ffmpeg）。

## Request body

- HandlersVolumeNormalizeRequest
  - `enabled` boolean

## Response `200`

更新后的启用状态

- HandlersVolumeNormalizeRequest
  - `enabled` boolean

## Other responses

- `400` — 请求格式错误
- `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/ee41778dbf8f/schema)