すべてのプロダクト
Search

このプロダクト

    AI Guardrails:AI Guardrails API のよくある質問

    ドキュメントセンター

    AI Guardrails:AI Guardrails API のよくある質問

    最終更新日:Jun 09, 2026

    AI Guardrails API の呼び出しに関するよくある質問です。モデレーション制限、SDK の使用方法、コールバック設定などについて説明します。

    AI Guardrails の非同期操作を呼び出すたびに、複数のモデレーション結果を返すことはできますか?

    いいえ。各非同期呼び出しでは、1 つのモデレーション結果のみが返されます。

    AI Guardrails API 呼び出しの統計情報を照会するにはどうすればよいですか?

    Content Moderation コンソールには、過去 1 年間の画像、動画、テキストモデレーションの API 呼び出し数の集計が表示されます。統計情報を表示します。

    テキストをモデレーションするには、どの API を呼び出せばよいですか?

    違反のあるテキストをモデレーションするには、/green/text/scan API を呼び出します。

    テキストモデレーション結果のエラーに関するフィードバックを送信するにはどうすればよいですか?

    テキストモデレーション結果が不正確な場合は、/green/text/feedback を呼び出してエラーを報告します。

    AI Guardrails API を呼び出した後に返されるパラメータの説明を確認するにはどうすればよいですか?

    一般的なレスポンスパラメータと HTTP ステータスコードは、共通パラメータに記載されています。

    API リクエストの署名情報をリクエストボディに含めることはできますか?

    いいえ。署名は Authorization ヘッダーに含める必要があります。手動で署名する代わりに、AI Guardrails SDK (Java、Python、PHP など) を使用することを推奨します。共通パラメータおよびSDK の概要をご参照ください。

    テキストモデレーション中に、テキスト内の不適切なコンテンツへのリンク URL を検出できますか?

    いいえ。テキストモデレーションは、テキストベースの違反のみを検出し、不適切なコンテンツへのリンク URL は検出しません。

    AI Guardrails API を呼び出してコンテンツをモデレーションするのにどのくらい時間がかかりますか?

    モデレーション時間は、コンテンツの種類によって異なります。

    • 画像：画像 1 枚あたり約 300 ミリ秒 (ダウンロード時間を除く)。

    • 動画：

      • 動画ファイル：再生速度の 1 倍から 6 倍 (ダウンロード時間を除く)。6 倍速の場合、6 分の動画の処理に約 1 分かかります。

      • 動画ストリーム：各フレームがキャプチャされてから 1 秒以内に結果が返されます。

    • テキスト：結果は 50 ミリ秒以内に返されます。

    Composer を使用して AI Guardrails SDK for PHP をダウンロードできますか?

    はい。Composer が PHP 5.3 以降をサポートしている場合に可能です。インストールをご参照ください。

    AI Guardrails で /green/text/scan API を呼び出して英語のテキストをモデレーションできますか?

    はい。/green/text/scan をご参照ください。

    AI Guardrails で動画モデレーション API を呼び出して、サイズが 2 GB を超える動画をモデレーションできますか?

    デフォルトの単一動画サイズ制限は 200 MB です。テクニカルサポートに連絡して、最大 2 GB まで引き上げることができます。2 GB を超える動画の場合は、モデレーション前にセグメント化してください。デフォルトのフレームキャプチャ制限は 200 (最大 3,600) です。大きな動画の場合は maxFrames パラメータを設定してください。/green/video/asyncscan および /green/video/results をご参照ください。

    AI Guardrails API を呼び出すにはどのような権限が必要ですか? 権限はどのように付与されますか?

    RAM ユーザーの AccessKey ID と AccessKey Secret を使用します。RAM ユーザーには、最初に必要な権限を付与する必要があります。RAM ユーザーに AI Guardrails API の呼び出しを許可するをご参照ください。

    AI Guardrails でモデレーションする画像のサイズ制限はどのくらいですか?

    最大：ファイルサイズ 20 MB、高さまたは幅 30,000 ピクセル、合計 2 億 5 千万ピクセル。/green/image/scan をご参照ください。

    AI Guardrails API を呼び出す際の同時実行数の制限とは何ですか?

    同時実行数の制限とは、同時にモデレーションできる画像、動画、またはテキストエントリの総数です。これは、従量課金とサブスクリプション課金の両方に適用されます。

    次の表は、さまざまなタイプのオブジェクトをモデレーションするために AI Guardrails API を呼び出す際の同時実行数の制限を示しています。

    モデレーション対象

    デフォルトの同時実行数制限

    単位

    説明

    画像

    50

    N/A

    1 秒あたりにモデレーションできる画像の最大数。

    動画

    20

    N/A

    同時にモデレーションできる動画の最大数。ファイルとストリームは区別されません。

    テキスト

    100

    N/A

    1 秒あたりにモデレーションできるテキストエントリの最大数。各テキストエントリは 200 文字未満です。
    説明

    • デフォルトの同時実行数の制限内でのモデレーションは無料です。制限を増やすには、営業担当者にお問い合わせください。制限を増やすと追加料金が発生します。

    • 単一のオブジェクトの複数シナリオモデレーションは、同時実行数 1 としてカウントされます。たとえば、1 つの画像をポルノとテロリズムの両方でモデレーションすると、1 つの同時実行スロットを消費します。

    モデレーション用にオブジェクトの内部 URL を送信できますか?

    いいえ。一般に公開されている URL のみがサポートされています。データ漏洩を防ぐため、公開 URL には短い有効期間 (たとえば 10 分) を設定してください。

    サイズ制限を超える画像をモデレーションするにはどうすればよいですか?

    送信前に画像を圧縮してください。256 × 256 ピクセルを超える解像度は、モデレーション結果にほとんど影響しません。

    HTTP リクエストを作成して AI Guardrails API を呼び出すことはできますか?

    はい。ただし各リクエストに署名する必要があります。公式 SDK を使用することを推奨します。

    RAM ユーザーの AccessKey ペアを使用して AI Guardrails API を呼び出すことはできますか?

    • はい。API バージョン V20160621 以降の場合。SDK の概要をご参照ください。

    • いいえ。20160621 より前のバージョンは対応していません。古い API バージョンで RAM ユーザーの AccessKey を使用すると、AccessDenied エラーが返されます。

    AI Guardrails API には呼び出しサンプルが用意されていますか?

    はい。呼び出しサンプルは SDK リファレンスにあります。SDK の概要をご参照ください。

    説明

    呼び出しサンプルは API の進化に伴って更新されます。公式ドキュメントを定期的に確認してください。

    SDK for .NET を使用して AI Guardrails API を呼び出すことはできますか?

    いいえ。他の言語の SDK を使用するか、HTTP リクエストを直接作成してください。SDK の概要およびリクエスト構文をご参照ください。

    AI Guardrails は GIF 形式の画像をモデレーションできますか?

    はい。サポートされている形式：PNG、JPG、JPEG、BMP、GIF、および WEBP。/green/image/scan をご参照ください。

    AI Guardrails API を呼び出す際に、最大ダウンロード時間を 3 秒からより長い期間に延長できますか?

    いいえ。ダウンロードエラーが頻繁に発生する場合は、画像 URL がアクセス可能で、3 秒以内に応答することを確認してください。サーバーリージョンに最も近いエンドポイントを使用してください。エンドポイントをご参照ください。

    AI Guardrails で /green/image/scan API を呼び出すたびに、最大で何枚の画像をモデレーションできますか?

    同期呼び出しごとに最大 100 枚の画像。100 枚の画像を処理するには、同時実行数の制限が少なくとも 100 である必要があります。デフォルトの制限：画像 50 枚/秒、テキストエントリ 100 件/秒、動画および音声ストリーム 20 件。同期モデレーションおよび料金をご参照ください。

    AI Guardrails の単一の API を呼び出して、ポルノ検出やテロコンテンツ検出など、複数のシナリオでコンテンツを同時にモデレーションできますか?

    はい。Scenes パラメータに複数のシーンを指定します。たとえば ["porn", "terrorism"] です。シーンごとに課金されます：合計コスト = (画像の数) × (シーンごとの価格)。同期モデレーションおよび料金をご参照ください。

    AI Guardrails API を呼び出すために使用できるドメイン名とポートは何ですか?

    ネットワークセキュリティポリシーで、ポート 80 および 443 で *.aliyuncs.com へのアクセスを許可してください。

    AI Guardrails で動画モデレーション API を呼び出して、ApsaraVideo VOD 内の動画をモデレーションするにはどうすればよいですか?

    Video Moderation API は、ApsaraVideo VOD の VideoID に直接は対応していません。代わりに、フレームをキャプチャして画像シーケンスをアップロードするか、アクセスできる動画 URL を提供してください。非同期モデレーションをご参照ください。

    AI Guardrails は M3U8 動画ファイルをモデレーションできますか?

    いいえ。サポートされている動画形式：AVI、FLV、MP4、MPG、ASF、WMV、MOV、WMA、RMVB、RM、FLASH、および TS。/green/video/asyncscan および /green/video/results をご参照ください。

    動画モデレーションの非同期タスクにはどのくらい時間がかかりますか?

    時間はコンテンツの種類によって異なります (ダウンロード時間を除く)。

    • 動画ファイル：再生速度の 1 倍から 6 倍。6 倍の場合、6 分の動画には約 1 分かかります。

    • 動画ストリーム：各フレームがキャプチャされてから 1 秒以内に結果が返されます。

    米国リージョンで AI Guardrails API を呼び出して動画をモデレーションできますか?

    はい。エンドポイントをご参照ください。

    AI Guardrails の /green/video/syncscan API と /green/video/asyncscan API の違いは何ですか?

    /green/video/syncscan API では、事前にキャプチャしたフレームを送信する必要があります。/green/video/asyncscan API では、動画 URL を直接指定できます。

    /green/video/asyncscan API は、動画ファイルとストリームの両方に対応しています。キャプチャされたフレームまたは動画 URL を送信できます。結果はリアルタイムで返されません。コールバックパラメータを設定するか、/green/video/results でポーリングしてください。/green/video/syncscan および /green/video/asyncscan および /green/video/results をご参照ください。

    AI Guardrails SDK for Java を使用して実装された非同期画像モデレーションの API リクエストで、コールバックパラメータを設定できますか?

    はい。画像モデレーションをご参照ください。

    AI Guardrails の bizType パラメータは何を指定しますか?

    bizType パラメータは、モデレーションポリシーに紐づくビジネスシナリオを指定します。要件に合ったカスタムシナリオを作成し、API リクエストでシナリオを指定して、対応するポリシーを適用します。機械支援モデレーションのポリシーをカスタマイズをご参照ください。

    AI Guardrails でテキストライブラリを複数のビジネスシナリオに関連付ける目的は何ですか?

    カスタムテキストまたは画像ライブラリをビジネスシナリオに関連付けて、API リクエストでそのシナリオが指定されている場合にのみ適用されるようにします。シナリオが指定されていない場合は、有効なすべてのライブラリが使用されます。カスタムテキストライブラリの管理をご参照ください。

    /green/video/asyncscan API を呼び出した後、コールバック通知の checksum パラメータの値が計算値と異なるのはなぜですか?

    チェックサムは、<UID> + <Seed> + <Content> の SHA-256 ハッシュです。UID は Alibaba Cloud アカウント ID です (コンソールで確認できます)。サーバーがコールバックを受信したら、ハッシュを再計算し、受信したチェックサムと照合して改ざんを検出します。コールバック通知を有効にするをご参照ください。

    AI Guardrails で /green/text/scan API を呼び出した後、dataId が返されないのはなぜですか?

    テキストモデレーションリクエストに [DataId] パラメータを含めると、API レスポンスにもその [DataId] が含まれます。詳細については、同期テキストモデレーションをご参照ください。

    単一シナリオモデレーションと複数シナリオモデレーションで、同じ画像に対して異なるラベルが返されるのはなぜですか?

    これは通常、単一シナリオと複数シナリオの設定が異なるために発生します。アルゴリズムエンジニアに連絡して設定の競合を確認するか、各シナリオで画像を個別にモデレーションしてください。/green/image/scan および 画像モデレーションをご参照ください。

    テキストモデレーション結果で context パラメータが返されないのはなぜですか?

    context パラメータは、一致の原因となったリスクのある用語を返します。テキストがアルゴリズムモデルやテキストパターンなどの他のポリシーによって検出された場合、このパラメータは返されません。/green/text/scan をご参照ください。

    テキストモデレーション結果で filteredContent パラメータは返されるが、context パラメータが返されないのはなぜですか?

    FilteredContent フィールドには、検出された用語がアスタリスク (*) に置き換えられた、フィルタリング済みのテキストが表示されます。このフィールドは、テキストがカスタムキーワードまたは類似性ベースのアルゴリズムに一致する場合に返されます。Context フィールドには、特定のリスクのある用語が含まれており、キーワードが一致した場合にのみ返されます。コンテンツがアルゴリズムモデルまたは類似性ポリシーによって判定された場合は返されません。詳細については、同期テキストモデレーションをご参照ください。

    テキストモデレーション結果に絵文字が含まれないのはなぜですか?

    AI Guardrails は絵文字を認識できません。絵文字は、返されるモデレーション結果から除外されます。

    AI Guardrails の同期画像モデレーションと非同期画像モデレーションでは、精度と再現率に違いがありますか?

    いいえ。どちらもモデレーションの性能は同じです。呼び出し方法 (同期と非同期) のみが異なります。

    AI Guardrails SDK for Java でローカルファイルやバイナリファイルをモデレーションするために使用される ClientUploader ユーティリティクラスをダウンロードできないのはなぜですか?

    ClientUploader ユーティリティクラスをダウンロードして、プロジェクトにインポートしてください。インストールをご参照ください。

    AI Guardrails SDK for Python 3.5.4 および 3.8.8 で aliyunsdkcore ライブラリのインストールに失敗するのはなぜですか?

    主流の Python 3.x バージョンを使用してください。それでもインストールに失敗する場合は、aliyunsdkcore ライブラリを手動でダウンロードして、プロジェクトにインポートしてください。インストールをご参照ください。

    AI Guardrails SDK for Python の aliyunsdkgreenextension ユーティリティクラスをインストールするにはどうすればよいですか?

    aliyunsdkgreenextension ユーティリティクラスをダウンロードして、プロジェクトにインポートしてください。インストールをご参照ください。

    ユーティリティクラスをインポートします。

    from aliyunsdkgreenextension.request.extension import HttpContentHelper

    AI Guardrails のカスタム用語ライブラリに英語以外の言語の用語を含めることはできますか?

    いいえ。カスタム用語ライブラリは、英字と数字のみに対応しています。

    コンテンツモデレーションのためにローカルマシンから OSS にアップロードされた画像または動画の OSS URL の有効期間はどのくらいですか?

    OSS URL の有効期間は 1 時間です。

    AI Guardrails でライブ動画ストリームをモデレーションする場合、どのように課金されますか?

    課金は、キャプチャされたフレーム数に基づいています。ストリーム時間をキャプチャ間隔で割って、フレーム数を計算します。

    例：キャプチャ間隔が 5 秒の 1 時間のストリームでは、3,600 ÷ 5 = 720 フレームが生成されます。720 フレームに対して課金されます。

    AI Guardrails でライブストリームのモデレーション結果はどのようにコールバック URL に返されますか?

    違反が検出されるたびに、結果が個別に返されます。モデレーションが完了すると、全体的な結果が返されます。

    AI Guardrails がライブストリームのモデレーションを停止した後も、コールバック URL がデータを受信し続けるのはなぜですか?

    モデレーションタスクが停止した後、レイテンシにより、コールバック URL が短時間データを受信し続ける場合があります。

    タスクが送信された後、ライブストリームが中断または利用不可になった場合、ライブストリームをモデレーションするタスクは停止しますか?

    ストリームが中断または利用不可になった場合、AI Guardrails は最低 10 秒の間隔で 3 回再試行します。30 秒後もストリームが利用できない場合、タスクは停止します。

    ライブストリームモデレーションでステータスコード 200 が返されるのはいつですか?

    ステータスコード 200 は、モデレーションが成功したとき、またはストリームが終了/中断したときに返されます。ステータスコード 280 は、ストリームがまだモデレーション中であることを示します。