素材审核系统
素材审核系统用于将图片、视频或音频素材提交审核，审核通过后返回可用于视频生成的Asset:// 地址或下游素材 ID。
Base URL
https://identity.xmsmartlink.com
请求头
| Header | 必填 | 说明 |
|---|---|---|
X-Access-Token | 是 | 访问令牌，由管理员分配。 |
X-Track-Id | 是 | 请求跟踪 ID，建议每次请求唯一，32 位无横杠十六进制字符串。 |
Content-Type | 是 | application/json。 |
接口列表
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/asset/upload/sync | 同步提交审核，等待审核结果后返回。 |
| POST | /api/asset/upload/async | 异步提交审核，立即返回任务 ID。 |
| GET | /api/task/{task_id} | 查询任务结果。 |
提交参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
images | string[] | 是 | 素材 URL 列表，最多 50 条，只支持公网 http/https。 |
asset_url_list | string[] | 否 | 兼容旧调用方；与 images 等价，同时传入时优先使用该字段。 |
asset_type | string | 否 | 默认 Image，可选 Image、Video、Audio。 |
callback_url | string | 否 | 接收审核结果的回调地址，必须公网可访问。 |
group_id | string | 否 | 素材组 ID；真人素材上传时传入真人素材组 ID。 |
group_source | string | 否 | 素材组来源。传入 group_id 时只能为空或 real_person。 |
结果字段
| 字段 | 说明 |
|---|---|
asset_id | 系统生成的素材 ID。 |
source_url | 提交的原始 URL。 |
asset_url | Asset:// 协议地址，可直接用于视频生成。 |
downstream_asset_id | 下游素材 ID。 |
downstream_final_url | 下游带签名访问地址，通常有有效期。 |
submit_review_status | 1 表示审核通过，0 表示未通过或失败。 |
error_code | 审核失败错误码。 |
error_message | 审核失败错误描述。 |
素材限制
同一批次所有 URL 必须为同一类型，Image、Video、Audio 不允许混合提交。系统通过 URL 扩展名自动推断素材类型，URL 必须带有受支持扩展名。
| 类型 | 支持扩展名 |
|---|---|
| Image | .jpeg、.jpg、.png、.webp、.bmp、.tiff、.tif、.gif、.heic、.heif |
| Video | .mp4、.mov |
| Audio | .wav、.mp3 |