このトピックでは、AI ガードレール SDK の使用方法について説明します。
SDK の使用方法
SDK を使用する前に、各 API の機能を確認してください。詳細については、「API 概要」をご参照ください。
-
ポルノの検出、テロリストのコンテンツ検出、OCR、ロゴ検出などの画像検出機能は、単一の API に統合されています。この API は以下の 2 つの方法で呼び出すことができます。
-
同期型画像検出 API:複数の画像を検出し、すべての検出結果を同期的に取得できます。最適な結果を得るには、1 回のリクエストにつき 1 枚の画像を処理することを推奨します。
-
非同期型画像検出 API:画像のバッチ検出をサポートします。この API は各画像に対して taskId を返します。検出タスクを送信した後は、taskId を使用して検出結果を取得してください。バッチでの画像検出には、この方法を推奨します。
-
-
ポルノの検出、テロリストのコンテンツ検出、ロゴ検出などの動画検出機能は、単一の API に統合されています。この API は以下の 2 つの方法で呼び出すことができます。
-
同期型動画検出 API:動画から抽出したフレームのシーケンスのみを検出できます。この方法は推奨されません。
-
非同期型動画検出 API:動画の検出をサポートします。検出タスクを送信した後は、taskId を使用して検出結果を取得するか、コールバック URL を設定して通知を受け取ることができます。動画コンテンツの検出には、この方法を推奨します。
-
-
音声モデレーション:音声モデレーション SDK は、音声ストリームおよび音声ファイルの検出をサポートします。非同期型検出 API のみが利用可能です。検出タスクを送信した後は、taskId を使用して検出結果を取得するか、コールバック URL を設定して通知を受け取ることができます。
-
テキストモデレーション:同期型検出 API のみが利用可能です。この API を使用して、1 回のリクエストで 1 つ以上のテキストエントリを検出できます。
画像検出 API など 1 つの API を複数のシナリオで使用する場合、合計料金は次のように計算されます:シナリオごとの単価 × 検出したコンテンツ量。
前提条件
-
AI ガードレール SDK は、以下の言語および環境で利用可能です。
-
SDK のコード例をダウンロードします。
green-sdk-sample_doc をクリックして、SDK のコード例をダウンロードします。
コード例パッケージには、Java、PHP、Python の完全なサンプルが含まれています。
重要2018-05-09 より前の API バージョンはオフラインになっています。レガシバージョン番号を使用すると、HttpCode:400、ErrorCode:InvalidAction.NotFound のエラーが返されます。このエラーが発生した場合は、バージョン 2018-05-09 に切り替えてください。
-
サードパーティ製 SDK を参照します。
Java、PHP、Python、Go、.NET 以外のプログラミング言語を使用する場合は、HTTP リクエストを直接送信して AI ガードレール API を呼び出すことができます。C#、C++、Node.js、Python (3.5) などの言語向けにサードパーティ製 SDK も提供されています。詳細については、「その他の言語向け SDK」をご参照ください。
説明Alibaba Cloud はサードパーティ製 SDK のメンテナンスを提供しません。これらはリファレンス目的でのみ掲載されています。