API の説明
画像モデレーション 2.0 API を使用して、画像に規制に違反するコンテンツ、プラットフォームの秩序を乱すコンテンツ、またはユーザーエクスペリエンスに悪影響を与えるコンテンツが含まれているかどうかを検出できます。この API は、40 以上のコンテンツリスクラベルと40 以上のリスク管理項目をサポートしています。Content Moderation の画像モデレーション 2.0 を使用すると、ビジネスシナリオ、プラットフォームのコンテンツ管理ルール、および API によって返されるリスクラベルと信頼度スコアに基づいて、特定の画像コンテンツに対してさらなるモデレーションまたは管理措置を実装できます。詳細については、「画像モデレーション 2.0 の概要と課金」をご参照ください。
接続ガイド
Alibaba Cloud アカウントを作成します。今すぐ登録し、画面の指示に従ってください。
従量課金の Content Moderation サービスを有効化します。サービスを有効化したことを確認してください。サービスの有効化には料金はかかりません。サービスを使用した後、使用量に基づいて自動的に課金されます。詳細については、「課金の詳細」をご参照ください。
AccessKey を作成します。RAM を使用して AccessKey を作成したことを確認してください。RAM ユーザーの AccessKey を使用する場合、Alibaba Cloud アカウントを使用して RAM ユーザーに AliyunYundunGreenWebFullAccess 権限を付与する必要があります。詳細については、「RAM 権限付与」をご参照ください。
開発者インテグレーション。SDK を使用して API を呼び出すことをお勧めします。詳細については、「画像モデレーション 2.0 SDK と使用ガイド」をご参照ください。
使用上の注意
この画像モデレーション 2.0 API を呼び出して、画像モデレーションのタスクを作成できます。HTTP リクエストの作成方法の詳細については、「HTTPS 呼び出しを行う」をご参照ください。SDK を使用してリクエストを行うこともできます。詳細については、「画像モデレーション 2.0 SDK と使用ガイド」をご参照ください。
API 操作: ImageModeration
サポートされるリージョンとエンドポイント:
リージョン
パブリックエンドポイント
VPC エンドポイント
サポートされているサービス
シンガポール
https://green-cip.ap-southeast-1.aliyuncs.com
https://green-cip-vpc.ap-southeast-1.aliyuncs.com
baselineCheck_global、aigcDetector_global
英国 (ロンドン)
https://green-cip.eu-west-1.aliyuncs.com
利用不可
米国 (バージニア)
https://green-cip.us-east-1.aliyuncs.com
https://green-cip-vpc.us-east-1.aliyuncs.com
baselineCheck_global、aigcDetector_global
米国 (シリコンバレー)
https://green-cip.us-west-1.aliyuncs.com
利用不可
ドイツ (フランクフルト)
green-cip.eu-central-1.aliyuncs.com
利用不可
説明イギリス (ロンドン) リージョンはシンガポールリージョンのコンソール設定を再利用します。米国 (シリコンバレー) およびドイツ (フランクフルト) リージョンは、米国 (バージニア) リージョンのコンソール設定を再利用します。
課金:
これは課金対象の API 操作です。HTTP ステータスコードが 200 を返すリクエストに対してのみ課金されます。他のエラーコードを返すリクエストは課金されません。課金方法の詳細については、「課金の詳細」をご参照ください。
イメージ要件:
PNG、JPG、JPEG、BMP、WEBP、TIFF、SVG、HEIF (最長辺は 8,192 px 未満である必要があります)、GIF (最初のフレームのみが使用されます)、および ICO (最後のイメージのみが使用されます) のイメージフォーマットがサポートされています。
画像のサイズは 20 MB を超えることはできません。高さまたは幅は 16,384 px を超えることはできず、総ピクセル数は 1 億 6700 万を超えることはできません。画像の解像度は 200 × 200 px 以上にすることをお勧めします。解像度が低いと、モデレーションアルゴリズムのパフォーマンスに影響する可能性があります。
画像のダウンロード時間は 3 秒に制限されています。ダウンロードに 3 秒以上かかると、タイムアウトエラーが返されます。
QPS制限
単一ユーザーの 1 秒あたりのクエリ (QPS) 制限は 100 コール/秒です。この制限を超えると、API 呼び出しがスロットルされ、ビジネスに影響を与える可能性があります。ビジネスでより高い QPS が必要な場合、または緊急のスケールアウトが必要な場合は、ビジネス マネージャーにお問い合わせください。
デバッグ
接続する前に、Alibaba Cloud OpenAPI Explorer を使用して、画像モデレーション 2.0 API をオンラインでデバッグすることもできます。呼び出しのサンプルコードと SDK の依存関係情報を表示して、API とそのパラメーターの使用方法の概要を把握できます。
オンラインデバッグ機能は、現在ログインしているアカウントに基づいて Content Moderation API を呼び出します。したがって、呼び出し回数はアカウントの課金対象の使用量に含まれます。
リクエストパラメーター
リクエストに含める必要がある共通のリクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。
リクエストボディは、次のフィールドを含む JSON 構造体です:
名前 | タイプ | 必須 | 例 | 説明 |
Service | String | はい | baselineCheck_global | 画像モデレーション 2.0 でサポートされるモデレーションサービス。有効な値:
説明 サービス間の違いについては、「サービスの説明」をご参照ください。AIGC 専用サービスについては、「AIGC シナリオ検出サービス」をご参照ください。国際版は中国以外のリージョンでのみ使用できます。 |
ServiceParameters | JSONString | はい | コンテンツモデレーションオブジェクトに関連するパラメーター。 値はJSON文字列です。 各文字列の説明の詳細については、「ServiceParameters」をご参照ください。 |
表 1. ServiceParameters
名前 | タイプ | 必須 | 例 | 説明 |
imageUrl | String | はい。画像モデレーション 2.0 は、画像を渡す 3 つの方法をサポートしています。次のいずれかを選択してください:
| https://img.alicdn.com/tfs/TB1U4r9AeH2gK0jSZJnXXaT1FXa-2880-480.png | モデレーション対象のオブジェクトの URL。URL がパブリックネットワーク経由でアクセス可能であり、その長さが 2,048 文字を超えないことを確認してください。 説明
|
ossBucketName | String | bucket_01 | 権限を付与された OSS バケットの名前。 説明 OSS イメージの内部エンドポイントを使用する前に、Alibaba Cloud アカウントを使用して クラウドリソースアクセス権限付与ページ にアクセスし、AliyunCIPScanOSSRole ロールを付与する必要があります。 | |
ossObjectName | String | 2022023/04/24/test.jpg | 権限を付与された OSS バケット内のファイルの名前。 説明 1. OSS から元のファイル名を渡します。イメージ処理パラメーターを追加することはできません。イメージ処理パラメーターを追加するには、imageUrl アドレスを使用します。 2. ファイル名に中国語の文字やスペースが含まれている場合は、そのまま渡します。URL エンコードする必要はありません。 | |
ossRegionId | String | cn-beijing | OSS バケットが配置されているリージョン。 | |
dataId | String | いいえ | img123**** | モデレーション対象のオブジェクトのデータ ID。 大文字と小文字の英字、数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) で構成できます。最大 64 文字の長さで、ビジネスデータを一意に識別するために使用できます。 |
referer | String | いいえ | www.aliyun.com | ホットリンク保護などのシナリオで使用される referer リクエストヘッダー。長さは 256 文字を超えることはできません。 |
infoType | String | はい | customImage,textInImage | 取得する補助情報。有効な値:
複数の値をコンマで区切って指定できます。たとえば、"customImage,textInImage" は、カスタムイメージライブラリのヒットに関する情報と画像内のテキストの両方が返されることを示します。 説明 著名人の情報とロゴの情報は、高度な画像モデレーションサービスで返すことができます。詳細については、「サービスの説明」をご参照ください。 |
応答データ
名前 | タイプ | 例 | 説明 |
RequestId | String | 70ED13B0-BC22-576D-9CCF-1CC12FEAC477 | このリクエストの ID。Alibaba Cloud は、トラブルシューティングや問題追跡に使用できる各リクエストに一意の ID を生成します。 |
Data | Object | 画像モデレーションの結果。 詳細については、「Data」をご参照ください。 | |
Code | Integer | 200 | 返された HTTP ステータスコード。 詳細については、「レスポンスコード」をご参照ください。 |
Msg | String | OK | このリクエストの応答メッセージ。 |
表 2. Data
名前 | タイプ | 例 | 説明 |
Result | Array | 画像モデレーションのパラメーター結果 (脅威ラベルや信頼度スコアなど)。詳細については、「result」をご参照ください。 | |
RiskLevel | String | high | 画像の危険度レベル。最も危険度の高いラベルに基づいて返されます。有効な値:
説明 危険度の高いコンテンツには直ちに対応し、中程度の危険度のコンテンツは手動でレビューすることをお勧めします。危険度の低いコンテンツについては、高い再現率が要求される場合にのみ処理してください。それ以外の場合は、危険度が検出されなかったコンテンツと同じように扱うことができます。コンテンツモデレーションコンソールで危険度スコアを設定できます。 |
DataId | String | img123****** | モデレーションされたオブジェクトのデータ ID。 説明 リクエストで dataId を渡した場合、対応する dataId がここに返されます。 |
Ext | Object | 画像の補助参照情報。詳細については、「補助情報」をご参照ください。 |
表 3. 結果
名前 | タイプ | 例 | 説明 |
Label | String | violent_explosion | 画像コンテンツモデレーション後に返されるラベル。1 つの画像に対して複数のラベルとスコアが返される場合があります。サポートされているラベルについては、以下をご参照ください: |
Confidence | Float | 81.22 | 信頼度スコア。有効な値: 0~100。値は小数点以下 2 桁まで正確です。一部のラベルには信頼度スコアがありません。詳細については、「危険度ラベルの説明」をご参照ください。 |
Description | String | 花火のコンテンツ | Label フィールドの説明。 重要 このフィールドは Label フィールドを説明するものであり、変更される可能性があります。結果を処理する際は、Label フィールドを処理し、このフィールドに基づいて操作を行わないことをお勧めします。 |
RiskLevel | String | high | 現在のラベルの危険度レベル。設定された高危険度および低危険度のスコアに基づいて返されます。有効な値:
|
例
リクエスト例
{
"Service": "baselineCheck_global", // モデレーションサービス
"ServiceParameters": {
"imageUrl": "https://img.alicdn.com/tfs/TB1U4r9AeH2gK0jSZJnXXaT1FXa-2880-480.png", // モデレートする画像の URL
"dataId": "img123****" // モデレートするオブジェクトの ID
}
}応答例
システムが危険なコンテンツを検出した場合、次の応答が返されます:
{ "Msg": "OK", "Code": 200, "Data": { "DataId": "img123****", "Result": [ { "Label": "pornographic_adultContent", "Confidence": 81, "Description": "Adult pornographic content" }, { "Label": "sexual_partialNudity", "Confidence": 98, "Description": "Partial nudity or sexy" }, { "Label": "violent_explosion", "Confidence": 70, "Description": "Fireworks content" }, { "Label": "violent_explosion_lib", "Confidence": 81, "Description": "Fireworks content_Hit custom library" } ], "RiskLevel": "high" }, "RequestId": "ABCD1234-1234-1234-1234-1234XYZ" }システムが危険なコンテンツを検出しなかった場合、次の応答が返されます:
{ "Msg": "OK", "Code": 200, "Data": { "DataId": "img123****", "Result": [ { "Label": "nonLabel", "Description": "No risk detected" } ], "RiskLevel": "none" }, "RequestId": "ABCD1234-1234-1234-1234-1234XYZ" }
システムが、送信した画像が設定した許可リスト内の画像と一致することを検出した場合、次の応答が返されます:
{ "Msg": "OK", "Code": 200, "Data": { "DataId": "img123****", "Result": [ { "Label": "nonLabel_lib", "Confidence": 83, "Description": "Hit allowlist" } ], "RiskLevel": "none" }, "RequestId": "ABCD1234-1234-1234-1234-1234XYZ" }
このドキュメントのリクエストと応答の例は、読みやすさのためにフォーマットされています。実際の結果は、改行やインデントでフォーマットされていません。
危険度ラベルの定義
以下に、危険度ラベルの値、それに対応するスコア範囲、およびその意味を説明します。コンソールで各危険度ラベルを有効または無効にできます。一部の危険度ラベルについては、より詳細な検出範囲を設定することもできます。詳細については、「コンソールユーザーガイド」をご参照ください。各画像サービスでサポートされているラベルを以下に示します。
シナリオ | サービスとラベル |
一般的なシナリオ | |
AIGC シナリオ |
リスクがない場合やレビュー不要のギャラリーが一致した場合に返されるラベルについては、「リスクがない場合やレビュー不要のギャラリーが一致した場合にサポートされるラベル」をご参照ください。
システムから返された危険度ラベルと信頼度スコアを一定期間保存することをお勧めします。これにより、その後のコンテンツガバナンスの参考にすることができます。危険度ラベルに基づいて、手動レビューや注釈の優先順位を設定し、階層化および分類されたコンテンツガバナンス対策を実施できます。
表 4. 汎用ベースラインチェック (baselineCheck_global) でサポートされるラベル
タグ値 | 信頼度スコア範囲 (confidence) | 中国語での意味 |
pornographic_adultContent | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に成人向けまたはポルノコンテンツが含まれている可能性があります。 |
pornographic_cartoon | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像にポルノ漫画のコンテンツが含まれている可能性があります。 |
pornographic_adultToys | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像にアダルトトイのコンテンツが含まれている可能性があります。 |
pornographic_art | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像にポルノアートワークが含まれている可能性があります。 |
pornographic_adultContent_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像内のテキストにポルノコンテンツが含まれている可能性があります。 |
pornographic_suggestive_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像内のテキストに下品なコンテンツが含まれている可能性があります。 |
pornographic_o_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像内のテキストに不適切なコンテンツが含まれている可能性があります。詳細については、「コンテンツモデレーションコンソール」をご参照ください。 |
pornographic_organs_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像内のテキストが性器を説明している可能性があります。 |
pornographic_adultToys_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像内のテキストにアダルトトイに関するコンテンツが含まれている可能性があります。 |
sexual_suggestiveContent | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に下品または性的に示唆的なコンテンツが含まれている可能性があります。 |
sexual_femaleUnderwear | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に下着または水着が含まれている可能性があります。 |
sexual_cleavage | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に女性の胸の谷間が写っている可能性があります。 |
sexual_maleTopless | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に上半身裸の男性が写っている可能性があります。 |
sexual_cartoon | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に性的に示唆的なアニメーションコンテンツが含まれている可能性があります。 |
sexual_shoulder | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に性的に示唆的な肩が写っている可能性があります。 |
sexual_femaleLeg | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に性的に示唆的な脚が写っている可能性があります。 |
sexual_pregnancy | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に妊娠写真または授乳が含まれている可能性があります。 |
sexual_feet | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に性的に示唆的な足が写っている可能性があります。 |
sexual_kiss | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像にキスが含まれている可能性があります。 |
sexual_intimacy | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に親密な行動が含まれている可能性があります。 |
sexual_intimacyCartoon | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に漫画やアニメでの親密な行動が含まれている可能性があります。 |
violent_explosion | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に煙または火に関連するコンテンツが含まれている可能性があります。詳細については、「コンテンツモデレーションコンソール」をご参照ください。 |
violent_burning | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に燃えているコンテンツが含まれている可能性があります。 |
violent_armedForces | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像にテロ組織に関連するコンテンツが含まれている疑いがあります。 |
violent_weapon | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に軍事装備が含まれている可能性があります。 |
violent_crowding | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に群衆の集まりが写っている可能性があります。 |
violent_gun | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に銃が含まれている可能性があります。 |
violent_knives | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像にナイフが含まれている可能性があります。 |
violent_horrific | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に恐ろしいコンテンツが含まれている可能性があります。 |
violent_nazi | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像にナチス関連のコンテンツが含まれている可能性があります。 |
violent_bloody | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に血まみれのコンテンツが含まれている可能性があります。 |
violent_extremistGroups_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像内のテキストに過激派グループに関するコンテンツが含まれている可能性があります。 |
violent_extremistIncident_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像内のテキストに過激派事件に関するコンテンツが含まれている可能性があります。 |
violence_weapons_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像内のテキストが銃やナイフを説明している可能性があります。 |
violent_ACU | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に戦闘服が含まれている可能性があります。 |
contraband_drug | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に薬物関連のコンテンツが含まれている可能性があります。 |
contraband_drug_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像内のテキストが違法薬物を説明している可能性があります。 |
contraband_gamble | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像にギャンブル関連のコンテンツが含まれている可能性があります。 |
contraband_gamble_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像内のテキストがギャンブルを説明している可能性があります。 |
inappropriate_smoking | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に喫煙関連のコンテンツが含まれている可能性があります。 |
inappropriate_drinking | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像にアルコール関連のコンテンツが含まれている可能性があります。 |
inappropriate_tattoo | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像にタトゥーが含まれている可能性があります。 |
inappropriate_middleFinger | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に中指を立てるジェスチャーが写っている可能性があります。 |
inappropriate_foodWasting | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に食品廃棄に関するコンテンツが含まれている可能性があります。 |
profanity_Offensive_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像内のテキストに、深刻な冒涜、言葉による攻撃、または不快なコンテンツが含まれている可能性があります。 |
profanity_Oral_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像内のテキストに口語的な冒涜が含まれている可能性があります。 |
religion_clothing | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に特別なロゴや要素が含まれている可能性があります。詳細については、「コンテンツモデレーションコンソール」をご参照ください。 |
religion_logo | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | |
religion_flag | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | |
religion_taboo1_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像内のテキストに禁止されたコンテンツが含まれている可能性があります。詳細については、「コンテンツモデレーションコンソール」をご参照ください。 |
religion_taboo2_tii | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | |
flag_country | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に旗関連のコンテンツが含まれている可能性があります。 |
political_historicalNihility | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に特定のコンテンツが含まれている可能性があります。詳細については、「コンテンツモデレーションコンソール」をご参照ください。 |
political_historicalNihility_tii | スコアは 0 から 100 のスケールです。スコアが高いほど信頼度が高いことを示します。 | |
political_politicalFigure_1 | スコアは 0 から 100 の範囲で、スコアが高いほど信頼度が高いことを示します。 | |
political_politicalFigure_2 | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | |
political_politicalFigure_3 | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | |
political_politicalFigure_4 | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | |
political_politicalFigure_name_tii | スコアは 0 から 100 のスケールで、スコアが高いほど信頼度が高いことを示します。 | |
political_prohibitedPerson_1 | スコアは 0 から 100 の範囲で、スコアが高いほど信頼度が高いことを示します。 | |
political_prohibitedPerson_2 | スコアは 0 から 100 のスケールです。スコアが高いほど信頼度が高いことを示します。 | |
political_prohibitedPerson_tii | スコアは 0 から 100 の範囲で、スコアが高いほど信頼度が高いことを示します。 | |
political_taintedCelebrity | スコアは 0 から 100 の範囲で、スコアが高いほど信頼度が高いことを示します。 | |
political_taintedCelebrity_tii | スコアは 0 から 100 の範囲です。スコアが高いほど信頼度が高いことを示します。 | |
political_CNFlag | スコアは 0 から 100 の範囲で、スコアが高いほど信頼度が高いことを示します。 | |
political_CNMap | スコアは 0 から 100 の範囲です。スコアが高いほど信頼度が高いことを示します。 | |
political_logo | スコアは 0 から 100 の範囲で、スコアが高いほど信頼度が高いことを示します。 | |
political_outfit | スコアは 0 から 100 の範囲で、スコアが高いほど信頼度が高いことを示します。 | |
political_badge | スコアは 0 から 100 の範囲で、スコアが高いほど信頼度が高いことを示します。 | |
pt_logo | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像にロゴが含まれている可能性があります。 |
QRCode | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | 画像に QR コードが含まれている可能性があります。 |
pt_custom_01 | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | カスタムラベル 01。 |
pt_custom_02 | 0 から 100。スコアが高いほど信頼度が高いことを示します。 | カスタムラベル 02。 |
tii は「text in image」の略です。`tii` で終わるラベルは、イメージ内でテキスト違反が検出されたことを示します。
さらに、上記の各リスクラベルに対してカスタムイメージライブラリを設定できます。 審査対象のイメージとカスタムライブラリ内のイメージの類似性が高い場合、システムは対応するリスクラベルを返します。 これらを区別するために、ラベルの値は OriginalRiskLabel_lib というフォーマットになります。 例えば、"violent_explosion" に対してカスタムイメージライブラリを設定し、審査対象のイメージがそのライブラリ内のいずれかのイメージと高い類似性で一致した場合、システムは violent_explosion_lib を label パラメーターに返します。 対応する confidence パラメーターは、類似度をスコアとして表します。
送信されたイメージにシステムが異常を検出しなかった場合、または設定した許可リスト内のイメージと高い類似性がある場合、返されるラベルと信頼度スコアは次の表のとおりです。
ラベル (label) | 信頼度スコアの範囲 (confidence) | 中国語での意味 |
nonLabel | このフィールドは存在しません。 | このイメージではリスクは検出されませんでした。または、すべてのモデレーション項目を無効にしています。 詳細については、「コンテンツモデレーションコンソール」をご参照ください。 |
nonLabel_lib | 0 から 100。 スコアが高いほど、信頼度レベルが高いことを示します。 | このイメージは、設定された許可リスト内のイメージと高い類似性があります。 詳細については、「コンテンツモデレーションコンソール」をご参照ください。 |
コードの説明
以下に、API によって返されるコードの意味を説明します。HTTP ステータスコードが 200 のリクエストに対してのみ課金されます。他のエラーコードを返すリクエストは課金されません。
コード | 説明 |
200 | リクエストは成功しました。 |
400 | リクエストパラメーターが空です。 |
401 | リクエストパラメーターが無効です。 |
402 | リクエストパラメーターの長さが API の要件を満たしていません。確認して変更してください。 |
403 | リクエストが QPS 制限を超えています。同時実行数を確認して調整してください。 |
404 | 渡されたイメージのダウンロード中にエラーが発生しました。確認するか、リトライしてください。 |
405 | 渡されたイメージのダウンロードがタイムアウトしました。これは、イメージにアクセスできないことが原因である可能性があります。確認、調整、リトライしてください。 |
406 | 渡されたイメージが大きすぎます。イメージサイズを確認して調整してから、リトライしてください。 |
407 | 渡されたイメージのフォーマットはサポートされていません。確認して調整してから、リトライしてください。 |
408 | アカウントには、この API を呼び出す権限がありません。これは、アカウントが有効化されていない、支払いの遅延がある、または呼び出し元のアカウントが承認されていないことが原因である可能性があります。 |
500 | システム例外が発生しました。 |