⌘K

Spark Asset Create Group

spark_asset_create_group

Spark Asset Create Group 是 SeaArt 的资产管理 API, 用于创建资产组以整理资产库中的媒体文件.

接口提示

spark_asset_create_group 必须在 spark_asset_create 之前调用. 本接口返回的 GroupId 是调用 spark_asset_create 的必填参数

spark_asset_create_groupGroupType 仅支持 AIGC

ProjectName 必须是已存在的项目名称, 填写不存在的项目名称会返回错误 NotFound.ProjectName. 建议不填此参数, 使用默认项目

认证

authorization string required

所有 API 均使用 Bearer Token 鉴权

获取 API Key:

访问 API Key 管理页面 获取 API Key

用法:

将以下 Header 添加到请求中:

Authorization: Bearer YOUR_API_KEY

参数

model string required

请求使用的模型 ID

值: spark_asset_create_group


Name string required

自定义资产组名称

最大长度: 64 个字符


GroupType string required

资产组类型

值: AIGC(数字人,目前仅支持此类型)


ProjectName string

项目名称, 建议不填此参数使用默认项目

默认值: default


轮询

由于结果生成需要时间,您需要在创建任务后轮询任务状态

初始响应只返回任务 ID 和初始状态等信息,最终生成结果需通过使用该任务 ID 轮询任务状态接口获取

轮询请求与响应示例见右侧

响应格式

error object

错误信息, 仅在 status 为 failed 时存在

code string

错误码

message string

详细错误信息


output array

资产组创建结果, 仅在 status 为 completed 时存在

content array

结果内容列表

type string

内容类型

值: text

url string

该 API 始终为空字符串

text string

JSON 序列化字符串, 解析后从 Result.Id 中获取创建的资产组 ID

示例: {"ResponseMetadata": {...}, "Result": {"Id": "group-20260414180602-52qww"}}


usage object

用量统计, 仅在 status 为 completed 时存在

cost string

总费用(美元)

discount number

折扣金额


metadata object

元数据信息