ビデオと素材
Get Visual Validation Result
ビジュアルバリデーションによって生成された実在人物のマテリアルグループを取得します。
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/jsonCreate 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のレスポンスエンベロープとは異なります。
| ステータス | コード | 原因 |
|---|---|---|
400 | InvalidParameter | BytedToken が無効または期限切れ、ProjectName が一致しない、または検証がまだ完了していない(再試行してください) |
400 | InvalidVersion | Version が 2024-01-01 ではありません |
405 | MethodNotAllowed | このActionはPOSTのみを受け付けます |
409 | Conflict | 検証済みグループが既に別の組織にマッピングされています |
503 | ServiceUnavailable | 実在人物検証が利用できないか、リクエストが失敗しました。後で再試行してください |
curl -X POST "https://example.com/api/v3" \ -H "Content-Type: application/json" \ -d '{ "CallbackURL": "http://example.com" }'{ "id": "string"}認証
BearerAuth APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
クエリパラメータ
指定できる値
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"ヘッダー
リクエストごとの配信ポリシー。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