查询真人认证结果
POST
/xmind-cloud-platform/openapi/volcengine?Action=GetVisualValidateResult&Version=2024-01-01用临时令牌查询真人认证结果,认证完成后返回真人分组 ID。
请求参数
Action 与 Version 通过查询参数传递,其余参数放在 JSON 请求体中。
CreateVisualValidateSession 返回的临时令牌。
默认值:-认证未完成不报错
认证未完成时 GroupId 与 Id 为 null,接口不报错。建议每 5 秒轮询一次,最长 30 分钟。
认证未完成时的响应:
{
"GroupId": null,
"Id": null,
"AuthorizedAt": null,
"ModelIds": ["Doubao-Seedance-2.5"]
}
认证
所有接口使用同一套火山 V4 签名,凭证与签名方式见火山方舟素材库 API 概览。以下请求头为通用要求:
固定为 application/json。
默认值:application/json实际访问的域名和端口;包含端口时必须写入签名。
默认值:-UTC 时间,格式 yyyyMMdd'T'HHmmss'Z',例如 20261022T131900Z;与平台时间偏差不能超过 300 秒。
默认值:-原始请求体的 SHA-256 小写十六进制。
默认值:-火山 V4 HMAC-SHA256 签名。
默认值:-响应
真人分组 ID,认证完成前为 null。
默认值:-与 GroupId 相同,认证完成前为 null。
默认值:-认证完成时间(ISO-8601)。
默认值:-该分组适用的模型列表。
默认值:-拿到 GroupId 后即可上传真人素材:调用上传素材时把 GroupId 传为该值。认证未完成时 GroupId 为空,此时上传会返回 400 InvalidRequest(真人素材组不存在或无权访问)。
错误
| Code | 说明 |
|---|---|
400 | InvalidParameter:未传 BytedToken |
400 | InvalidRequest:会话不存在、已过期(30 分钟)或不属于当前客户 |
401 | SignatureDoesNotMatch、InvalidTimestamp、XContentSha256Mismatch、MissingParameter.Authorization 等签名或时间相关错误 |
403 | AccessDenied 凭证被禁用或无权限;ExpiredToken 凭证已过期 |
429 | TooManyRequests 请求过于频繁 |