Spark Asset Create

接口提示

spark_asset_create 需要先通过 spark_asset_create_group 获取 GroupId. 不填 GroupId 会返回错误 MissingParameter.GroupId

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

---

Name string required

资产名称

最大长度: 64 个字符

---

URL string required

待上传媒体文件的 URL 地址

---

AssetType string required

资产的媒体类型

可选值: Image, Video, Audio

---

GroupId string required

资产所属的资产组 ID, 通过 spark_asset_create_group 获取

---

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

---

usage object

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

cost string

总费用（美元）

discount number

折扣金额

---

metadata object

元数据信息

---