创建素材分组

国内端点

https://openai.qiniu.com

POST

/v1/asset-groups

创建一个新的素材分组。

处理流程：

鉴权检查 API Key

异步提交分组创建任务

立即返回 qgroupid 和 pending 状态

默认分组规则：用户的首个 Group 会自动设为默认（is_default=true）。

说明：分组创建为异步流程，调用方需轮询 GET /v1/asset-groups/{qgroupid} 获取最终状态。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

返回响应

🟢200

application/json

创建成功（注意：实际状态为 pending，需轮询查询最终状态）

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://openai.qiniu.com/v1/asset-groups' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "我的虚拟人像分组",
    "description": "用于存放公司形象虚拟人像素材",
    "type": "aigc",
    "model": "bytedance/doubao-seedance-2-0-260128"
}'

响应示例

{
    "qgroupid": "qgroup-uid001-1716100000000000000",
    "type": "aigc",
    "name": "我的虚拟人像分组",
    "description": "用于存放公司形象虚拟人像素材",
    "status": "pending",
    "is_default": true,
    "created_at": 1716100000,
    "updated_at": 1716100000
}

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

七牛云虚拟人像素材使用指南

查询单个素材分组