ビデオと素材

Get Visual Validation Result

ビジュアルバリデーションによって生成された実在人物のマテリアルグループを取得します。

POST
/api/v3

H5ビジュアルバリデーションフローの後にこのActionをポーリングします。成功すると、検証済み人物のTokenLabマテリアルグループIDが返されます。

セッションを作成した際と同じ認証済み組織、ユーザー、および大文字小文字を区別する ProjectName を使用してください。

エンドポイントと認証

POST https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/json

Create Visual Validation Session によって返された BytedToken を送信します。作成時に ProjectName を設定した場合は、ここでも同じ大文字小文字を区別する値を送信してください。設定していない場合は省略するか、default を使用してください。

ブラウザのコールバック直後には結果の準備ができていない場合があります。Result.GroupId が返されるか、30分間の BytedToken の有効期限が切れるまで、同じリクエストを再試行してください。成功したリクエストを同じトークンで繰り返すと、同じマッピング済みの GroupId が返されます。

返された GroupId は、liveness_face マテリアルアセットを作成する際の group_id として使用してください。

リクエスト例

curl 'https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"BytedToken":"ZXhhbXBsZS10b2tlbg","ProjectName":"default"}'

レスポンス例

{
  "ResponseMetadata": {
    "RequestId": "req_def456",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "GroupId": "group-20260720123456-real1"
  }
}

エラーは ResponseMetadata.Error.Code および ResponseMetadata.Error.Message を使用します。成功時のレスポンスには ResponseMetadata と Result が含まれます。これはTokenLabの他の /v1 APIのレスポンスエンベロープとは異なります。

ステータスコード原因
400InvalidParameterBytedToken が無効または期限切れ、ProjectName が一致しない、または検証がまだ完了していない(再試行してください)
400InvalidVersionVersion が 2024-01-01 ではありません
405MethodNotAllowedこのActionはPOSTのみを受け付けます
409Conflict検証済みグループが既に別の組織にマッピングされています
503ServiceUnavailable実在人物検証が利用できないか、リクエストが失敗しました。後で再試行してください
curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'
{  "id": "string"}

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

クエリパラメータ

Action?string

指定できる値

  • "CreateContentsGenerationsTasks"
  • "GetContentsGenerationsTask"
  • "ListContentsGenerationsTasks"
  • "DeleteContentsGenerationsTasks"
  • "CreateVisualValidateSession"
  • "GetVisualValidateResult"
  • "CreateAssetGroup"
  • "ListAssetGroups"
  • "GetAssetGroup"
  • "UpdateAssetGroup"
  • "DeleteAssetGroup"
  • "CreateAsset"
  • "ListAssets"
  • "GetAsset"
  • "UpdateAsset"
  • "DeleteAsset"
Version?string
デフォルト"2024-01-01"

ヘッダー

X-TokenLab-Delivery-Policy?string

リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。自動的にまず TokenLab Verified を試行し、出力、リクエストの受け入れ、または永続的なリソース作成の前に、一度だけ Official に切り替える場合があります。

指定できる値

  • "auto"
  • "verified"
  • "official"

リクエストボディ

application/json

レスポンス

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json