⌘K

Spark Asset Get

spark_asset_get

Spark Asset Get 是 SeaArt 的资产管理 API, 用于通过资产 ID 查询单个资产的详细信息.

接口提示

spark_asset_get 需要通过 spark_asset_create 获取的资产 Id. 响应中 StatusActive 表示资产已就绪, 可正常使用

认证

authorization string required

所有 API 均使用 Bearer Token 鉴权

获取 API Key:

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

用法:

将以下 Header 添加到请求中:

Authorization: Bearer YOUR_API_KEY

参数

model string required

请求使用的模型 ID

值: spark_asset_get


Id string required

待查询的资产 ID


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
Name:资产名称
URL:资产的签名下载地址
AssetType:媒体类型(ImageVideoAudio
GroupId:资产所属的资产组 ID
Status:资产状态
CreateTime:创建时间
UpdateTime:最后更新时间
ProjectName:项目名称


usage object

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

cost string

总费用(美元)

discount number

折扣金额


metadata object

元数据信息