POST /tag

在音频库中创建一个新标签。适合脚本化工作流，例如在导入新素材库之前批量创建一套标准标签。

此端点也可以通过 POST /api/tag 访问，两种路径完全等价。

请求

{
  "title": "Thunder",
  "color": "#5E5CE6"
}

请求字段

字段	类型	描述
title	string	必填。 标签名称（前后空白会被自动去除，不能为空）
color	string	可选的十六进制颜色，例如 "#FF4500"。若不传则自动分配颜色

响应

返回 201 Created 与新标签信息。

{
  "id": 42,
  "title": "Thunder",
  "color": "#5E5CE6"
}

响应字段

字段	类型	描述
id	number	新标签的唯一标识符
title	string	标签名称
color	string	标签颜色（十六进制字符串）

错误

状态码	含义
400	缺少 title 字段，或去除空白后标题为空