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

通过 bytedToken 查询素材组

用真人认证 Token 查询对应的素材组 ID。

用真人认证 Token 查询对应的素材组 ID。bytedToken 来自创建 H5 认证会话,且必须是当前用户持有的有效 Token。无效或非本人 Token 会返回素材组不存在或 Token 无效。

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

Base URL

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

Authentication

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

Endpoints

POST /seedance/v1/real-person-auth/asset-group/by-byted-token

通过 bytedToken 查询素材组

返回该 Token 对应的素材组 groupId。

Request Body

Content-Type: application/json

Example:

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

Properties:

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

bytedTokenstring(必选)

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

Token 必须属于当前用户且仍然有效。无效 Token 会返回素材组不存在或 Token 无效。

Responses

200: 成功

Content-Type: application/json

请求示例

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

响应示例

{
  "requestId": "e86bc17b-3791-412b-aec6-9bfabee2331b",
  "state": "OK",
  "errorCode": null,
  "errorMessage": null,
  "body": "group-20260803095638-hzqjg"
}

响应字段说明:

NameTypeDescription
requestIdstring请求 ID
statestring调用状态。OK 表示成功,ERROR 表示失败
errorCodestring异常码。成功时为空字符串或 null
errorMessagestring异常消息。成功时为空字符串或 null
bodystring素材组 ID(groupId)

statestring

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

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

bodystring

素材组 ID(groupId)

错误处理

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

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

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

目录