触发真人认证回查（仅 liveness_face）

真人组刷脸完成后，触发平台凭认证凭证向供应商换取认证结果（resolve），把分组从 awaiting_auth 推进到 active/failed。

调用时机（重要）：

必须在分组状态为 awaiting_auth 时调用（即 GET 已返回 h5_link）；分组仍 pending（建会话未完成）时调用返回 409。

⚠️ 务必在刷脸成功后才调用，且只调一次：刷脸成功（resultCode==10000）时，平台会用一次性凭证（byted_token）验证分组，该凭证查询一次即失效。请在浏览器跳回 callback_url 携带的 resultCode==10000 后再调。若 result_code 非 10000：本接口仍受理并返回 202，平台异步将该组判为 failed，不会消耗一次性凭证（不调用供应商换取接口）——但请勿在刷脸成功前用伪造的 10000 调用，否则会触发查询、白白烧掉凭证导致该组只能重建。

异步：本接口仅受理并返回 202，无论成功/失败的最终结果都需轮询 GET /v1/asset-groups/{qgroupid} 看 active/failed（非 10000 也会异步落 failed，而非本接口同步返回失败）。

幂等：分组已是 active/failed 终态时再调，直接返回 200 + 当前分组信息（不再触发回查）。

权限：只能操作当前用户自己的分组（qgroupid 须形如 qgroup-{uid}-*，否则 403）。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

curl --location 'https://api.qnaigc.com/v1/asset-groups//visual-validate-result' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "result_code": "10000", "byted_token": "20260612101859D18B5635A448320E5032" }'

{ "qgroupid": "qgroup-xxx-1781230723000204313", "type": "liveness_face", "name": "我的真人人像分组", "description": "用于存放公司形象真人人像素材", "model": "bytedance/doubao-seedance-2-0-260128", "status": "active", "is_default": false, "created_at": 1781230723, "updated_at": 1781230860 }

请求参数

返回响应