跳到主要内容

查询真人认证结果

POST/xmind-cloud-platform/openapi/volcengine?Action=GetVisualValidateResult&Version=2024-01-01

用临时令牌查询真人认证结果,认证完成后返回真人分组 ID。

请求参数​

Action 与 Version 通过查询参数传递,其余参数放在 JSON 请求体中。

BytedTokenstring必填

CreateVisualValidateSession 返回的临时令牌。

默认值:-
认证未完成不报错

认证未完成时 GroupId 与 Id 为 null,接口不报错。建议每 5 秒轮询一次,最长 30 分钟。

认证未完成时的响应:

{
"GroupId": null,
"Id": null,
"AuthorizedAt": null,
"ModelIds": ["Doubao-Seedance-2.5"]
}

认证​

所有接口使用同一套火山 V4 签名,凭证与签名方式见火山方舟素材库 API 概览。以下请求头为通用要求:

Content-Typestring必填

固定为 application/json。

默认值:application/json
Hoststring必填

实际访问的域名和端口;包含端口时必须写入签名。

默认值:-
X-Datestring必填

UTC 时间,格式 yyyyMMdd'T'HHmmss'Z',例如 20261022T131900Z;与平台时间偏差不能超过 300 秒。

默认值:-
X-Content-Sha256string必填

原始请求体的 SHA-256 小写十六进制。

默认值:-
Authorizationstring必填

火山 V4 HMAC-SHA256 签名。

默认值:-

响应​

Result.GroupIdstring可选

真人分组 ID,认证完成前为 null。

默认值:-
Result.Idstring可选

与 GroupId 相同,认证完成前为 null。

默认值:-
Result.AuthorizedAtstring可选

认证完成时间(ISO-8601)。

默认值:-
Result.ModelIdsarray<string>可选

该分组适用的模型列表。

默认值:-

拿到 GroupId 后即可上传真人素材:调用上传素材时把 GroupId 传为该值。认证未完成时 GroupId 为空,此时上传会返回 400 InvalidRequest(真人素材组不存在或无权访问)。

错误​

Code说明
400InvalidParameter:未传 BytedToken
400InvalidRequest:会话不存在、已过期(30 分钟)或不属于当前客户
401SignatureDoesNotMatch、InvalidTimestamp、XContentSha256Mismatch、MissingParameter.Authorization 等签名或时间相关错误
403AccessDenied 凭证被禁用或无权限;ExpiredToken 凭证已过期
429TooManyRequests 请求过于频繁

相关​