本人確認結果を取得

セッション Token を使用して実在人物の素材グループ ID を取得します。

本人確認セッションの作成時に返された BytedToken を使用して、実在人物の素材グループ ID を取得します。Result.GroupId が空の場合は取得がまだ完了していません。Token が無効または期限切れの場合は、新しい本人確認セッションを作成してください。

実在人物の素材グループを作成した後、Platform の更新 API を使用して名前と説明を追加できます。以降にアップロードする素材は、認証済みの顔と一致する必要があります。

POST/v1/assets/doubao/

BytedToken を使用して認証結果を取得します。Result.GroupId が空の場合は取得がまだ完了していません。

認証

bearerAuth

認証Bearer <token>

指定位置: header

クエリパラメーター

Action*"GetVisualValidateResult"

常に GetVisualValidateResult です。

デフォルト値"GetVisualValidateResult"

指定可能な値

"GetVisualValidateResult"

Version*"2024-01-01"

API バージョンです。常に 2024-01-01 です。

デフォルト値"2024-01-01"

指定可能な値

"2024-01-01"

リクエストボディ

application/json

TypeScript 型定義

TypeScript で request body 型を使用します。

BytedToken*string

本人確認セッションの作成時に返された Token です。

ProjectName?string

Platform が一元管理します。指定した値は業務上の分離には使用されません。

レスポンスボディ

`application/json`

curl -X POST "https://example.com/v1/assets/doubao/?Action=GetVisualValidateResult&Version=2024-01-01" \  -H "Content-Type: application/json" \  -d '{    "BytedToken": "202608071652256191D5DA0C813A641759"  }'

{
  "ResponseMetadata": {
    "RequestId": "20260807165320CFJCJ",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "xx-xxxxxx"
  },
  "Result": {
    "GroupId": "group-20260807165320-cfjcj"
  }
}

認証

クエリパラメーター

リクエストボディ

レスポンスボディ

200application/json

400

401

404

503

5XX

`application/json`