Content Moderation:顔属性検出 2.0

1. 機能説明

顔属性検出の2.0は、画像内のさまざまな顔の特徴（ぼかし、角度、位置、笑顔の強度、眼鏡、マスク、帽子、口ひげ、前髪、さまざまな髪型の有無など）を分析できます。プロフェッショナル版では、さらに誇張された表情や目が閉じているかどうかを認識します。

2. 課金説明

画像顔属性検出2.0では、従量課金を含む課金方法を提供しています。

従量課金

Content Moderation2.0 サービスを有効化すると、デフォルトの課金オプションは従量課金になります。料金は実際の使用量に基づいて毎日決済され、サービスを使用しない場合は課金されません。

3. アクセスガイド

1. Alibaba Cloud アカウントを作成します。[今すぐ登録]して、プロンプトに従って登録を完了します。

2. 従量課金制 Content Moderation を有効化する: サービスを有効化していることを確認します。有効化は無料であり、課金は使用量に基づいて行われます。詳細については、「課金説明」をご参照ください。

3. AccessKey を作成します。RAM 経由で AccessKey を作成します [AccessKey の作成]。サブアカウント AccessKey を使用する場合は、メインアカウントから AliyunYundunGreenWebFullAccess 権限を付与します。手順については、「[RAM 承認]」をご参照ください。

4. 開発アクセス：SDK メソッドでの呼び出しをお勧めします。詳細は、「画像モデレーション 強化版 2.0 SDK およびアクセスガイド」をご参照ください。

4. API インターフェイス

使用方法

画像コンテンツ検出タスクを作成するには、このインターフェイスを呼び出します。HTTP リクエストの作成については、「アクセスガイド」をご参照ください。または、事前に作成された HTTP リクエストを使用します。詳細については、「SDK リファレンス」をご参照ください。

• ビジネスインターフェイス：ImageModeration

• サポートされているリージョンとアクセスアドレス：

• 課金情報：

  このインターフェイスは有料です。HTTP ステータスコード 200 のリクエストのみが課金されます。エラーコードは課金されません。課金オプションについては、「課金説明」をご参照ください。

• 画像要件：

  • サポートされている形式は、PNG、JPG、JPEG、BMP、WEBP、TIFF、SVG、HEIC (最長辺は 8192 px 未満である必要があります)、GIF (最初のフレーム)、ICO (最後の画像) です。

  • 画像サイズは 20 MB に制限されており、最大高または幅は 16,384 px、ピクセル総数は 1 億 6,700 万 px を超えません。効果的なモデレーションのために、画像は 200 × 200 px 以上の解像度であることをお勧めします。

  • 画像のダウンロード時間は 3 秒に制限されています。これを超えると、ダウンロードがタイムアウトになります。

QPS 制限

シングルユーザーの QPS 制限は、10 回/秒 (プロフェッショナル版：5 回/秒) です。この制限を超えると、API 呼び出しがスロットルされ、サービスに影響を与える可能性があります。責任を持って呼び出してください。大量または緊急のスケールアウトのために、より高い QPS が必要な場合は、ビジネス マネージャーにお問い合わせください。

デバッグ

アクセスする前に、Alibaba Cloud OpenAPI を介してオンラインでデバッグし、2.0 インターフェースのコード例と SDK の依存関係を確認し、インターフェースの使用方法とパラメーターについて理解しておいてください。

リクエストパラメーター

必須のパブリックリクエストパラメーターについては、

必須のパブリックリクエストパラメーターについては、「画像モデレーション 強化版 2.0 SDK およびアクセスガイド」をご参照ください。

リクエスト本文は、次のフィールドを持つ JSON 構造体です。

表 1. ServiceParameters

戻りデータ

表 2. Data

表 3. Ext

表 4. FaceData

表 5.Location

表 6.Quality

表 7.Mask

表 8.Hat

表 9.Mustache

表 10.Bang

表 11.Hairstyle

表 12.Gender

表 13. Result

例

リクエスト例

{
    "Service": "faceDetect_global",
    "ServiceParameters": {
        "imageUrl": "https://img.alicdn.com/tfs/TB1U4r9AeH2gK0jSZJnXXaT1FXa-2880-480.png",
        "dataId": "test0307****"
    }
}

レスポンス例

• 顔属性検出レスポンス例：

{
    "Code": 200,
    "Data": {
        "DataId": "test0307****",
        "Ext": {
            "FaceData": [
                {
                    "Age": 24,
                    "Bang": {
                        "Confidence": 100.0,
                        "Value": "None"
                    },
                    "Gender": {
                        "Confidence": 95.72,
                        "Value": "Male"
                    },
                    "Glasses": "None",
                    "Hairstyle": {
                        "Confidence": 98.23,
                        "Value": "Short"
                    },
                    "Hat": {
                        "Confidence": 99.99,
                        "Value": "None"
                    },
                    "Location": {
                        "H": 98,
                        "W": 98,
                        "X": 550,
                        "Y": 251
                    },
                    "Mask": {
                        "Confidence": 99.99,
                        "Value": "None"
                    },
                    "Mustache": {
                        "Confidence": 99.58,
                        "Value": "None"
                    },
                    "Quality": {
                        "Blur": 13.72,
                        "Integrity": 100.0,
                        "Pitch": 5.84,
                        "Roll": 3.66,
                        "Yaw": 21.22
                    },
                    "Smile": 82.49
                }
            ]
        },
        "Result": [
            {
                "Confidence": null,
                "Description": "リスクは検出されませんでした",
                "Label": "nonLabel"
            }
        ],
        "RiskLevel": "none"
    },
    "Msg": "success",
    "RequestId": "TEST001-2024-0307-0728-5201314YHX"
}

• 顔属性検出プロフェッショナル版レスポンス例：

{
    "Code": 200,
    "Data": {
        "DataId": "test0307****",
        "Ext": {
            "FaceData": [
                {
                    "Age": 24,
                    "Bang": {
                        "Confidence": 100.0,
                        "Value": "None"
                    },
                    "Gender": {
                        "Confidence": 95.72,
                        "Value": "Male"
                    },
                    "Glasses": "None",
                    "Hairstyle": {
                        "Confidence": 98.23,
                        "Value": "Short"
                    },
                    "Hat": {
                        "Confidence": 99.99,
                        "Value": "None"
                    },
                    "Location": {
                        "H": 98,
                        "W": 98,
                        "X": 550,
                        "Y": 251
                    },
                    "Mask": {
                        "Confidence": 99.99,
                        "Value": "None"
                    },
                    "Mustache": {
                        "Confidence": 99.58,
                        "Value": "None"
                    },
                    "Quality": {
                        "Blur": 13.72,
                        "Integrity": 100.0,
                        "Pitch": 5.84,
                        "Roll": 3.66,
                        "Yaw": 21.22
                    },
                    "Smile": 82.49
                }
            ]
        },
        "Result": [
            {
                "Label": "face_exaggerated",
                "Description": "画像内の人物は誇張された表情をしています",
                "Confidence": 80.0
            }
        ],
        "RiskLevel": "high"
    },
    "Msg": "success",
    "RequestId": "TEST001-2024-0307-0728-5201314YHX"
}

コードの説明

インターフェイスによって返されるコードの意味を以下に詳しく説明します。コード 200 のリクエストのみがメーターされ、課金されます。その他のコードは課金されません。