---
title: "更新扫描标题来源配置"
method: PUT
path: "/settings/scan-title-source"
tags: ["扫描管理"]
---

# 更新扫描标题来源配置

`PUT /settings/scan-title-source`

tag：优先使用音频标签中的标题；filename：始终使用文件名（不含扩展名）作为标题。切换后需以「重新导入」模式扫描才能生效。

## Request body

- HandlersScanTitleSourceRequest
  - `title_source` 'tag' | 'filename'

## Response `200`

返回 title_source 字段

- HandlersScanTitleSourceRequest
  - `title_source` 'tag' | 'filename'

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