AI Guardrails:非同期イメージ OCR タスクの送信

非同期操作の説明

操作: /green/image/asyncscan

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

• 課金方法:

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

• レスポンス タイムアウト:

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

• 返される結果:

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

  • コールバック通知を有効にしてモデレーション結果を取得する: 非同期モデレーション タスクを送信するときに、モデレーション リクエストの callback パラメーターでコールバック URL を指定して、モデレーション結果を受信できます。 callback パラメーターの詳細については、リクエスト パラメーターをご参照ください。

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

• イメージの制限:

  • イメージの URL は、HTTP または HTTPS URL である必要があります。

  • イメージは、PNG、JPG、JPEG、BMP、GIF、または WEBP 形式である必要があります。

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

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

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

  • イメージをモデレートする操作のレスポンス時間は、これらのイメージのダウンロード時間によって異なります。モデレートするイメージを保存するために、安定していて信頼できるストレージ サービスを使用してください。オブジェクト ストレージ サービス (OSS) またはコンテンツ配信ネットワーク (CDN) を使用することをお勧めします。

QPS 制限

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

リクエスト パラメーター

レスポンスパラメーター

例

http(s)://[Endpoint]/green/image/asyncscan
&<共通リクエストパラメーター>
{
    "scenes": [
        "ocr"
    ],
    "tasks": [
        {
            "dataId": "test_data_xxxx",
            "url": "https://www.aliyundoc.com/test_image_xxxx.png"
        }
    ]
}

{
    "code": 200,
    "msg": "OK",
    "requestId": "92AD868A-F5D2-4AEA-96D4-E1273B8E074C",
    "data": [
        {
            "code": 200,
            "msg": "OK",
            "dataId": "test_data_xxxx",
            "taskId": "aaa25f95-4892-4d6b-aca9-7939bc6e9baa-148619876****",
            "url": "https://www.aliyundoc.com/test_image_xxxx.png"
        }
    ]
}

/green/image/results 操作の説明

操作: /green/image/results

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

• 課金方法:

  この操作は無料です。

• レスポンスタイムアウト:

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

QPS 制限

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

リクエストパラメーター

レスポンスパラメーター

例

http(s)://[Endpoint]green/image/results
&<共通リクエストパラメーター>
[
    "aaa25f95-4892-4d6b-aca9-7939bc6e9baa-148619876****"
]

{
    "code": 200,
    "data": [
        {
            "code": 200,
            "dataId": "test_data_xxxx",
            "extras": {

            },
            "msg": "OK",
            "results": [
                {
                    "label": "ocr",
                    "ocrData": [
                        "This topic describes how to call an operation to submit asynchronous image moderation tasks." // 画像非同期モデレーションタスクを送信する操作を呼び出す方法について説明します。
                    ],
                    "ocrLocations": [
                        {
                            "h": 19,
                            "text": "This topic describes how to call an operation to submit asynchronous image moderation tasks.", // 画像非同期モデレーションタスクを送信する操作を呼び出す方法について説明します。
                            "w": 362,
                            "x": 31,
                            "y": 11
                        }
                    ],
                    "rate": 99.91,
                    "scene": "ocr",
                    "suggestion": "review"
                }
            ],
            "taskId": "aaa25f95-4892-4d6b-aca9-7939bc6e9baa-148619876****",
            "url": "https://www.aliyundoc.com/test_image_xxxx.png"
        }
    ],
    "msg": "OK",
    "requestId": "992C7849-AA45-4055-8F82-8D44D64C15E3"
}