创建真人认证会话

状态

本文记录已接入的 Modelflare 素材管理接口。调用需要有效的媒体 API Key、可用媒体渠道和对应权限。

接口

POST https://modelflare.dev/volc/asset/CreateVisualValidateSession

鉴权

使用 Modelflare API Key：

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

创建、更新和删除请求建议携带 Idempotency-Key。同一用户使用相同 Key 重试时，网关会重放已保存响应，不重复创建或删除。

请求

创建移动端真人活体认证会话。用户打开返回的 H5Link 完成认证。

字段	类型	必填	说明	示例
`CallbackURL`	`string`	否	可选回调地址，用于接收认证事件。	`https://example.com/callback`

JSON 示例：

{
  "CallbackURL": "https://example.com/callback"
}

cURL 示例：

curl --request POST https://modelflare.dev/volc/asset/CreateVisualValidateSession \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "CallbackURL": "https://example.com/callback"
}'

响应

认证会话创建成功。

字段	类型	必填	说明	示例
`BytedToken`	`string`	是	临时认证凭证，用于调用 `GetVisualValidateResult`。	`2026070222152680501D985EA34A3BE3D8`
`CallbackURL`	`string`	否	请求中传入的回调地址。	`https://example.com/callback`
`H5Link`	`string`	是	移动端真人活体认证页面链接。	`https://example.com/liveness-session`

响应示例：

{
  "BytedToken": "2026070222152680501D985EA34A3BE3D8",
  "CallbackURL": "https://example.com/callback",
  "H5Link": "https://example.com/liveness-session"
}

错误

状态码	含义
`400`	请求参数无效。
`401`	API Key 缺失或未授权。

错误体示例（接口返回时）：

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

创建图片、视频和音频是异步的：收到素材 ID 后，先调用 GetAsset，只有 Active 状态才能把它放进 Seedance 的 asset://<ID> 引用。