すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Media Processing:SubmitMediaCensorJob

    ドキュメントセンター

    ApsaraVideo Media Processing:SubmitMediaCensorJob

    最終更新日:Sep 17, 2026

    コンテンツモデレーションタスクを送信します。

    操作説明

    • これは非同期操作です。タスクを送信すると、タスク ID が返されます。このポイントではタスクはまだ完了しておらず、非同期実行のためにバックエンドキューに投入されます。最終結果はコールバック通知を通じて送信されます。 QueryMediaCensorJobDetail を呼び出して、タスクのステータスを直接クエリすることもできます。

    • コンテンツモデレーションの特徴は、現在、中国 (北京)、中国 (上海)、およびアジア太平洋東南 1 (シンガポール) のリージョンでのみ利用可能です。他のリージョンはサポートされていません。

    QPS 制限

    この操作の単一ユーザーに対する 1 秒あたりのクエリ数 (QPS) 制限は 100 です。制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。必要に応じてこの操作を呼び出してください。詳細については、「QPS 制限」を参照してください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    mts:SubmitMediaCensorJob

    none

    *すべてのリソース。

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Input

    string

    任意

    モデレーション対象のメディアファイルの OSS アドレス。ビデオファイルとオーディオファイルがサポートされています。このアドレスは、ApsaraVideo Media Processing コンソール > メディア管理 > メディア ライブラリから取得できます。イメージファイルをモデレーションするには、CoverImage パラメーターを使用します。これは JSON オブジェクトです。詳細については、「 Input 」を参照してください。

    • Bucket: 入力ファイル用の OSS バケットの名前。

    • Location: OSS リージョン。ApsaraVideo Media Processing サービスのリージョンと同じである必要があります。

    • Object: モデレーション対象の OSS オブジェクト。

      説明

      Object 値をスラッシュ (/) で始めることはできません。そうでない場合、API 呼び出しが失敗します。

    {"Bucket":"example-バケット-****","Location":"oss-cn-shanghai","Object":"example-****.flv"}
    CoverImages

    string

    任意

    カバーイメージの OSS ファイル。ファイルは、ApsaraVideo Media Processing コンソール > メディア管理 > メディア ライブラリから取得できます。カバーイメージは最大値 5 つまでサポートされています。これは JSON 配列です。

    • Bucket: 入力ファイル用の OSS バケットの名前。

    • Location: OSS リージョン。ApsaraVideo Media Processing サービスのリージョンと同じである必要があります。

    • Object: モデレーション対象の OSS オブジェクト。

      説明

      Object 値をスラッシュ (/) で始めることはできません。そうでない場合、API 呼び出しが失敗します。

    [{"Bucket":"example-バケット-****","Location":"oss-cn-shanghai","Object":"example-****.jpeg"}]
    Title

    string

    任意

    ビデオのタイトル。最大値は 64 バイトです。

    Hello World
    Description

    string

    任意

    ビデオの説明。最大値は 128 バイトです。

    example description
    Barrages

    string

    任意

    文字列。

    hello world
    PipelineId

    string

    任意

    メッセージ通知をバインドするために使用される MPS キュー ID。ID は、ApsaraVideo Media Processing コンソール > グローバル設定項目 > MPS キューから取得できます。このパラメーターを空のままにすると、デフォルトの MPS キューがタスクの実行に使用されます。デフォルトの MPS キューは 10 の同時実行数をサポートしています。同時実行数を増やすには、チケットを提出してください。

    説明

    MPS キューはバックエンドでのみ作成できます。関連するクエリおよび更新操作については、「 UpdatePipeline 」を参照してください。

    b22c173cced04565b1f38f1ecc39****
    VideoCensorConfig

    string

    必須

    ビデオモデレーション構成、およびスナップショットを出力するための OSS アドレス。アドレスは、ApsaraVideo Media Processing コンソール > メディア管理 > メディア ライブラリから取得できます。

    JSON オブジェクト。

    • OutputFile:

      • Bucket: 出力ファイル用の OSS バケットの名前。

      • Location: OSS リージョン。ApsaraVideo Media Processing サービスのリージョンと同じである必要があります。

      • Object: モデレーション対象の OSS オブジェクト。{Count} は、キャプチャされたフレームのシーケンス番号のプレースホルダーです。

      詳細なモデレーション結果は、OutputFile と同じフォルダーに {タスクID}.output という名前で保存されます。出力ファイルの特定のフィールドフォーマットについては、「コンテンツモデレーション結果ファイルのフィールド」を参照してください。

    • StoreVideoTimeline: {タスクID}.video_timeline ファイルを出力して OSS に保存するかどうかを指定します。ファイルを出力する場合は true を、出力をスキップする場合は false を設定します。このパラメーターを空のままにすると、デフォルトではファイルは出力されません。ファイル形式については、「QueryMediaCensorJobDetail (videoTimeline の例)」を参照してください。

    • SaveType: 出力モード。値を 異常 に設定して問題のあるフレームのみを出力するか、all を設定してすべてのフレームを出力します。

    • Biztype: モデレーションテンプレート。デフォルトのテンプレートは common です。このパラメーターを空のままにすると、デフォルトで common が使用されます。モデレーションテンプレートをカスタマイズするには、チケットを提出してから、このフィールドにユーザー UID を入力します。

    • Scene: 検出シナリオ。検出シナリオを選択できます。このパラメーターを空のままにすると、デフォルトでテロリズムとポルノの検出が使用されます。利用可能なシナリオ:

      • porn: ポルノの検出

      • terrorism: テロリズムの検出

      • ad: 画像およびテキストの違反検出

      • live: 望ましくないシーンの検出

      • logo: ロゴの検出

      • audio: 音声の迷惑メール検出

    説明

    オーディオトラックを含む入力ファイルの場合、audio シナリオは音声モデレーションを実行します。オーディオトラックを含まない入力ファイルに対して audio を指定しないでください。

    {"Scenes" : ["porn"], "OutputFile":{"Bucket": "example-001","Location": "oss-cn-hangzhou","Object": "test/example-{Count}.jpg"},"SaveType" : "異常","BizType":"common"}
    UserData

    string

    任意

    カスタムユーザーデータ。最大値は 128 バイトです。

    UserDatatestid-001-****
    ExternalUrl

    string

    任意

    ビデオの URL。

    http://www.example.com/video-****/test-****.mp4

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンス要素。

    RequestId

    string

    リクエスト ID。

    25818875-5F78-4A13-BEF6-D7393642CA58
    JobId

    string

    コンテンツモデレーションタスク ID。他の操作の呼び出し時に使用するために、この ID を保存してください。

    88c6ca184c0e47098a5b665e2****

    非同期通知メッセージパラメーター

    パラメータータイプ説明
    TypeStringメッセージタイプ: MediaCensor。
    MediaCensorJobNotifyAliyunMediaCensorJobNotifyコンテンツモデレーションタスク通知。
    UserDataStringカスタムユーザーデータ。

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "JobId": "88c6ca184c0e47098a5b665e2****"
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。