接口提示
spark_asset_get 需要通过 spark_asset_create 获取的资产 Id. 响应中 Status 为 Active 表示资产已就绪, 可正常使用
认证
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内容类型
值:
texturl
string该 API 始终为空字符串
text
stringJSON 序列化字符串, 解析后可获取
Result中的以下字段:
Id:资产 ID
Name:资产名称
URL:资产的签名下载地址
AssetType:媒体类型(Image、Video、Audio)
GroupId:资产所属的资产组 ID
Status:资产状态
CreateTime:创建时间
UpdateTime:最后更新时间
ProjectName:项目名称
usage object
用量统计, 仅在 status 为 completed 时存在
cost
string总费用(美元)
discount
number折扣金额
metadata object
元数据信息