:コンテンツモデレーション API についての FAQ

コンテンツモデレーションの非同期操作を呼び出すたびに、複数のモデレーション結果が返されることがありますか？

いいえ、コンテンツモデレーションの非同期操作を呼び出すたびに、複数のモデレーション結果が返されることはありません。

コンテンツモデレーション API 呼び出しの統計情報を照会するにはどうすればよいですか？

コンテンツモデレーションコンソールは、コンテンツモデレーション API 呼び出しの統計情報を収集します。過去 1 年間に画像、動画、テキストをモデレートするためにコンテンツモデレーション API が呼び出された回数を照会できます。詳細については、「統計情報の表示」をご参照ください。

コンテンツモデレーションでテキストをモデレートするために呼び出すことができる操作はどれですか？

/green/text/scan 操作を呼び出して、違反がないかテキストをモデレートできます。 /green/text/scan 操作の詳細については、「/green/text/scan」をご参照ください。

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

テキストモデレーション結果が期待どおりでない場合は、/green/text/feedback 操作を呼び出してフィードバックを提供できます。詳細については、「/green/text/feedback」をご参照ください。

コンテンツモデレーション操作の呼び出し後に返されるパラメータの説明を表示するにはどうすればよいですか？

共通パラメータに記載されている、共通レスポンスパラメータと共通 HTTP ステータスコードの説明を表示できます。

API リクエストに関する署名情報をリクエスト本文に含めることはできますか？

いいえ、署名情報はリクエストヘッダーに含める必要があります。検証のために、HTTP リクエストの Authorization ヘッダーに signature パラメータを設定して署名情報を指定する必要があります。コンテンツモデレーション SDK を使用することをお勧めします。コンテンツモデレーションは、Java、Python、PHP など、さまざまなプログラミング言語で SDK を提供しています。詳細については、「共通パラメータ」および「SDK 概要」をご参照ください。

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

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

コンテンツモデレーション操作を呼び出してコンテンツをモデレートするにはどのくらいの時間がかかりますか？

Composer を使用して PHP 用のコンテンツモデレーション SDK をダウンロードできますか？

はい、Composer が PHP 5.3 以降をサポートしている場合は、Composer を使用して PHP 用のコンテンツモデレーション SDK をダウンロードできます。Composer のインストールに関するチュートリアルは提供されていません。PHP 用コンテンツモデレーション SDK のインストール方法の詳細{ "error": { "code": 500, "message": "Internal error encountered.", "status": "INTERNAL" } } については、「インストール」をご参照ください。

コンテンツモデレーションで /green/text/scan 操作を呼び出して英語のテキストをモデレートできますか？

はい、/green/text/scan 操作を呼び出して英語のテキストをモデレートできます。詳細については、「/green/text/scan」をご参照ください。

コンテンツモデレーションでビデオモデレーション操作を呼び出して、サイズが 2 GB を超えるビデオをモデレートできますか？

デフォルトでは、モデレートされる単一のビデオのサイズは 200 MB を超えることはできません。必要に応じて、テクニカルサポートに連絡してサイズ制限を最大 2 GB まで引き上げることができます。サイズが 2 GB を超えるビデオをモデレートする場合は、ビデオを複数の部分に分割してからモデレートすることをお勧めします。デフォルトでは、ビデオから最大 200 フレームをキャプチャできます。大きなビデオからモデレーションのためにさらに多くのフレームをキャプチャする場合は、maxFrames パラメータを設定する必要があります。 maxFrames パラメータの最大値は 3600 フレームです。詳細については、「/green/video/asyncscan および /green/video/results」をご参照ください。

コンテンツモデレーション操作を呼び出すにはどのような権限が必要ですか？権限はどのように付与されますか？

Resource Access Management (RAM) ユーザーの AccessKey ID と AccessKey シークレットを使用して、コンテンツモデレーション操作を呼び出すことができます。 RAM ユーザーとしてコンテンツモデレーション操作を呼び出す前に、RAM ユーザーに権限を付与する必要があります。詳細については、「RAM ユーザーにコンテンツモデレーション API を呼び出す権限を付与する」をご参照ください。

コンテンツモデレーションでモデレートされる画像のサイズ制限はどのくらいですか？

コンテンツモデレーションは、サイズが 20 MB を超えず、高さまたは幅が 30,000 ピクセルを超えず、合計解像度が 2 億 5000 万ピクセルを超えない画像をモデレートできます。詳細については、「/green/image/scan」をご参照ください。

コンテンツモデレーション操作を呼び出す際の同時実行制限は何ですか？

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

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

いいえ、モデレーションではパブリック URL のみがサポートされています。データ漏えいのリスクを防ぐために、パブリック URL の有効期間を短く設定することをお勧めします。たとえば、有効期間を 10 分に設定できます。

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

モデレーションのために送信する前に、画像を圧縮することをお勧めします。画像の解像度が 256 × 256 ピクセルより大きい場合、解像度はモデレーション結果にほとんど影響を与えません。

HTTP リクエストを作成してコンテンツモデレーション操作を呼び出すことはできますか？

はい、HTTP リクエストを作成してコンテンツモデレーション操作を呼び出すことができます。ただし、各リクエストに署名する必要があります。 Alibaba Cloud 公式 Web サイトで提供されている SDK を使用してコンテンツモデレーション操作を呼び出すことをお勧めします。

RAM ユーザーの AccessKey ペアを使用してコンテンツモデレーション操作を呼び出すことはできますか？

• RAM ユーザーの AccessKey ペアを使用して、API バージョンが V20160621 以降のコンテンツモデレーション操作を呼び出すことができます。必要な依存関係の詳細については、「SDK 概要」をご参照ください。

• RAM ユーザーの AccessKey ペアを使用して、API バージョンが V20160621 より前のコンテンツモデレーション操作を呼び出すことはできません。呼び出すと、AccessDenied エラーが返されます。

コンテンツモデレーション API は呼び出し例を提供していますか？

.NET 用 SDK を使用してコンテンツモデレーション操作を呼び出すことはできますか？

いいえ、他のプログラミング言語用のコンテンツモデレーション SDK を使用することをお勧めします。または、HTTP リクエストを作成してコンテンツモデレーション操作を呼び出すこともできます。詳細については、「SDK 概要」および「リクエスト構文」をご参照ください。

コンテンツモデレーションは GIF 形式の画像をモデレートできますか？

はい、コンテンツモデレーションは PNG、JPG、JPEG、BMP、GIF、または WEBP 形式の画像をモデレートできます。詳細については、「/green/image/scan」をご参照ください。

コンテンツモデレーション操作を呼び出すときに、最大ダウンロード時間を 3 秒からより長い時間に延長できますか？

いいえ、最大ダウンロード時間を延長することはできません。画像をモデレートするためにコンテンツモデレーション操作を呼び出すときにダウンロードエラーが頻繁に発生する場合は、画像 URL にアクセスできるかどうか、または画像を 3 秒以内にダウンロードできるかどうかを確認してください。 API リクエストを行うときは、サーバーが存在するリージョンに最も近いリージョンのコンテンツモデレーションのエンドポイントを使用できます。詳細については、「エンドポイント」をご参照ください。

コンテンツモデレーションで /green/image/scan 操作を呼び出すたびに、最大でいくつの画像をモデレートできますか？

一度に最大 100 枚の画像をモデレートできます。一度に 100 枚の画像をモデレートするには、同時実行制限を 100 より大きい値に引き上げる必要があります。デフォルトでは、一度に最大 50 枚の画像、100 個のテキストエントリ、、または 20 個の動画をモデレートできます。詳細については、「/green/image/scan」および価格をご参照ください。

1 つのコンテンツモデレーション操作を呼び出して、ポルノ検出やテロコンテンツ検出など、複数のシナリオでコンテンツを同時にモデレートできますか？

はい、1 つのコンテンツモデレーション操作を呼び出して、複数のシナリオでコンテンツを同時にモデレートできます。これを行うには、API リクエストの scenes パラメータを複数のシナリオに設定します。たとえば、scenes パラメータを ["porn","terrorism"] に設定して、画像内のポルノとテロコンテンツを検出できます。一度に複数のシナリオをモデレーションに指定した場合、すべてのシナリオの累積料金が課金されます。各シナリオの料金は、そのシナリオでモデレートされた画像の数にそのシナリオの単価を掛けたものに等しくなります。詳細については、「/green/image/scan」および価格をご参照ください。

コンテンツモデレーション操作の呼び出しに使用できるドメイン名とポートは何ですか？

ネットワークセキュリティポリシーを設定する必要がある場合は、*.aliyuncs.com からのアクセスを有効にし、ポート 80 と 443 を有効にすることをお勧めします。

コンテンツモデレーションでビデオモデレーション操作を呼び出して、ApsaraVideo VOD のビデオをモデレートするにはどうすればよいですか？

コンテンツモデレーションでビデオモデレーション操作を呼び出して ApsaraVideo VOD のビデオをモデレートするには、ビデオの ID を直接送信することはできません。ビデオからキャプチャされた一連のフレーム、またはビデオにアクセスするために使用できる URL を送信する必要があります。 詳細については、「/green/video/asyncscan および /green/video/results」をご参照ください。

コンテンツモデレーションは M3U8 ビデオファイルをモデレートできますか？

いいえ、コンテンツモデレーションは M3U8 ビデオファイルをモデレートできません。コンテンツモデレーションは、AVI、FLV、MP4、MPG、ASF、WMV、MOV、WMA、RMVB、RM、FLASH、TS などの形式のビデオファイルをモデレートできます。詳細については、「/green/video/asyncscan および /green/video/results」をご参照ください。

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

米国のリージョンでコンテンツモデレーション操作を呼び出してビデオをモデレートできますか？

はい、米国のリージョンでコンテンツモデレーション操作を呼び出してビデオをモデレートできます。詳細については、「エンドポイント」をご参照ください。

コンテンツモデレーションの /green/video/syncscan 操作と /green/video/asyncscan 操作の違いは何ですか？

/green/video/syncscan 操作を呼び出すには、モデレートされるビデオからキャプチャされた一連のフレームを送信する必要があります。ビデオ URL を送信してモデレートするビデオを指定する場合は、/green/video/asyncscan 操作を呼び出すことをお勧めします。

/green/video/asyncscan 操作を呼び出して、ビデオファイルとビデオストリームをモデレートできます。ビデオファイルをモデレートするには、ビデオファイルからキャプチャされた一連のフレームを送信するか、ビデオファイルの URL を指定できます。ただし、非同期モデレーションタスクのモデレーション結果をリアルタイムで取得することはできません。モデレーション結果を取得するには、API リクエストで callback パラメータを設定するか、/green/video/results 操作を呼び出してモデレーション結果をポーリングします。詳細については、「/green/video/syncscan」および「/green/video/asyncscan および /green/video/results」をご参照ください。

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

はい、非同期画像モデレーションの API リクエストに callback パラメータを設定できます。詳細については、「画像モデレーション」をご参照ください。

コンテンツモデレーションの bizType パラメータは何を指定しますか？

bizType パラメータはビジネスシナリオを指定します。各ビジネスシナリオはモデレーションポリシーに対応しています。コンテンツモデレーション API を使用する前に、ビジネス要件に基づいてカスタムビジネスシナリオを作成することをお勧めします。ビジネスシナリオのモデレーションポリシーをカスタマイズした後、コンテンツモデレーションの API リクエストでビジネスシナリオを指定できます。この場合、対応するモデレーションポリシーが有効になります。詳細については、「機械支援モデレーションのポリシーをカスタマイズする」をご参照ください。

コンテンツモデレーションでテキストライブラリを複数のビジネスシナリオに関連付ける目的は何ですか？

カスタムテキストライブラリまたはカスタム画像ライブラリを作成するときは、ライブラリが適用されるビジネスシナリオにカスタムテキストライブラリまたはカスタム画像ライブラリを関連付けることをお勧めします。たとえば、テキストライブラリがビジネスシナリオ A に関連付けられており、テキストモデレーションの API リクエストでビジネスシナリオ A を指定した場合、ビジネスシナリオ A に関連付けられているテキストライブラリがテキストモデレーションに使用されます。それ以外の場合、有効になっているすべてのテキストライブラリがテキストモデレーションに使用されます。詳細については、「カスタムテキストライブラリを管理する」をご参照ください。

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

checksum パラメータの値は、<UID> + <Seed> + <Content> 形式の文字列です。 Secure Hash Algorithm 256 (SHA-256) アルゴリズムを使用して生成されます。 UID は Alibaba Cloud アカウントの ID を示します。 ID は Alibaba Cloud 管理コンソールで取得できます。コールバック通知のデータが改ざんされるのを防ぐために、サーバーがコールバック通知を受信したときに SHA-256 アルゴリズムを使用して文字列を生成できます。次に、生成された文字列を受信した checksum パラメータと照合して検証できます。詳細については、「コールバック通知を有効にする」をご参照ください。

コンテンツモデレーションで /green/text/scan 操作を呼び出した後、dataId が返されないのはなぜですか？

/green/text/scan 操作の API リクエストで dataId を指定した場合、操作の呼び出し後に dataId が返されます。詳細については、「/green/text/scan」をご参照ください。

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

通常、これは、複数シナリオの構成が単一シナリオの構成と異なるためです。したがって、同じ画像が単一シナリオと複数シナリオでモデレートされると、構成が競合します。アルゴリズムエンジニアに連絡して、シナリオの構成が異なるかどうかを確認することをお勧めします。または、同じ画像を異なるシナリオで個別にモデレートすることもできます。詳細については、「/green/image/scan」および「画像モデレーション」をご参照ください。

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

context パラメータは、モデレートされたテキストに含まれるリスクのある用語を示します。モデレートされたテキストがアルゴリズムモデルやテキストパターンなどの他のポリシーに該当する場合、このパラメータは返されません。詳細については、「/green/text/scan」をご参照ください。

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

filteredContent パラメータは、モデレートされたテキストに含まれる該当用語がアスタリスク (*) で編集された後に返されるテキストを示します。モデレートされたテキストがカスタムテキストライブラリ内の特定の用語またはテキストパターンに該当する場合、このパラメータが返されます。 context パラメータは、モデレートされたテキストに含まれるリスクのある用語を示します。モデレートされたテキストがアルゴリズムモデルやテキストパターンなどの他のポリシーに該当する場合、このパラメータは返されません。詳細については、「/green/text/scan」をご参照ください。

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

コンテンツモデレーションは、テキスト内の絵文字を認識できません。絵文字は返されるテキストモデレーション結果から除外されます。

コンテンツモデレーションにおいて、同期画像モデレーションの精度と再現率は非同期画像モデレーションと異なりますか？

いいえ、同期画像モデレーションと非同期画像モデレーションのモデレーション効果は同じです。唯一の違いは、それらが異なる操作によって実装されていることです。

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

Java 用コンテンツモデレーション SDK の ClientUploader ユーティリティクラスをダウンロードし、プロジェクトにインポートする必要があります。ダウンロード URL と手順の詳細については、「インストール」をご参照ください。

Python 3.5.4 および 3.8.8 用コンテンツモデレーション SDK で aliyunsdkcore ライブラリがインストールに失敗するのはなぜですか？

メインストリームバージョンの Python 3.x 用コンテンツモデレーション SDK をインストールすることをお勧めします。この場合、aliyunsdkcore ライブラリがまだインストールに失敗する場合は、aliyunsdkcore ライブラリをダウンロードしてプロジェクトにインポートできます。詳細については、「インストール」をご参照ください。

Python 用コンテンツモデレーション SDK の aliyunsdkgreenextension ユーティリティクラスをインストールするにはどうすればよいですか？

aliyunsdkgreenextension ユーティリティクラスをダウンロードしてプロジェクトにインポートする必要があります。詳細については、「インストール」をご参照ください。

from aliyunsdkgreenextension.request.extension import HttpContentHelper`

コンテンツモデレーションのカスタム用語ライブラリには、英語以外の言語の用語を含めることができますか？

いいえ、コンテンツモデレーションのカスタム用語ライブラリには、英字と数字のみを含めることができます。

ローカルマシンから OSS にアップロードされた画像またはビデオの OSS URL の有効期間はどのくらいですか？

オブジェクトストレージサービス (OSS) URL の有効期間は 1 時間です。

コンテンツモデレーションでライブビデオストリームをモデレートするにはどのように課金されますか？

ライブビデオストリームのモデレート費用は、ライブビデオストリームからキャプチャされたフレームの数によって異なります。キャプチャされたフレームの数を計算するには、ライブビデオストリームの時間をフレームがキャプチャされる時間間隔で割ります。

たとえば、ライブビデオストリームの時間が 1 時間で、5 秒ごとにフレームがキャプチャされる場合、キャプチャされたフレームの数は次の式で計算されます。3,600 秒 / 5 秒 = 720。したがって、720 のキャプチャされたフレームに対して課金されます。

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

コンテンツモデレーションでは、ライブビデオストリームのモデレーション結果は個別に返されます。違反が検出されるたびに、モデレーション結果が返されます。ライブストリームのモデレーションが完了すると、全体的なモデレーション結果が返されます。

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

ライブストリームをモデレートするための API 呼び出しが停止した後、対応するモデレーションタスクは停止します。ただし、低レイテンシが存在するため、コールバック URL は特定のデータを引き続き受信できます。

タスクの送信後にライブストリームが中断または利用できなくなった場合、ライブストリームをモデレートするタスクは停止しますか？

タスクの送信後にライブストリームが中断または利用できなくなった場合、コンテンツモデレーションは特定の間隔で 3 回ライブストリームをリクエストします。最小間隔は 10 秒です。 30 秒以内にライブストリームをまだ取得できない場合、タスクは停止します。

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

モデレーションが成功した場合、ステータスコード 200 が返されます。ライブストリーミングが進行中の場合、ステータスコード 280 が返されます。ライブストリーミングが終了または中断された場合、ステータスコード 200 が返されます。