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

# 更新音量均衡配置

`PUT /settings/volume-normalize`

启用或关闭 EBU R128 音量均衡，并可选地设置目标响度（LUFS，范围 -40 ~ -5，默认 -16）。启用后，所有不含显式 normalize 查询参数的播放请求将自动应用 loudnorm 滤镜（需要 ffmpeg）。loudness 字段可省略：省略时仅切换开关、不改动响度配置（向后兼容旧前端）。

## Request body

- HandlersVolumeNormalizeRequest
  - `enabled` boolean
  - `loudness` number

## Response `200`

更新后的启用状态与目标响度

- HandlersVolumeNormalizeRequest
  - `enabled` boolean
  - `loudness` number

## 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/revisions/fe8dcc0de54a/schema)