新建标签

新建标签

更新时间：2025-08-21

POST

https://qianfan.baidubce.com/v2/tag?Action=CreateTag

为知识库新增标签

每个用户最多可创建 20 个标签键 (Key)，每个标签键下最多可添加 300 个标签值 (Value)。

权限说明

调用本API，需使用API Key鉴权方式。Authorization的值为Bearer <API Key>。获取API Key流程，请查看授权。

请求参数

Headers 参数

除公共头域外，无其它特殊头域

Body 参数

key string

仅支持中文、英文、数字、下划线（_）、中划线（-）、英文点（.），长度1-50

必选

values array

仅支持中文、英文、数字、下划线（_）、中划线（-）、英文点（.），长度1-50

必选

显示子属性隐藏子属性

items string

最多可添加 300 个标签值

请求结构

POST /v2/tag?Action=CreateTag HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json

{
    "key": "tag_key",
    "values": ["value2","value1"]
}

示例代码

curl

curl --location 'https://qianfan.baidubce.com/v2/tag?Action=CreateTag' \
--header 'Authorization: Bearer authorization string' \
--header 'Content-Type: application/json' \
--data '{
    "key": "tag_key",
    "values": ["value2","value1"]
}'

返回响应

Headers 参数

除公共头域外，无其它特殊头域

返回参数

requestId string

请求ID

必选

正确响应示例错误响应示例

JSON

HTTP/1.1 200 OK
{
    "requestId": "f5fb7546-33d5-47ae-97e4-7b8ce9e02d55",
}