新版真人认证

真人素材可通过 H5 页面完成认证。认证会话和素材组均属于新版素材库，不可与旧版 ID 混用。

1. 创建认证会话

POST /v1/seedance/v2/visual-validate/session
Authorization: Bearer <API_KEY>

响应示例：

{
  "h5_link": "https://example.com/verify?...",
  "expires_in": 1800,
  "byted_token": "token_xxx"
}

将 h5_link 交给本人在浏览器中完成认证。h5_link 和 byted_token 均属于敏感凭据，不要写入公开日志、错误追踪或前端埋点；只应由本人授权后使用，并在会话过期后从业务缓存中删除。

2. 查询认证结果

POST /v1/seedance/v2/visual-validate/result
Authorization: Bearer <API_KEY>
Content-Type: application/json

{
  "byted_token": "token_xxx"
}

认证成功后返回素材组 ID：

{
  "group_id": "group_xxx"
}

随后可通过素材库接口查询该素材组及素材状态；只有 ACTIVE 素材可以用于生成。

轮询与失败处理

• 建议每 3～5 秒查询一次，并在 expires_in 时间内停止轮询。
• 非成功响应统一按 HTTP 状态码和 error 对象处理。
• 会话过期后重新创建会话，不要重复使用旧 byted_token。
• 查询成功返回的 group_id 就是新版素材组 ID，可继续调用 /asset-groups/{group_id} 和素材列表接口。
• 平台不代替业务方制定人脸数据的保存期限；业务方应依据本人授权和适用法律控制访问、审计和删除。

旧版真人认证流程和接口仍保留，详见旧版真人认证。