创建真人 H5 验证会话

POST

/v1/seedance_assets/

完整请求 URI：

POST /v1/seedance_assets/?Action=CreateVisualValidateSession&Version=2024-01-01

在指定素材空间创建真人 H5 验证会话。返回 H5Link 后由最终用户在浏览器完成验证。

CompletionMode=Callback 时 CallbackURL 必填；ManualPolling 时可省略。
RequiresGroupNameInput=true 表示用户还须在验证页面提交真人素材组名称。
本接口成功响应为顶层结果对象，不包含 ResponseMetadata 包装。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

Body 参数application/json必填

示例

回调型 Driver手动轮询型 Driver

{
    "AssetSpaceId": "real-person-production",
    "CallbackURL": "https://client.example.com/seedance/validated",
    "ProjectName": "default"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

回调型 Driver手动轮询型 Driver

curl --location '/v1/seedance_assets/?Action=CreateVisualValidateSession&Version=2024-01-01' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "AssetSpaceId": "real-person-production",
    "CallbackURL": "https://client.example.com/seedance/validated",
    "ProjectName": "default"
}'

返回响应

🟢200

application/json

创建成功，返回验证凭证和 H5 地址。

Bodyapplication/json

示例

回调型 Driver手动轮询型 Driver

{
    "BytedToken": "byted-token-from-create-response",
    "H5Link": "https://verification.example.com/session/xxx",
    "CallbackURL": "https://client.example.com/seedance/validated",
    "CompletionMode": "Callback",
    "RequiresGroupNameInput": false
}

🟠400AssetBadRequest

🟠401TokenAuthError

🟠403AssetError

🟠429UpstreamRateLimit

🔴500AssetError

🔴502EmbeddedBusinessError

🔴503AssetError

修改于 2026-08-10 08:43:01

释放空素材空间

查询真人验证结果