すべてのプロダクト
Search
ドキュメントセンター

AI Guardrails:SDK 概要

最終更新日:Mar 19, 2026

このトピックでは、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 のメンテナンスを提供しません。これらはリファレンス目的でのみ掲載されています。