Content Moderation:非同期顔照合タスクの送信

非同期画像モデレーションに関する説明非同期イメージ モデレーション

操作: /green/image/asyncscan

この操作を呼び出して、非同期画像モデレーションタスクを送信できます。 HTTP リクエストを作成する方法の詳細については、「リクエスト構造」をご参照ください。既存の HTTP リクエストを選択することもできます。詳細については、「SDK の概要」をご参照ください。

• 課金方法:

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

  説明

  顔照合機能の場合、2 回ではなく 1 回の照合のために 2 つの画像を渡します。

• 応答タイムアウト:

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

• 結果の戻り値:

  非同期モデレーションリクエストを送信した場合、モデレーション結果はリアルタイムで返されません。モデレーション結果を取得するには、モデレーション結果を定期的にポーリングするか、コールバック通知を有効にすることができます。モデレーション結果は最大 1 時間保持されます。

  • コールバックによる検出結果の取得: 非同期検出タスクを送信するときに、リクエストパラメータで callback パラメータを指定して、検出結果を自動的に受信できます。詳細については、「リクエストパラメータ」をご参照ください。

  • ポーリングによる検出結果の取得: 非同期検出タスクを送信するときに、callback パラメータを指定する必要はありません。非同期検出タスクを送信した後、結果クエリ操作を呼び出して検出結果を取得できます。詳細については、「/green/image/results に関する説明」をご参照ください。

• 画像の制限:

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

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

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

  • 画像のダウンロード期間は 3 秒に制限されています。画像が 3 秒以内にダウンロードされない場合は、タイムアウトエラーが返されます。

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

  • 画像をモデレートする操作の応答時間は、これらの画像のダウンロード期間によって異なります。モデレートする画像を保存するために、安定していて信頼できるストレージサービスを使用してください。Object Storage Service (OSS) または Content Delivery Network (CDN) を使用することをお勧めします。

QPS 制限

この操作は、アカウントごとに 1 秒あたり最大 50 回呼び出すことができます。1 秒あたりの呼び出し数が制限を超えると、速度制限がトリガーされます。その結果、ビジネスに影響が及ぶ可能性があります。この操作を呼び出すときは、制限に注意することをお勧めします。

リクエストパラメータ

レスポンスパラメータ

例

http(s)://[エンドポイント]/green/image/asyncscan
&<共通リクエストパラメータ>
{
    "scenes": [
        "sface-1"
    ],
    "tasks": [
        {
            "url": "http://www.aliyundoc.com/2015/0826/2015082612403321.jpg",
            "dataId": "e6b080a8-a91a-11e8-bac4-6c96cfde2af9",
            "extras": {
                "faceUrl": "http://www.aliyundoc.com/c/u/2013/0313/1363136852136.jpg"
            },
            "time": 949640
        }
    ]
}

{
    "code": 200,
    "msg": "OK",
    "requestId": "95AD868A-F5D2-4AEA-96D4-E0273B8E074C",
    "data": [
        {
            "code": 200,
            "msg": "OK",
            "dataId": "e6b080a8-a91a-11e8-bac4-6c96cfde2af9",
            "taskId": "fdd25f95-4892-4d6b-aca9-7939bc6e9baa-1486198766695",
            "url": "http://www.aliyundoc.com/2015/0826/2015082612403321.jpg"
        }
    ]
}

/green/image/results に関する説明

操作: /green/image/results

この操作を呼び出して、非同期画像モデレーション結果を照会できます。 HTTP リクエストを作成する方法の詳細については、「リクエスト構造」をご参照ください。既存の HTTP リクエストを選択することもできます。詳細については、「SDK の概要」をご参照ください。

• 課金方法:

  この操作は無料です。

• 応答タイムアウト:

  非同期モデレーションリクエストを送信してから少なくとも 30 秒後にモデレーション結果を照会することをお勧めします。Content Moderation は、モデレーション結果を最大 4 時間保持します。4 時間後、結果は削除されます。

QPS 制限

この操作は、アカウントごとに 1 秒あたり最大 50 回呼び出すことができます。1 秒あたりの呼び出し数が制限を超えると、速度制限がトリガーされます。その結果、ビジネスに影響が及ぶ可能性があります。この操作を呼び出すときは、制限に注意することをお勧めします。

リクエストパラメータ

レスポンスパラメータ

例

http(s)://[エンドポイント]/green/image/results
&<共通リクエストパラメータ>
[
    "fdd25f95-4892-4d6b-aca9-7939bc6e9baa-1486198766695"
]

{
    "code": 200,
    "msg": "OK",
    "requestId": "9EEF894F-A933-4830-97B1-EC1A9630A9D6",
    "data": [
        {
            "code": 200,
            "dataId": "e6b080a8-a91a-11e8-bac4-6c96cfde2af9",
            "taskId": "img2hsbmQeA4CU7l78$s8q5mW-1pnn7Z",
            "url": "http://www.aliyundoc.com/2015/0826/2015082612403321.jpg",
            "extras": {

            },
            "msg": "OK",
            "results": {
                "label": "sface-1",
                "rate": 97.0,
                "scene": "sface-1",
                "suggestion": "review"
            }
        }
    ]
}