更新素材分组

国内端点

https://openai.qiniu.com

PATCH

/v1/asset-groups/{qgroupid}

更新指定分组的 name 或 description。

约束：

name 最长 64 字符

description 最长 300 字符

至少需要传入 name 或 description 中的一个

权限：只能更新当前用户自己的分组。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Body 参数application/json必填

示例

返回响应

🟢200

application/json

更新成功，返回更新后的分组信息

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://openai.qiniu.com/v1/asset-groups/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "更新后的分组名",
    "description": "新的分组描述"
}'

响应示例

{
    "qgroupid": "string",
    "type": "aigc",
    "name": "string",
    "description": "string",
    "model": "string",
    "status": "pending",
    "is_default": true,
    "fail_reason": "string",
    "created_at": 0,
    "updated_at": 0
}

修改于 2026-05-28 08:07:34

查询素材分组列表

创建素材