真人认证

含真人人像的素材需要先完成活体认证，再上传到认证返回的 LivenessFace 素材组，之后才能用 asset:// 引用。

1. 创建认证会话

curl -X POST 'https://ai.tuiwo.vip/ai?Action=CreateVisualValidateSession&Version=2024-01-01' \
  -H 'Authorization: Bearer $TUIWO_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"CallbackURL":"https://example.com/done"}'

响应 Result：

H5Link 由平台提供，请按敏感链接处理，不要公开传播。

2. 被认证人完成活体

真人本人用手机打开 H5Link，通常需要在约 15 分钟内完成活体认证。

3. 轮询认证结果

curl -X POST 'https://ai.tuiwo.vip/ai?Action=GetVisualValidateResult&Version=2024-01-01' \
  -H 'Authorization: Bearer $TUIWO_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"BytedToken":"BYTED_TOKEN"}'

建议每 3–5 秒查询一次，直到 Result.GroupId 非空。

• 认证未完成时 GroupId 为空字符串。
• 认证失败返回 VisualValidateFailed。
• 会话过期返回 VisualValidateSessionExpired。

失败或过期后需要重新创建会话。

4. 上传真人素材

使用 CreateAsset 把与认证本人一致的图片或视频上传到 Result.GroupId，等待 Active 后用 asset:// 引用。

共享工作空间限制

• 真人认证组会计入素材组额度，并出现在 ListAssetGroups 中，GroupType = LivenessFace。
• 当前接口使用共享工作空间：同一授权分组内的客户可以看到并引用彼此创建的素材组，包括真人认证组。
• 只与可信客户共享同一分组，并确保已取得真人素材的合法授权。
• 删除真人认证私有组时，通常需要组已过期或认证已被拒绝。

相关 Action

• CreateVisualValidateSession
• GetVisualValidateResult

CreateRealValidateH5 在当前代理 allowlist 中存在，但服务端未公开该 Action；确认前不要依赖。