创建素材组

Authorization

AuthorizationBearer <token>

兼容网关 API Key，例如 sk-...。

In: header

Query Parameters

Action*string

Default"CreateAssetGroup"

Version*string

Default"2024-01-01"

Header Parameters

X-Date?string

使用 HMAC-SHA256 时必填，格式为 YYYYMMDDTHHMMSSZ。

X-Content-Sha256?string

使用 HMAC-SHA256 时必填，请求体 SHA-256 小写十六进制。

Request Body

application/json

Name*string

素材组名称。

Length1 <= length <= 64

Description?string

素材组描述。

Lengthlength <= 300

GroupType?string

Default"AIGC"

Value in"AIGC"

ProjectName?string

资源所属项目名称，大小写敏感。省略时使用 default。

Default"default"

Response Body

application/json

curl -X POST "https://jieyun.cc/?Action=CreateAssetGroup&Version=2024-01-01" \
  -H "Content-Type: application/json" \
  -d '{
    "Name": "产品素材",
    "Description": "产品图片和视频素材",
    "GroupType": "AIGC",
    "ProjectName": "default"
  }'

curl -X POST "https://jieyun.cc/?Action=CreateAssetGroup&Version=2024-01-01" \  -H "Content-Type: application/json" \  -d '{    "Name": "产品素材",    "Description": "产品图片和视频素材",    "GroupType": "AIGC",    "ProjectName": "default"  }'

{
  "ResponseMetadata": {
    "RequestId": "20260721000000000000000000000000",
    "Action": "CreateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "group-202607210001-example"
  }
}

{
  "ResponseMetadata": {
    "RequestId": "string",
    "Action": "CreateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing",
    "Error": {
      "Code": "string",
      "Message": "string"
    }
  }
}

Empty

接口说明

创建用于管理素材资产的 Asset Group。普通素材组当前只支持 AIGC 类型；真人素材组由真人认证流程创建，类型为 LivenessFace。本文档已按火山引擎官方接口说明校对。

POST https://jieyun.cc/?Action=CreateAssetGroup&Version=2024-01-01
Content-Type: application/json
Authorization: Bearer <API_KEY>

也可使用 AK/SK HMAC-SHA256 签名，详见素材库认证与签名。

首次创建前的准备

首次创建素材组前，需要先在控制台完成相关授权。未完成授权时，服务端会拒绝创建请求。

请求参数

字段	类型	必选	说明
`Name`	string	是	素材组名称，最长 64 个字符。
`Description`	string	否	素材组描述，最长 300 个字符。
`GroupType`	string	否	默认 `AIGC`；普通创建流程当前仅支持该值。
`ProjectName`	string	否	资源所属项目，默认 `default`，大小写敏感。

{
  "Name": "产品人像素材",
  "Description": "用于产品演示视频",
  "GroupType": "AIGC",
  "ProjectName": "default"
}

响应内容

成功响应的 Result.Id 是新素材组 ID，后续创建、查询、更新或删除素材时需要使用。

{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "CreateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "group-2026-example"
  }
}

200application/json

400application/json

401

403

404

503

application/json

application/json