AI Guardrails:Document Moderation 2.0 API

注意事項

• ビジネスオペレーション：FileModeration。非同期モードのみ対応しています。

• 対応リージョンおよびアクセスアドレス：

  リージョン	パブリックネットワークアクセスアドレス	イントラネットアクセスアドレス	対応サービス
  シンガポール	green-cip.ap-southeast-1.aliyuncs.com	green-cip-vpc.ap-southeast-1.aliyuncs.com	document_detection_global

• 課金：本オペレーションは課金対象であり、処理対象ドキュメントのページ数に基づいて課金されます。

• モデレーション対象：一般的なドキュメント形式がサポートされています。

• 結果の配信：モデレーション結果はリアルタイムで返却されません。ポーリングまたはコールバック通知を有効化することで結果を取得できます。結果は最大 24 時間保持されます。

  • コールバック通知：モデレーションタスク送信時に、callback パラメーターにコールバック URL を指定します。

  • ポーリング：callback パラメーターを空欄のまま送信し、その後、結果照会オペレーションを呼び出します。

• ドキュメント要件：

  • 対応プロトコル：HTTP および HTTPS。

  • 対応フォーマット：DOC、DOCX、PPT、PPTX、PPS、PPSX、PDF、XLS、XLSX、XLTX、XLTM、HTML、TXT（UTF-8 エンコーディング）。

  • サイズ制限：1 ドキュメントあたり最大 200 MB。この制限を超える場合は、ドキュメントを圧縮または分割してください。

  • モデレーション所要時間はドキュメントのダウンロード時間に依存します。Alibaba Cloud OSS などの安定性・信頼性の高いストレージサービスをご利用ください。

• ルール構成：初回呼び出しの前に、Content Moderation コンソールで Document Moderation のルールを構成してください。構成を行わないと、Document Moderation 2.0 はデフォルト設定で動作します。

QPS 制限

本オペレーションは、1 アカウントあたり 1 秒間に最大 100 回まで呼び出すことができます。システムは最大 20 件の同時モデレーションタスクをサポートします。この上限を超えるリクエストは破棄され、サービスが中断される可能性があります。本オペレーションを呼び出す際は、この制限にご注意ください。

デバッグ

Alibaba Cloud OpenAPI を使用して、Document Moderation 2.0 オペレーションをオンラインでデバッグし、サンプルコードおよび SDK 依存関係を表示し、オペレーションパラメーターを調査できます。

リクエストパラメーター

表 1. ServiceParameters

*url、ossBucketName/ossObjectName/ossRegionId（OSS 承認）、およびローカルドキュメントアップロード（SDK 経由）は、相互排他な入力方法です。いずれか 1 つを選択してください。ローカルドキュメントアップロードのコード例については、「Document Moderation 2.0 SDK およびアクセスガイド」をご参照ください。

レスポンスパラメーター

サンプル

リクエストのサンプル

{
    "service": "document_detection_global",
    "serviceParameters": {
        "taskId": "abcd****"
    }
}

{
  "Service": "document_detection_global",
  "ServiceParameters":
  {
    "url": "http://www.aliyundoc.com/a.pdf",
    "dataId": "fileId-2024-0307-0728***"
  }
}

成功レスポンスのサンプル

{
    "Msg": "OK",
    "Code": 200,
    "Data":
    {
        "TaskId": "AAAAA-BBBBB-CCCCCCCC"
    },
    "RequestId": "ABCD1234-1234-1234-1234-123****"
}

注意事項

• ビジネスオペレーション：DescribeFileModerationResult。Document Moderation タスクの結果を取得します。

• 課金：本オペレーションは無料です。

• 照会タイミング：非同期モデレーションリクエスト送信後、少なくとも 30 秒経過してからモデレーション結果を照会してください。結果は最大 24 時間保持され、4 時間経過後に自動削除されます。

QPS 制限

本オペレーションは、1 アカウントあたり 1 秒間に最大 100 回まで呼び出すことができます。この上限を超えると速度制限が発生し、サービスに影響を与える可能性があります。本オペレーションを呼び出す際は、この制限にご注意ください。

デバッグ

Alibaba Cloud OpenAPI を使用して、本オペレーションをオンラインでデバッグし、サンプルコードおよび SDK 依存関係を表示し、オペレーションパラメーターを調査できます。

リクエストパラメーター

表 1. ServiceParameters

レスポンスパラメーター

表 2. Data

表 3. PageSummary

表 4. ImageSummary

表 5. ImageLabels

表 6. TextSummary

表 7. TextLabels

表 8. PageResult

表 9. ImageResult

表 10. LabelResult

表 11. TextResult

サンプル

リクエストのサンプル

成功レスポンスのサンプル

{
    "Code": 200,
    "Data": {
        "DataId": "fileId-2024-0307-0728***",
        "PageResult": [
            {
                "ImageResult": [
                    {
                        "Description": "ドキュメントページの画像コンテンツのモデレーション",
                        "LabelResult": [
                            {
                                "label": "nonLabel"
                            }
                        ],
                        "Service": "baselineCheck_global"
                    }
                ],
                "ImageUrl": "http://oss.aliyundoc.com/a.png",
                "PageNum": 1,
                "TextResult": [
                    {
                        "Description": "ドキュメントページのテキストコンテンツのモデレーション",
                        "Labels": "",
                        "RiskTips": "",
                        "RiskWords": "",
                        "Service": "comment_multilingual_global",
                        "Text": "Content Moderation プロダクトのテストケース a"
                    }
                ]
            },
            ...
            {
                "ImageResult": [
                    {
                        "Description": "ドキュメントページの画像コンテンツのモデレーション",
                        "LabelResult": [
                            {
                                "Confidence": 89.01,
                                "Label": "pornographic_adultContent_tii"
                            }
                        ],
                        "Service": "baselineCheck_global"
                    }
                ],
                "ImageUrl": "http://oss.aliyundoc.com/b.png",
                "PageNum": 10,
                "TextResult": [
                    {
                        "Description": "ドキュメントページのテキストコンテンツのモデレーション",
                        "Labels": "contraband,sexual_content",
                        "RiskTips": "Prohibited_prohibited goods,Pornographic_film resources,Pornographic_Vulgar",
                        "RiskWords": "risk word A,risk word B",
                        "Service": "comment_multilingual_global",
                        "Text": "Content Moderation プロダクトのテストケース b"
                    }
                ]
            }
        ],
        "Url": "http://www.aliyundoc.com/a.docx"
    },
    "Message": "SUCCESS",
    "RequestId": "1D0854A7-AAAAA-BBBBBBB-CC8292AE5"
}