---
title: "触发批量指纹计算"
method: POST
path: "/scan/fingerprints"
tags: ["扫描管理"]
---

# 触发批量指纹计算

`POST /scan/fingerprints`

异步为本地歌曲计算音频指纹，需要 ffmpeg 支持 chromaprint。若已有任务在运行则打断重启。传入 recompute_all=true 时清空已有指纹后重新计算全部。

## Request body

- HandlersStartFingerprintRequest
  - `recompute_all` boolean

## Response `200`

任务已启动

- object

## Other responses

- `400` — chromaprint 不可用

---

[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/7cbe0940a38b?raw)