# 创建素材分组

创建一个新的素材分组（AssetGroup），用于组织管理素材文件。

每个分组归属于当前认证用户，不同用户之间的分组相互隔离。
同一用户下的所有 API Key 共享素材分组。

**第三方 SaaS** 集成方可在 body 里传 `external_user_id`，把新建的 group 绑到具体 end-user（同 API key 下的其他 end-user 看不到）。

## POST /v1/asset-groups

> 创建素材分组

创建一个新的素材分组（AssetGroup），用于组织管理素材文件。

每个分组归属于当前认证用户，不同用户之间的分组相互隔离。
同一用户下的所有 API Key 共享素材分组。

**第三方 SaaS** 集成方可在 body 里传 `external_user_id`，把新建的 group 绑到具体 end-user（同 API key 下的其他 end-user 看不到）。

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `application/json`

- **name** `string` **(required)**  
  分组名称
- **description** `string`  
  分组描述（可选）
- **external_user_id** `string`  
  第三方 SaaS 终端用户标识符（opaque 字符串，≤128 字符，可选）。设了之后, 该 group 绑定到 (api_user, external_user_id)，同 API key 下的其他 end-user 看不到。不传 = 老行为（单租户共享）。

### Response

- **Id** `string`  
  素材分组 ID
- **Name** `string`  
  分组名称
- **Description** `string`  
  分组描述
- **GroupType** ``AIGC``  
  分组类型，固定为 `AIGC`
- **CreateTime** `string`  
  创建时间
- **UpdateTime** `string`  
  最后更新时间

### Error Codes

- `400`: 
- `401`: 
- `429`: 
- `502`: