接口提示
spark_asset_get_intl 通过统一生成接口创建平台任务，模型参数放在 input[0].params
spark_asset_get_intl 返回 type: "text" 的结果，text 是 JSON 字符串，需要解析后读取 Result
spark_asset_get_intl 使用海外素材资源，请使用同一套海外模型完成后续操作，不假定国内与海外素材 ID 通用
spark_asset_get_intl 使用创建素材返回的 Id，包装等待素材达到 Active 后成功结束；素材达到 Failed 时任务失败
spark_asset_get_intl 的下载地址位于解析后的 Result.URL，output[].content[].url 为空字符串
认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的客户模型 ID
值: spark_asset_get_intl
input array 必需
传入一个包含 params 的对象，以下参数均位于 input[0].params
Id string 必需
解析 spark_asset_create_intl 的任务结果，使用 Result.Id；不使用创建时返回的平台任务 ID
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
创建响应中的 status: "completed" 只表示创建请求完成。使用返回的 id 查询同一个平台任务，任务查询到 completed 且包含 output 后解析结果
| 任务查询状态 | 处理方式 |
|---|---|
in_progress | 继续查询同一个 task_id |
completed | 解析结果中的 text |
failed | 读取 error.code 和 error.message |
响应格式
右侧成功示例仅展示相关字段，实际结果可能包含额外元数据。text 保持 JSON 字符串格式，不能当作已解析对象读取
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 平台任务 ID，用于任务查询 |
output[].content[].type | string | text |
output[].content[].text | string | JSON 序列化字符串，解析后读取 Result |
output[].content[].url | string | 空字符串，不是素材下载地址 |
usage.cost | string | 费用，单位 USD，当前为 0 |
error | object | 任务失败时的错误信息 |
metadata | object | 任务耗时等元数据，返回时可读取 |
解析结果
const content = task.output.flatMap(item => item.content ?? [])
.find(item => item.type === "text");
const result = JSON.parse(content.text).Result;
const assetId = result.Id;
const status = result.Status;
const downloadURL = result.URL;| Result 字段 | 说明 |
|---|---|
Id | 素材 ID |
GroupId | 所属素材组 ID |
Name | 素材名称 |
AssetType | 媒体类型 |
Status | Active 表示可用 |
URL | 有有效期的签名下载地址，不是永久链接 |
ProjectName | 所属项目 |
CreateTime、UpdateTime | 创建及更新时间，返回时可读取 |
Result.URL 不经过平台图片转存，请及时下载，不要持久化为永久访问地址。若下载链接已过期，可重新提交查询素材请求获取当前返回地址
完整流程
平台 task_id 用于任务查询，组的 Result.Id 用作 GroupId，素材的 Result.Id 用作查询素材的 Id；三者不可互换
价格
当前该素材模型免费，成功响应中的 usage.cost 为 "0"。创建组、创建素材和查询素材三个模型均为免费；此免费设置不包含后续图片或视频生成费用
错误处理
任务失败时读取 error.code、error.message。检查参数、URL 可访问性及素材或组 ID；包装不保证返回底层接口的具体错误码。默认项目示例应始终使用同一套海外素材模型
无效素材 ID 的失败响应示例，仅展示相关字段：
{
"id": "task_id",
"created_at": 1791511200000,
"status": "failed",
"model": "spark_asset_get_intl",
"error": {
"code": "RUNTIME_CREATE_PROVIDER_FAILED",
"message": "provider async create failed: http_status=400"
}
}