API 文档AI 模型接口视频Seedance素材

确认真人认证结果并获取素材组

自定义回调场景下,根据 bytedToken 确认认证结果,写入素材库并返回素材组 ID。

用于自定义回调场景。请先自行确认火山回调状态码为成功,再调用本接口。接口根据 bytedToken 向火山查询素材组 ID,写入素材库后返回 groupId。bytedToken 来自创建 H5 认证会话,且必须在有效期内。过期后需要重新创建会话。

真人认证不能跳过,也不能通过白名单绕过。

Base URL

  • https://api.autorouter.top — Production

Authentication

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

Endpoints

POST /seedance/v1/real-person-auth/verification-result

确认真人认证结果并获取素材组

根据 bytedToken 确认认证结果,写入素材库并返回素材组 groupId。

Request Body

Content-Type: application/json

Example:

{
  "bytedToken": "byted-token-xxx"
}

Properties:

NameTypeRequiredDescription
bytedTokenstringYes真人认证 Token,由创建 H5 认证会话接口返回

bytedTokenstring(必选)

真人认证 Token,由创建 H5 认证会话接口返回

需在有效期内。过期后请重新创建 H5 认证会话。

Responses

200: 成功

Content-Type: application/json

请求示例

curl -X POST "https://api.autorouter.top/seedance/v1/real-person-auth/verification-result" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
  "bytedToken": "byted-token-xxx"
}'

响应示例

{
  "requestId": "1803ae665a704fbd90d20b3d50085033",
  "state": "OK",
  "errorCode": "",
  "errorMessage": "",
  "body": {
    "groupId": "group-xxxx"
  }
}

响应字段说明:

NameTypeDescription
requestIdstring请求 ID
statestring调用状态。OK 表示成功,ERROR 表示失败
errorCodestring异常码。成功时为空字符串或 null
errorMessagestring异常消息。成功时为空字符串或 null
bodyobject认证结果
body.groupIdstring火山资产组 ID

statestring

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

  • OK:返回正常
  • ERROR:返回错误,请查看 errorCode 和 errorMessage

bodyobject

认证结果

groupIdstring

火山资产组 ID

错误处理

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

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

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

目录