接口提示
spark_asset_create_group 必须在 spark_asset_create 之前调用. 本接口返回的 GroupId 是调用 spark_asset_create 的必填参数
spark_asset_create_group 的 GroupType 仅支持 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内容类型
值:
texturl
string该 API 始终为空字符串
text
stringJSON 序列化字符串, 解析后从
Result.Id中获取创建的资产组 ID示例:
{"ResponseMetadata": {...}, "Result": {"Id": "group-20260414180602-52qww"}}
usage object
用量统计, 仅在 status 为 completed 时存在
cost
string总费用(美元)
discount
number折扣金额
metadata object
元数据信息