Alibaba Cloud コンテンツモデレーション 2.0 の画像モデレーション は、AI 生成コンテンツ(AIGC)シナリオ向けの AI 生成画像識別サービスを提供します。このサービスを使用すると、画像が AI によって生成されたかどうかを判断できます。このトピックでは、このサービスについて詳しく説明します。
1. シナリオ
Alibaba Cloud コンテンツモデレーションは、テキストから画像への生成や画像から画像への生成などの AIGC シナリオ向けに、次のカスタムモデレーションサービスを提供します。
AI-generated image identification:技術の進歩に伴い、AI 生成画像はユーザーが作成した画像とますます類似してきています。 AI によって生成された画像を識別してラベル付けしたい場合があります。 ここで、Alibaba Cloud コンテンツモデレーションの AI 生成画像識別サービスが役立ちます。
2. サービスの説明
画像モデレーション 2.0 は、AIGC シナリオ向けに次のサービスを提供します。
サービス | モデレートされるコンテンツ | 使用シナリオ |
サービス名:AI-generated image identification (aigcDetector_global) | このサービスが呼び出されると、指定された画像が AI によって生成されたかどうかを確認します。 | さまざまなシナリオにおいて、画像が AI によって生成されたかどうかを確認します。 画像のソースを識別する必要がある場合に、このサービスを使用することをお勧めします。 |
3. モデレーション機能
AI-generated image identification を使用すると、画像が AI によって生成されたかどうかを判断できます。 AIGC またはユーザー生成コンテンツ(UGC)ラベルが返されます。
4. 課金
画像モデレーション 2.0 の AI 生成画像識別サービスは、従量課金 課金方法をサポートしています。
従量課金
画像モデレーション 2.0 サービスをアクティブ化すると、デフォルトの課金方法は従量課金になります。 日次料金は実際の使用量に基づいて決済されます。 サービスが呼び出されない場合、料金は発生しません。
モデレーションタイプ | サポートされているビジネスシナリオ(サービス) | 単価 |
一般的な画像モデレーション(image_standard) |
| 1,000 回あたり 0.6 米ドル 説明 AI 生成画像識別サービスを呼び出すたびに課金されます。 サービスの呼び出し回数に基づいて課金されます。 たとえば、AI 生成画像識別サービスを 100 回呼び出すと、0.06 米ドルが課金されます。 |
従量課金制の Content Moderation 2.0 の請求書は、24時間ごとに生成されます。請求の詳細では、moderationType
は上記の表のモデレーションタイプの列に対応しています。詳細については、[Bill Details] ページをご参照ください。
5. 使用ガイド
手順 1:サービスをアクティブ化する
サービスのアクティブ化 ページを開き、画像モデレーション 2.0 サービスをアクティブ化します。
画像モデレーション 2.0 サービスをアクティブ化すると、デフォルトの課金方法は従量課金になります。 日次料金は実際の使用量に基づいて決済されます。 サービスが呼び出されない場合、料金は発生しません。 API を呼び出すと、課金システムは使用量に基づいて自動的に課金します。 詳細については、「課金方法」をご参照ください。
手順 2:RAM ユーザーに権限を付与する
API オペレーションを呼び出したり、SDK を Resource Access Management (RAM) ユーザーとして使用したりする前に、RAM ユーザーに権限を付与する必要があります。 Alibaba Cloud アカウントと RAM ユーザーの AccessKey ペアを作成できます。 API オペレーションを呼び出すときは、AccessKey ペアを使用して ID 検証を完了する必要があります。 AccessKey ペアの取得方法については、「AccessKey ペアの作成」をご参照ください。
Alibaba Cloud アカウントを使用して、または管理権限を持つ RAM ユーザーとして、RAM コンソール にログオンします。
RAM ユーザーを作成します。 詳細については、「RAM ユーザーの作成」をご参照ください。
AliyunYundunGreenWebFullAccess システムポリシーを RAM ユーザーに付与します。 詳細については、「RAM ユーザーへの権限の付与」をご参照ください。 上記の設定が完了したら、RAM ユーザーとしてコンテンツモデレーション API を呼び出すことができます。
手順 3:SDK をインストールして使用する
詳細については、「画像モデレーション 2.0 SDK と使用ガイド」をご参照ください。 次の表に、サポートされているリージョンを示します。
リージョン | パブリックエンドポイント | インターナルエンドポイント | サポートされているサービス |
シンガポール | https://green-cip.ap-southeast-1.aliyuncs.com | https://green-cip-vpc.ap-southeast-1.aliyuncs.com | aigcDetector_global |
手順 4:画像モデレーションルールを調整する(オプション)
コンテンツモデレーションコンソール で、画像モデレーションサービスの検出ルールを調整できます。 これには、モデレーションスコープの確認、サービスの複製、カスタム画像ライブラリの構成、カスタム用語ライブラリの構成、検出レコードのクエリ、使用量の確認が含まれます。 詳細については、「コンソールガイド」をご参照ください。
6. API
使用上の注意
画像モデレーション 2.0 API を呼び出して、画像モデレーションのタスクを作成できます。 HTTP リクエストを作成する方法については、「画像モデレーション 2.0 SDK と使用ガイド」をご参照ください。 また、既存の HTTP リクエストを選択することもできます。 詳細については、「画像モデレーション 2.0 SDK と使用ガイド」をご参照ください。
オペレーション:ImageModeration
課金:このオペレーションの呼び出しに対して課金されます。 HTTP ステータスコードが 200 のリクエストに対してのみ、従量課金方式で課金されます。 課金方法の詳細については、「課金方法」をご参照ください。
画像の制限
画像は、PNG、JPG、JPEG、BMP、WEBP、TIFF、SVG、HEIC(最長辺が 8192 ピクセル未満)、GIF(最初のフレームを抽出)、または ICO(最後のレイヤーを抽出)形式である必要があります。
画像の最大サイズは 20 MB に制限されており、高さまたは幅は 16,384 ピクセルを超えることはできず、合計ピクセル数は 2 億 5000 万ピクセルを超えることはできません。 コンテンツモデレーション検出アルゴリズムの結果に影響が出ないように、最低解像度 200 × 200 ピクセルの画像を送信することをお勧めします。
画像の最大ダウンロード時間は 3 秒です。 画像が 3 秒以内にダウンロードできない場合は、タイムアウトエラーが返されます。
QPS 制限
このオペレーションは、アカウントごとに 1 秒あたり最大 100 回呼び出すことができます。 1 秒あたりの呼び出し数が制限を超えると、スロットリングがトリガーされます。 その結果、ビジネスに影響が出る可能性があります。 このオペレーションを呼び出すときは、制限に注意することをお勧めします。 ビジネス要件または緊急のスケーリング要件を満たすために、より高い 1 秒あたりのクエリ数(QPS)が必要な場合は、カスタマービジネスマネージャー(CBM)にお問い合わせください。
デバッグ
SDK をデプロイする前に、Alibaba Cloud OpenAPI Explorer を使用して、画像モデレーション 2.0 API をオンラインでデバッグし、呼び出しのサンプルコードと SDK の依存関係を表示できます。 これにより、API の呼び出し方法と関連パラメーターの設定方法を理解できます。
コンテンツモデレーション API を呼び出す前に、Alibaba Cloud アカウントを使用してコンテンツモデレーションコンソールにログオンする必要があります。 したがって、オペレーションの呼び出しによって発生した料金は、アカウントに請求されます。
リクエストパラメーター
すべてのコンテンツモデレーション API リクエストに含める必要がある共通のリクエストパラメーターについては、「画像モデレーション 2.0 SDK と使用ガイド」をご参照ください。
リクエストボディは JSON 構造です。 次の表に、リクエストボディに含まれるパラメーターを示します。
パラメーター | タイプ | 必須 | 例 | 説明 |
Service | String | はい | aigcDetector | モデレーションサービス。有効な値:
|
ServiceParameters | JSONString | はい | コンテンツモデレーションオブジェクトに関連するパラメーター。 値は JSON 文字列です。 各文字列の説明については、「表 1. ServiceParameters」をご参照ください。 |
表 1. ServiceParameters
パラメーター | タイプ | 必須 | 例 | 説明 |
imageUrl | String | はい。 画像モデレーション 2.0 は、3 つの画像アップロード方法をサポートしています。
| https://img.alicdn.com/tfs/TB1U4r9AeH2gK0jSZJnXXaT1FXa-2880-480.png | モデレートするオブジェクトの URL。 URL がインターネット経由でアクセス可能であり、URL の長さが 2,048 文字を超えないことを確認してください。 注 URL に日本語文字を含めることはできません。 各リクエストで 1 つの URL のみ指定してください。 |
ossBucketName | String | bucket_01 | 認証済みの OSS バケットの名前。 説明 OSS バケット内の画像のインターナルエンドポイントを送信する前に、Alibaba Cloud アカウントを使用して クラウドリソースアクセス認証 ページにアクセスし、OSS バケットにアクセスするための権限を付与する必要があります。 | |
ossObjectName | String | 2022023/04/24/test.jpg | 認証済みの OSS バケット内のオブジェクトの名前。 | |
ossRegionId | String | cn-beijing | OSS バケットのリージョン。 | |
dataId | String | いいえ | img123**** | モデレートするオブジェクトの ID。 ID には大文字、小文字、数字、アンダースコア(_)、ハイフン(-)、ピリオド(.)を含めることができます。 ID は最大 64 文字で、ビジネスデータを一意に識別します。 |
referer | String | いいえ | www.aliyun.com | リファラーリクエストヘッダー。ホットリンク保護などのシナリオで使用されます。 値は最大 256 文字です。 |
レスポンスパラメーター
パラメーター | タイプ | 例 | 説明 |
RequestId | String | 70ED13B0-BC22-576D-9CCF-1CC12FEAC477 | リクエスト ID。問題の特定とトラブルシューティングに使用されます。 |
Data | Object | 画像モデレーションの結果。 詳細については、「表 2. Data」をご参照ください。 | |
Code | Integer | 200 | 返される HTTP ステータスコード。 詳細については、「レスポンスコード」をご参照ください。 |
Msg | String | OK | レスポンスで返されるメッセージ。 |
表 2. Data
パラメーター | タイプ | 例 | 説明 |
Result | Array | ラベルパラメーターや信頼度パラメーターなどの画像モデレーションパラメーターの結果。 詳細については、「表 3. Result」をご参照ください。 | |
RiskLevel | String | high | リスクレベル。構成されたリスクスコアに基づいて返されます。有効な値:
説明 次の処理方法を推奨します。 お客様は高リスクのコンテンツを直接処理します。 中リスクのコンテンツは手動でレビューする必要があります。 低リスクのコンテンツは、よりリスクの高いコンテンツが検出されたときに処理できます。 お客様は、検出されたリスクがないコンテンツをビジネス要件に基づいて処理できます。 リスクスコアは コンテンツモデレーションコンソール で構成できます。 |
DataId | String | img123****** | モデレートされたオブジェクトの ID。 説明 リクエストで dataId パラメーターを指定した場合、レスポンスで dataId パラメーターの値が返されます。 |
表 3. Result
パラメーター | タイプ | 例 | 説明 |
Label | String | tm_auto | 画像モデレーション後に返されるラベル。 1 つの画像に対して、複数のリスクラベルと対応する信頼レベルのスコアが返される場合があります。 サポートされているラベルの詳細については、以下をご参照ください。 |
Confidence | Float | 81.22 | 信頼レベルのスコア。有効な値:0 ~ 100。 値は小数点以下 2 桁までです。 一部のラベルには信頼レベルのスコアがありません。 詳細については、「リスクラベルの説明」をご参照ください。 |
Description | String | 煙または火に関するコンテンツ | Labal フィールドの説明。 重要 このフィールドは Label フィールドの説明であり、変更される場合があります。 このフィールドではなく、Label フィールドに基づいてモデレーション結果を処理することをお勧めします。 |
例
サンプルリクエスト
{
"Service": "aigcDetector_global",
"ServiceParameters": {
"imageUrl": "https://img.alicdn.com/tfs/TB1U4r9AeH2gK0jSZJnXXaT1FXa-2880-480.png",
"dataId": "img123****"
}
}
サンプル出力
{
"Msg": "OK",
"Code": 200,
"Data": {
"DataId": "img123****",
"Result": [
{
"Label": "aigc",
"Confidence": 81.88,
"Description": "AI によって生成された疑いがあります。"
}
]
},
"RequestId": "ABCD1234-1234-1234-1234-1234XYZ"
}
このトピックのサンプルリクエストとレスポンスは、読みやすくするためにフォーマットされています。 実際のレスポンスは、改行やインデントなしでフォーマットされます。
リスクラベルの説明
次の表に、リスクラベルの値、対応する信頼レベルのスコア、およびリスクラベルの定義を示します。 各リスクラベルは、コンテンツモデレーションコンソールで構成できます。 また、一部のリスクラベルに対して、より具体的なモデレーションスコープを構成することもできます。 詳細については、「コンソールガイド」をご参照ください。
システムによって返されたリスクラベルと信頼レベルのスコアを一定期間保存することをお勧めします。保存されたデータは、後続のコンテンツガバナンスの参考として使用できます。リスクラベルに基づいて、手動レビューの優先順位、アノテーションの優先順位、または階層分類のコンテンツガバナンス対策を設定できます。
表 4。 AI 生成画像識別 (aigcDetector_global) でサポートされているラベル
ラベル値 | 信頼レベルのスコア | 定義 |
aigc | 有効な値: 0 ~ 100。スコアが高いほど、信頼レベルが高いことを示します。 | 画像が AI によって生成された疑いがあります。 |
ugc | 有効な値: 0 ~ 100。スコアが高いほど、信頼レベルが高いことを示します。 | 画像は AI によって生成されていません。 |
レスポンスコード
次の表は、レスポンスコードについて説明しています。従量課金制で課金されるのは、レスポンスコードが 200 のリクエストに対してのみです。
コード | 説明 |
200 | リクエストは成功しました。 |
400 | すべてのリクエストパラメータが設定されているわけではありません。 |
401 | 1 つ以上のリクエストパラメータに指定された値が無効です。 |
402 | 無効なリクエストパラメータです。確認して修正し、再試行してください。 |
403 | リクエストの QPS が上限を超えています。一度に送信されるリクエストの数を確認して修正してください。 |
404 | 指定された画像をダウンロードできませんでした。画像の URL を確認するか、再試行してください。 |
405 | 指定された画像のダウンロードがタイムアウトしました。考えられる原因は、画像にアクセスできないことです。画像を確認して調整し、再試行してください。 |
406 | 指定された画像が大きすぎます。画像サイズを確認して変更し、再試行してください。 |
407 | 指定された画像の形式はサポートされていません。画像形式を確認して変更し、再試行してください。 |
408 | 必要な権限がありません。考えられる原因は、このアカウントがアクティブ化されていないか、支払いが期限切れになっているか、この API オペレーションを呼び出す権限がないことです。 |
500 | システム例外が発生しました。 |