tencent cloud

Video on Demand

動向とお知らせ
製品アップデート情報
製品紹介
製品概要
Product Features
製品の機能
製品の強み
ユースケース
ソリューション
購入ガイド
課金概要
課金方式
購入ガイドライン
請求書の照会
支払い更新の説明
支払い延滞の説明
返金説明
クイックスタート
コンソールガイド
コンソールの説明
サービスの概要
アプリケーション管理
メディア管理
リソースパック管理
License Management
プラクティスチュートリアル
メディアのアップロード
オンデマンドメディアファイルのインテリジェントコールド化方法
ビデオ処理
配信と再生
イベント通知の受信方法
オリジンサーバーのマイグレーションツール
Live Recording
カスタムオリジンサーバーback-to-originの方法
ライブストリーミングハイライトクリップを VOD に永続化するためのガイド
EdgeOne を使用して VOD コンテンツを配信する方法
開発ガイド
メディアアップロード
メディア加工処理
ビデオAI
イベント通知
ビデオ再生
メディアファイルのダウンロード
サブアプリケーションシステム
エラーコード
Player+ドキュメント
Overview
Basic Concepts
Features
Free Demo
Free Trial License
Purchase Guide
SDK Download
Licenses
Player Guide
Integration (UI Included)
Integration (No UI)
Advanced Features
API Documentation
Player Adapter
Player SDK Policy
よくあるご質問
モバイル端末再生に関するご質問
料金
ビデオのアップロード
ビデオの公開
ビデオの再生
Web側の再生
全画面表示再生
データ統計
CAM関連
メディア資産冷却に関する質問
Agreements
Service Level Agreement
VOD ポリシー
プライバシーポリシー
データ処理とセキュリティ契約
お問い合わせ
用語集
ドキュメントVideo on Demand

CreatePersonSample

フォーカスモード
フォントサイズ
最終更新日: 2025-10-30 22:08:01

1. API Description

Domain name for API request: vod.intl.tencentcloudapi.com.

This API is used to create samples for using facial features positioning and other technologies to perform video processing operations such as content recognition and inappropriate information recognition.

A maximum of 100 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: CreatePersonSample.
Version Yes String Common Params. The value used for this API: 2018-07-17.
Region No String Common Params. This parameter is not required.
Name Yes String Name of a sample. Length limit: 20 characters.
Usages.N Yes Array of String Usage of a sample. Valid values:
1. Recognition: used for content recognition; equivalent to Recognition.Face
2. Review: used for inappropriate information recognition; equivalent to Review.Face
3. All: equivalent to 1+2.
SubAppId No Integer The VOD application ID. For customers who activate VOD service from December 25, 2023, if they want to access resources in a VOD application (whether it's the default application or a newly created one), they must fill in this field with the application ID.
Description No String Description of a sample. Length limit: 1024 characters.
FaceContents.N No Array of String String generated after the sample image is encoded by Base64. Only JPEG and PNG images are supported. Array length limit: 5 images.
Note: the image must be a relatively clear full-face photo of a person and has a resolution of no less than 200 x 200.
Tags.N No Array of String Tags of a sample
  • Array length limit: 20 tags
  • Length limit of a tag: 128 characters
  • 3. Output Parameters

    Parameter Name Type Description
    Person AiSamplePerson Information of a sample.
    FailFaceInfoSet Array of AiSampleFailFaceInfo Information of samples that failed the verification by facial feature positioning.
    RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

    4. Example

    Example1 Creating an image sample

    Input Example

    https://vod.intl.tencentcloudapi.com/?Action=CreatePersonSample
    &Name=John Smith
    &Tags.0=US
    &Tags.1=Celebrity
    &Description=American actor, director, and producer
    &Usages.0=Recognition.Face
    &Usages.1=Review.Face
    &FaceContents.0=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
    &FaceContents.1=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
    &<Common request parameters>

    Output Example

    {
        "Response": {
            "Person": {
                "PersonId": "10703",
                "Name": "John Smith",
                "Description": "American actor, director, and producer",
                "FaceInfoSet": [
                    {
                        "FaceId": "10109",
                        "Url": "http://1251659802.vod2.myqcloud.com/vodcq1251659802/ai_samples/251006362/faces/15517827183907093125.jpeg"
                    }
                ],
                "TagSet": [
                    "US",
                    "Celebrity"
                ],
                "UsageSet": [
                    "Recognition.Face",
                    "Review.Face"
                ],
                "CreateTime": "2019-01-16T11:34:46Z",
                "UpdateTime": "2019-01-16T11:34:46Z"
            },
            "FailFaceInfoSet": [
                {
                    "Index": 1,
                    "ErrCode": 18004,
                    "Message": "face picture format error"
                }
            ],
            "RequestId": "2e63f898-cafd-4840-a17d-b8db9f02a9d6"
        }
    }

    5. Developer Resources

    SDK

    TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

    Command Line Interface

    6. Error Code

    The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

    Error Code Description
    InternalError Internal error.
    InvalidParameterValue Incorrect parameter value.
    InvalidParameterValue.FaceDuplicate Incorrect parameter value: the same face already exists.
    InvalidParameterValue.PicFormatError Incorrect parameter value: the face image format is incorrect.
    UnauthorizedOperation Unauthorized operation.

    ヘルプとサポート

    この記事はお役に立ちましたか?

    フィードバック