---
title: "获取标签同步到文件开关"
method: GET
path: "/settings/tag-sync-to-file"
tags: ["歌曲管理"]
---

# 获取标签同步到文件开关

`GET /settings/tag-sync-to-file`

## Request

- Base URL: `https://localhost:58091/api/v1`
- URL: `https://localhost:58091/api/v1/settings/tag-sync-to-file`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/songloft-org/apis/songloft-api/docs/settings/tag-sync-to-file/get.ts> (a function with typed inputs; its response is checked against the schema)

获取“自定义标签同步写入音频文件 SONGLOFT_TAGS 字段”开关的当前状态。开启后，每次修改歌曲标签时会同步写入音频文件元数据。默认关闭。

## Response `200`

开关状态 {enabled: bool}

- object

## Changes

- **2026-09-20** `257459a6ca83`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/songloft-org/apis/songloft-api/changes/settings/tag-sync-to-file/get.md)

---

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