素材审核系统

素材审核系统用于将图片、视频或音频素材提交审核，审核通过后返回可用于视频生成的 Asset:// 地址或下游素材 ID。

需要将审核通过的素材用于视频生成时，请查看审核素材用于 Seedance-2。

适用场景

少量素材且调用方可以等待结果时使用同步接口；批量素材、耗时审核或需要回调时使用异步接口，提交后立即获得任务 ID。

Base URL

https://identity.xmsmartlink.com

请求头

X-Access-Token 与 X-Track-Id 必须同时提供，不能二选一。X-Track-Id 建议为每次请求生成新的值。

Header	必填	说明
`X-Access-Token`	是	访问令牌，由管理员分配。
`X-Track-Id`	是	请求跟踪 ID，建议每次请求唯一，32 位无横杠十六进制字符串。
`Content-Type`	是	POST 请求使用 `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`。

结果字段

任务查询结果位于 result.items[]，不要从响应顶层读取素材地址。

字段	说明
`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`

异步提交示例

仅在请求中配置了 callback_url 时等待回调；未配置时直接按查询接口获取状态。

bash

curl -X POST 'https://identity.xmsmartlink.com/api/asset/upload/async' \
  -H 'Content-Type: application/json' \
  -H 'X-Access-Token: YOUR_ACCESS_TOKEN' \
  -H 'X-Track-Id: $TRACK_ID_SUBMIT' \
  -d '{
    "images": ["https://example.com/reference.jpg"],
    "asset_type": "Image",
    "callback_url": "https://your-service.example.com/callback"
  }'

202 Accepted 响应示例：

json

{
  "code": 202,
  "task_id": "audit-task-example",
  "track_id": "0123456789abcdef0123456789abcdef",
  "status": "pending",
  "message": "accepted",
  "callback_url": "https://your-service.example.com/callback"
}

查询示例

查询请求使用新的跟踪 ID，并继续同时提供两个审核请求头。

bash

curl -X GET 'https://identity.xmsmartlink.com/api/task/audit-task-example' \
  -H 'X-Access-Token: YOUR_ACCESS_TOKEN' \
  -H 'X-Track-Id: $TRACK_ID_QUERY'

完成响应中的素材结果位于 result.items[]：

json

{
  "code": 200,
  "task_id": "audit-task-example",
  "status": "completed",
  "total_count": 1,
  "done_count": 1,
  "result": {
    "review_batch_id": "review-batch-example",
    "items": [
      {
        "asset_id": "asset-example",
        "source_url": "https://example.com/reference.jpg",
        "asset_url": "Asset://asset-example",
        "downstream_final_url": "https://example.com/signed-reference.jpg",
        "submit_review_status": 1
      }
    ]
  }
}

只有 status 为 completed 且素材的 submit_review_status 为 1 时，才把对应 asset_url 交给后续生成接口。

状态与重试

202 Accepted 只表示任务已受理，不表示审核完成。
processing 表示仍在处理；completed 和 failed 是终态。若服务返回 cancelled，也应视为终态并停止查询，不能默认重新提交。
仅当创建请求配置了 callback_url 时优先等待回调；回调缺失时使用查询接口兜底。
查询网络失败时可按 1 秒、2 秒、4 秒退避；接口返回 Retry-After 时必须优先遵守，并且重试间隔不得低于接口页面规定的最低查询间隔。
创建请求超时后不要直接重复提交；先从已有响应、回调或业务记录确认是否已获得 task_id，避免重复任务。
通用轮询、回调和幂等规则请查看异步任务指南。

API Reference

底层接口定义已收录在左侧“底层 API Reference / 素材审核”分组中，包括同步提交、异步提交和任务查询。

素材审核系统 ​

适用场景 ​

Base URL ​

请求头 ​

接口列表 ​

提交参数 ​

结果字段 ​

素材限制 ​

异步提交示例 ​

查询示例 ​

状态与重试 ​

API Reference ​