AIaitoearn
AI 服务/真人认证

创建真人认证会话

Changed on

创建真人活体认证会话。请求体只有 callbackUrl，不要传虚拟人像的 name、description 或 avatarType。认证完成后，AiToEarn 会把浏览器重定向到 callbackUrl，并附带认证结果参数。创建和完成同一会话必须使用同一个 API Key。

post/api/ai/volcengine/assets/visual-validation-sessions

Request

Request body

callbackUrlstring uri required

认证完成后跳转的 HTTP(S) 地址。

Response

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

codeinteger required

业务状态码。0 表示成功，非 0 表示业务错误。

messagestring required

响应消息。

requestIdstring

请求 ID。

timestampinteger

错误响应时间戳，Unix 毫秒。

Example response

{
  "data": {
    "bytedToken": "20260902170610426DEDD5F07EEF7EF075",
    "h5Link": "https://ark.volcengine.com/region:cn-beijing/mobile/liveness-face-manage/authorization",
    "shortLink": "https://aitoearn.cn/s/example",
    "callbackUrl": "https://example.com/real-person/callback"
  }
}

Changes