接口提示
spark_asset_create_intl 通过统一生成接口创建平台任务，模型参数放在 input[0].params
spark_asset_create_intl 返回 type: "text" 的结果，text 是 JSON 字符串，需要解析后读取 Result
spark_asset_create_intl 使用海外素材资源，请使用同一套海外模型完成后续操作，不假定国内与海外素材 ID 通用
spark_asset_create_intl 必须使用创建组返回的 GroupId，创建素材完成后还需通过 spark_asset_get_intl 确认可用状态
认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的客户模型 ID
值: spark_asset_create_intl
input array 必需
传入一个包含 params 的对象，以下参数均位于 input[0].params
Name string 必需
素材名称
最大长度: 64 个字符
GroupId string 必需
解析 spark_asset_create_group_intl 的任务结果，使用 Result.Id
AssetType string 必需
媒体类型。当前完整验证链路使用 Image；Video、Audio 为协议选项，未覆盖同等实测
可选值: Image、Video、Audio
URL string 必需
待导入媒体的可访问 URL，需与 AssetType 匹配；示例 URL 是占位地址，调用前须替换
ProjectName string
建议省略或使用默认项目；后续查询示例使用默认项目，不承诺其他项目的完整查询链路
默认值: default
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 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;将解析得到的 Result.Id 传给查询素材的 Id。本任务完成表示素材已创建，不代表审核完成或素材可用
完整流程
平台 task_id 用于任务查询，组的 Result.Id 用作 GroupId，素材的 Result.Id 用作查询素材的 Id；三者不可互换
价格
当前该素材模型免费，成功响应中的 usage.cost 为 "0"。创建组、创建素材和查询素材三个模型均为免费；此免费设置不包含后续图片或视频生成费用
错误处理
任务失败时读取 error.code、error.message。检查参数、URL 可访问性及素材或组 ID；包装不保证返回底层接口的具体错误码。默认项目示例应始终使用同一套海外素材模型