真人素材授权
真人素材需要先完成真人认证授权，再使用授权生成的group_id 上传素材。上传真人素材复用素材审核系统的上传接口，只需额外传入 group_id。
Base URL
https://identity.xmsmartlink.com
流程
- 调用授权链接接口，提交艺人名称和描述。
- 系统返回真人认证 H5 链接。
- 授权方在 120 秒内打开 H5 链接并完成人脸认证。
- 认证成功后系统创建并绑定真人素材组。
- 调用真人素材组列表接口，获取可用
group_id。 - 上传真人素材时，在素材审核上传接口中传入
group_id。
接口列表
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/real-person/auth/link | 获取真人认证 H5 链接。 |
| GET | /api/real-person/groups | 查询我的真人素材组。 |
| POST | /api/asset/upload/sync | 上传真人素材，同步审核。 |
| POST | /api/asset/upload/async | 上传真人素材，异步审核。 |
获取真人认证 H5 链接参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
artist_name | string | 是 | 艺人授权组名称，最多 32 个字符，不可重复。 |
artist_desc | string | 否 | 艺人授权组描述，最多 300 个字符。 |
真人素材上传参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
images | string[] | 是 | 素材 URL 列表，最多 50 条，只支持公网 http/https。 |
asset_type | string | 否 | 默认 Image，可选 Image、Video、Audio。 |
group_id | string | 是 | 真人素材组 ID，必须属于当前访问令牌对应用户。 |
callback_url | string | 否 | 异步结果回调地址。 |
注意事项
- 每个艺人授权会创建一个独立真人素材组。
group_id必须属于当前访问令牌对应用户。- 同一个真人素材组只应上传同一真人的素材。
- H5 真人认证链接有效期为 120 秒，超时或使用后需要重新获取。
- 真人素材上传时会做人脸一致性校验，如果上传素材与授权认证人脸不一致，会返回失败。