AI Guardrails:顔属性検出 API

注意事項

API オペレーション：/green/face/detect。この操作は、顔属性の同期検出を実行します。

この操作を呼び出して顔属性検出タスクを作成し、即座に検出結果を取得します。HTTP リクエストの構築方法については、「リクエスト構造」をご参照ください。また、あらかじめ作成済みの HTTP リクエストを使用することもできます。詳細については、「SDK 概要」をご参照ください。

• 課金：

  この操作の呼び出しに対して課金されます。課金方法の詳細については、をご参照ください。

• 検出タイムアウト：

  同期モードでのモデレーションリクエストに対する最大応答時間は 6 秒です。6 秒以内にモデレーションが完了しない場合、タイムアウトエラーが返されます。リアルタイムでモデレーション結果を必要としない場合は、非同期モードでのモデレーションリクエストを送信できます。ただし、同期モードの操作は呼び出しが容易であるため、ほとんどのケースで同期モードでのリクエストを推奨します。同期モードの操作を呼び出す際には、タイムアウト期間を 6 秒に設定することを推奨します。

• 応答：

  通常、同期モードのモデレーションリクエストを送信後、1 秒以内にモデレーション結果が返されます。ただし、システム内で大量のリクエストを処理する必要がある場合、画像サイズが大きい場合、または画像に多数の文字が含まれる場合など、特殊なシナリオでは応答時間が延長されることがあります。

• 画像要件：

  • 画像の URL は HTTP または HTTPS の URL である必要があります。

  • 画像は PNG、JPG、JPEG、BMP、GIF、WEBP 形式である必要があります。

  • 画像サイズは最大 20 MB までです。この制限は、同期モードおよび非同期モードの両方のモデレーション操作に適用されます。

  • 画像のダウンロード時間は最大 3 秒までとされています。3 秒以内に画像のダウンロードが完了しない場合、タイムアウトエラーが返されます。

  • モデレーション効果を確保するため、少なくとも 256 × 256 ピクセルの画像を提出することを推奨します。

  • 画像のモデレーション操作の応答時間は、これらの画像のダウンロード時間によって異なります。モデレーション対象の画像を格納するストレージサービスは、安定性と信頼性を確保してください。Object Storage Service (OSS) または コンテンツデリバリーネットワーク (CDN) の利用を推奨します。

QPS 制限

アカウントあたり、この操作を 1 秒間に最大 50 回まで呼び出すことができます。1 秒あたりの呼び出し回数がこの上限を超えると、速度制限が発動し、業務に影響を及ぼす可能性があります。この操作を呼び出す際には、上限値を十分にご確認ください。

リクエストパラメーター

戻り値

サンプル

リクエストのサンプル

http(s)://[Endpoint]/green/face/detect
&<共通リクエストパラメーター>
{
    "bizType": "abc",
    "dataId": "test2NInmO$tAON6qYUrtCRgLo-1mwxdi",
    "url": "http://example.com/face1.jpeg"
}

応答のサンプル

{
    "msg": "OK",
    "code": 200,
    "extras": {
        "width": "328",
        "height": "390"
    },
    "faces": [
        {
            "glasses": {
                "rate": 0.99,
                "value": "None"
            },
            "qualified": false,
            "bang": {
                "rate": 0.99,
                "value": "Has"
            },
            "respirator": {
                "rate": 0.99,
                "value": "None"
            },
            "hat": {
                "rate": 0.99,
                "value": "None"
            },
            "location": {
                "w": 116,
                "h": 116,
                "x": 134,
                "y": 135
            },
            "mustache": {
                "rate": 0.99,
                "value": "None"
            },
            "hairstyle": {
                "rate": 0.99,
                "value": "Short"
            },
            "quality": {
                "roll": 0.38,
                "blur": 6.44,
                "pitch": 21.21,
                "yaw": 21.12
            },
            "smile": {
                "rate": 0.99,
                "value": 0.5
            }
        }
    ],
    "dataId": "test2NInmO$tAON6qYUrtCRgLo-1mwxdi",
    "taskId": "img1uJtIrlwH$F4FA3h$Sxe2F-1tbWWx",
    "url": "http://example.com/face1.jpeg"
}