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

Content Moderation:CreateKeywordLib

最終更新日:Jan 08, 2025

カスタムテキストライブラリを作成します。テキストライブラリは、テキストのスパム対策に使用できます。 APIオペレーションを呼び出してカスタムテキストライブラリを管理する効果は、Alibaba Cloudコンテンツモデレーションコンソールでカスタムテキストライブラリを管理する効果と同じです。

説明

操作: CreateKeywordLib

このオペレーションを呼び出して、テキストライブラリを作成できます。 HTTPリクエストを構成する方法の詳細については、リクエスト構造をご参照ください。既存のHTTPリクエストを選択することもできます。詳細については、SDKの概要をご参照ください。

テキストライブラリは、次のモデレーションシナリオに適用できます。
  • テキストスパム対策: テキスト違反を検出します。
  • 広告違反検出: 画像内の広告または違法なテキストを検出します。
  • 音声スパム対策: 音声違反を検出します。

Alibaba Cloud Content Moderationコンソールでテキストライブラリを作成することもできます。詳細については、カスタムテキストライブラリの管理をご参照ください。

課金: この操作は無料です。

QPS制限

この操作は、アカウントごとに1秒あたり最大10回呼び出すことができます。 1秒あたりの呼び出し数が制限を超えると、スロットリングがトリガーされます。その結果、ビジネスに影響が及ぶ可能性があります。 この操作を呼び出すときは、制限に注意することをお勧めします。

リクエストパラメータ

すべてのContent Moderation APIリクエストに含める必要がある共通リクエストパラメータの詳細については、共通パラメータをご参照ください。

次の表は、リクエストボディのパラメータについて説明しています。
パラメータタイプ必須説明
ServiceModuleStringはいopen_api

サービスモジュールの名前。値を open_api に設定します。

NameStringはいtest1sdkdkテキストライブラリの名前。
ResourceTypeStringはいTEXTテキストライブラリが適用されるモデレーションシナリオ。有効な値:
  • TEXT: テキストスパム対策
  • IMAGE: 広告違反検出
  • VOICE: 音声スパム対策
BizTypesStringArrayいいえ["bizTypeA","bizTypeB"]ビジネスシナリオ。詳細については、CreateBizTypeをご参照ください。
CategoryStringはいBLACKテキストライブラリのカテゴリ。有効な値:
  • BLACK: ブラックリスト
  • WHITE: ホワイトリスト
  • REVIEW: レビューリスト
LibTypeStringはいtextKeyword各モデレーションシナリオでのテキストライブラリのカテゴリ。有効な値:
  • テキストスパム対策
    • textKeyword: テキスト内の用語が照合されるテキストライブラリ。
    • similarText: テキストパターンが照合されるテキストライブラリ。
  • 広告違反検出

    textKeyword: 画像から抽出された用語が照合されるテキストライブラリ。

  • 音声スパム対策

    voiceText: 音声から変換された用語が照合されるテキストライブラリ。

MatchModeStringいいえfuzzy照合方法。有効な値:
  • fuzzy:あいまい一致
  • precise:完全一致
EnableBooleanいいえtrueテキストライブラリを有効にするかどうかを指定します。
  • true: テキストライブラリを有効にします。これはデフォルト値です。
  • false: テキストライブラリを無効にします。

レスポンスパラメータ

この操作が返す共通レスポンスパラメータの詳細については、共通レスポンスパラメータをご参照ください。
パラメータタイプ説明
codeInteger200

返された HTTP ステータスコード。

詳細については、共通エラーコードをご参照ください。

msgStringOKリクエストに対して返されるメッセージ。
requestIdString795D8871-4889-4C0F-A8B1-C7D2B990FF61リクエストの一意の ID。問題の特定に使用できます。
idString123テキストライブラリの一意の ID。テキストライブラリで後続の操作を実行するために使用できます。

リクエストの例
http(s)://green.cn-shanghai.aliyuncs.com/?
Action=CreateKeywordLib&ServiceModule=open_api
&<共通リクエストパラメータ>
{
  "Name": "test1sdkdk",
  "BizTypes": [],
  "Category": "BLACK",
  "ServiceModule": "open_api",
  "ResourceType": "TEXT",
  "LibType": "textKeyword"
}
成功レスポンスの例
{
 "RequestId": "795D8871-4889-4C0F-A8B1-C7D2B990FF61",
 "code": 200,
 "Id": "123"
}