---
title: "更新「扫描后自动计算音频指纹」开关"
method: PUT
path: "/settings/scan-auto-fingerprint"
tags: ["扫描管理"]
---

# 更新「扫描后自动计算音频指纹」开关

`PUT /settings/scan-auto-fingerprint`

开启后每次扫描结束会在后台为缺失指纹的本地歌曲计算 chromaprint 指纹（并发按 CPU 自适应，单文件采样前 120 秒，失败只尝试一次）。大音乐库开启前请留意 CPU 开销。

## Request body

- HandlersScanAutoFingerprintRequest
  - `enabled` boolean

## Response `200`

返回 enabled 字段

- object

## 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/3597db751d49/schema)