---
title: "获取指纹计算状态"
method: GET
path: "/scan/fingerprints/status"
tags: ["扫描管理"]
---

# 获取指纹计算状态

`GET /scan/fingerprints/status`

返回 ffmpeg chromaprint 可用性、本地歌曲指纹计算统计（含尝试失败数）以及「扫描后自动计算指纹」开关状态

## Response `200`

指纹状态

- HandlersFingerprintStatus
  - `auto_enabled` boolean — AutoEnabled 扫描后是否自动计算指纹（config scan_auto_fingerprint）
  - `chromaprint_available` boolean — ChromaprintAvailable ffmpeg 是否带 chromaprint muxer，false 时无法计算指纹
  - `computed` integer — Computed 已有指纹的数量
  - `failed` integer — Failed 尝试过但失败的数量（无音轨 / 文件损坏 / 超时），不会自动重试， 需要「重新计算全部」才会再试
  - `missing` integer — Missing 尚未尝试过计算的数量（= total - computed - failed）
  - `total` integer — Total 本地歌曲总数

## Other responses

- `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/6781c074532c/schema)