创建分组

POST/xmind-cloud-platform/openapi/volcengine?Action=CreateAssetGroup&Version=2024-01-01

创建一个素材分组，返回分组 ID。

请求参数

Action 与 Version 通过查询参数传递，其余参数放在 JSON 请求体中。

Namestring必填

分组名称。

默认值：-

GroupTypestring可选

分组类型，如传值必须为 AIGC。

默认值：-

Descriptionstring可选

分组描述，可选。

默认值：-

ProjectNamestring可选

项目名，固定使用 default。

默认值：-

分组类型必须为 AIGC

GroupType 如传值必须为 AIGC。

认证

所有接口使用同一套 V4 签名，凭证与签名方式见火山方舟素材库 API 概览。以下请求头为通用要求：

Content-Typestring必填

固定为 application/json。

默认值：application/json

Hoststring必填

实际访问的域名和端口；包含端口时必须写入签名。

默认值：-

X-Datestring必填

UTC 时间，格式 yyyyMMdd'T'HHmmss'Z'，例如 20261022T131900Z；与平台时间偏差不能超过 300 秒。

默认值：-

X-Content-Sha256string必填

原始请求体的 SHA-256 小写十六进制。

默认值：-

Authorizationstring必填

V4 HMAC-SHA256 签名。

默认值：-

响应

Idstring可选

新建分组 ID。

默认值：-

错误

Code	说明
400	InvalidParameter：参数格式或取值非法
401	SignatureDoesNotMatch、InvalidTimestamp、XContentSha256Mismatch、MissingParameter.Authorization 等签名或时间相关错误
403	AccessDenied 凭证被禁用或无权限；ExpiredToken 凭证已过期
429	QuotaWriteQPMExceeded 每分钟写入额度用尽；AccountFlowLimitExceeded 每秒请求上限触发；TooManyRequests 请求过于频繁

相关

• 查询分组列表 - 见对应接口页
• 重命名分组 - 见对应接口页

请求示例POST

AccessKey

SecretKey

Host

X-Date

请求体

{ "Name": "营销素材", "GroupType": "AIGC", "Description": "可选", "ProjectName": "default" }

填写 AccessKey 与 SecretKey 后，会自动补全 X-Date、X-Content-Sha256 与 Authorization。

curl --request POST \
  "/xmind-cloud-platform/openapi/volcengine?Action=CreateAssetGroup&Version=2024-01-01" \
  --header "Content-Type: application/json" \
  --header "Host: api.example.com" \
  --header "X-Date: <x-date>" \
  --header "X-Content-Sha256: <payload-hash>" \
  --header "Authorization: HMAC-SHA256 Credential=<AK>/20260101/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<signature>" \
  --data '{
    "Name": "营销素材",
    "GroupType": "AIGC",
    "Description": "可选",
    "ProjectName": "default"
  }'

凭证只在浏览器本地参与计算，不会保存或上传。

响应示例

{
  "Id": "2113257314734424065"
}