Seedance创建H5认证会话API-真人素材库-AutoRouter

创建真人认证会话，返回 bytedToken 和手机端 H5 活体检测链接。

创建真人认证会话，返回 bytedToken 和 H5 链接。请让用户在手机上打开 h5Link 完成活体检测。可选传入 callbackUrl 走自定义回调；不传时，认证成功后用通过 bytedToken 查询素材组取得真人素材组 ID。

真人认证不能跳过，也不能通过白名单绕过。同一真人多次调用此接口，每次都会创建新的真人素材组。

Base URL

https://api.autorouter.top — Production

Authentication

BearerAuth: http (bearer) 使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

Endpoints

POST `/seedance/v1/real-person-auth/sessions`

创建H5认证会话

返回认证 Token、H5 链接和 Token 有效期。可选传入自定义回调地址 callbackUrl。

Request Body

Content-Type: application/json

Example:

{
  "callbackUrl": "https://example.com/auth/callback"
}

Properties:

Name	Type	Required	Description
`callbackUrl`	string	No	用户自定义回调地址。传入后按下方自定义回调流程处理

callbackUrlstring（可选）

用户自定义回调地址。

自定义回调流程：

使用创建H5认证会话（传用户自定义回调地址 callbackUrl），得到 bytedToken / h5Link / expiresIn
引导真人素材组创建者打开 h5Link，并在 expiresIn 有效期内完成活体检测。此时火山侧会自动创建好素材组。火山引擎回调用户自定义的 callbackUrl，并拼接参数：?bytedToken=&resultCode=10000&algorithmBaseRespCode=0&reqMeasureInfoValue=1&verify_type=real_time（resultCode=10000 表示认证成功，其他值为失败；callbackUrl 不要自带 query 参数，避免与火山拼接冲突）
自行判断 resultCode 为成功后，使用确认真人认证结果并获取素材组（传 bytedToken，需在 expiresIn 内完成）获取 groupId
[可选/后续] 使用通过 bytedToken 查询素材组（传 bytedToken）获取 groupId

Responses

200: 成功

Content-Type: application/json

请求示例

curl -X POST "https://api.autorouter.top/seedance/v1/real-person-auth/sessions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
  "callbackUrl": "https://example.com/auth/callback"
}'

响应示例

{
  "requestId": "20ad53e3-8e3c-4ddd-90b3-fc452e54f673",
  "state": "OK",
  "errorCode": null,
  "errorMessage": null,
  "body": {
    "bytedToken": "202608030954115CF1D0D1C821E6CA8510",
    "h5Link": "https://ark.volcengine.com/region:cn-beijing/mobile/livenees-face-ma...",
    "expiresIn": 120
  }
}

响应字段说明：

Name	Type	Description
`requestId`	string	请求 ID
`state`	string	调用状态。`OK` 表示成功，`ERROR` 表示失败
`errorCode`	string	异常码。成功时为空字符串或 `null`
`errorMessage`	string	异常消息。成功时为空字符串或 `null`
`body`	object	真人认证会话
`body.bytedToken`	string	认证 Token，用于查询认证结果和对应素材组
`body.h5Link`	string	H5 活体检测链接。请引导用户在手机端打开并完成认证
`body.expiresIn`	integer	Token 有效期，单位为秒

statestring

调用状态。OK 表示成功，ERROR 表示失败

OK：返回正常
ERROR：返回错误，请查看 errorCode 和 errorMessage

bodyobject

真人认证会话

bytedTokenstring

认证 Token，用于查询认证结果和对应素材组

h5Linkstring

H5 活体检测链接。请引导用户在手机端打开并完成认证

expiresIninteger

Token 有效期，单位为秒

错误处理

HTTP 状态码为 200 时，仍需检查响应体中的 state。

`state`	说明
`OK`	调用成功，业务数据在 `body`
`ERROR`	调用失败。`errorCode` 为异常码，`errorMessage` 为异常消息

成功时 errorCode 和 errorMessage 可能为空字符串或 null。

创建H5认证会话

callbackUrlstring（可选）

statestring

bodyobject

属性

目录