すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Media Processing:SubmitMediaCensorJob

    ドキュメントセンター

    ApsaraVideo Media Processing:SubmitMediaCensorJob

    最終更新日:Apr 07, 2026

    メディア審査ジョブを送信します。

    操作説明

    • これは非同期 API です。ジョブを送信すると、システムはジョブ ID を返し、非同期処理のためにキューに入れます。最終結果はコールバック通知によって配信されます。また、メディア審査ジョブのクエリ 操作を呼び出してジョブステータスを確認することもできます。

    • メディア審査は、中国 (北京)、中国 (上海)、およびアジアパシフィック SE 1 (シンガポール) リージョンで利用できます。この機能は他のリージョンではサポートされていません。

    QPS 制限

    この API の 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

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Input

    string

    任意

    審査するメディアファイルの OSS URL。動画ファイルと音声ファイルがサポートされています。URL は、MPS コンソール の [メディア管理] > [メディアリスト] から取得できます。画像ファイルを審査するには、`CoverImage` パラメーターを使用します。このパラメーターは JSON オブジェクトとして指定します。詳細については、「入力詳細」をご参照ください。

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

    • Location：OSS リージョン。ご利用の MPS サービスのリージョンと一致させる必要があります。

    • Object：スキャンする OSS オブジェクト。

      説明

      オブジェクト名はスラッシュ (/) で始めることはできません。そうでない場合、API 呼び出しは失敗します。

    {"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"}
    CoverImages

    string

    任意

    カバー画像の OSS URL。URL は、MPS コンソール の [メディア管理] > [メディアリスト] から取得できます。最大 5 つのカバー画像を指定できます。URL は JSON 配列として指定します。

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

    • Location：OSS リージョン。ご利用の MPS サービスのリージョンと一致させる必要があります。

    • Object：スキャンする OSS オブジェクト。

      説明

      オブジェクト名はスラッシュ (/) で始めることはできません。そうでない場合、API 呼び出しは失敗します。

    [{"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.jpeg"}]
    Title

    string

    任意

    動画のタイトル。最大長は 64 バイトです。

    Hello World
    Description

    string

    任意

    動画の説明。最大長は 128 バイトです。

    example description
    Barrages

    string

    任意

    弾幕コメント。文字列として指定します。

    hello world
    PipelineId

    string

    任意

    メッセージ通知に使用されるパイプラインの ID。ID は、MPS コンソール の [グローバル設定] > [パイプライン] から取得できます。このパラメーターを指定しない場合、デフォルトのパイプラインが使用されます。デフォルトのパイプラインの同時実行数は 10 です。同時実行数を増やすには、してください。

    説明

    現在、パイプラインはバックエンドでのみ作成できます。パイプラインのクエリと更新については、「パイプラインの更新」をご参照ください。

    b22c173cced04565b1f38f1ecc39****
    VideoCensorConfig

    string

    必須

    動画審査設定と出力スナップショットの OSS URL。URL は、MPS コンソール の [メディア管理] > [メディアリスト] から取得できます。

    このパラメーターは JSON オブジェクトです。

    • OutputFile：

      • Bucket：出力 OSS バケット名。

      • Location：OSS リージョン。MPS サービスが存在するリージョンと同じである必要があります。

      • Object：出力用の OSS オブジェクト。`{Count}` プレースホルダーは、スナップショットのシーケンス番号に置き換えられます。

      詳細な審査結果は、OutputFile と同じディレクトリにある `{jobId}.output` という名前のファイルに保存されます。出力ファイルのフィールドについては、「メディア審査結果ファイルのフィールド」をご参照ください。

    • StoreVideoTimeline：`{jobId}.video_timeline` ファイルを生成して OSS に保存するかどうかを指定します。値を `true` に設定するとファイルが生成されます。値を `false` に設定するか、パラメーターを省略した場合、システムはファイルを生成しません。ファイル形式の詳細については、「メディアジョブのクエリ (videoTimeline の例)」をご参照ください。

    • SaveType：出力モード。`abnormal` は問題のあるコンテンツのスナップショットのみを保存します。`all` はすべてのスナップショットを保存します。

    • Biztype：審査テンプレート。デフォルト値は `common` です。カスタム審査テンプレートを使用するには、チケットを送信する必要があります。カスタムテンプレートが設定されたら、このパラメーターをユーザー ID (UID) に設定します。

    • Scene：検出シーン。1 つ以上のシーンを選択できます。このパラメーターを指定しない場合、システムはデフォルトで `porn` と `terrorism` シーンになります。有効なシーンは次のとおりです。

      • `porn`：ポルノコンテンツ

      • `terrorism`：テロコンテンツ

      • `ad`：テキスト・画像のポリシー違反

      • `live`：不適切なシーン

      • `logo`：ロゴ

      • `audio`：音声アンチスパム

    説明

    オーディオトラックを持つ入力ファイルの場合、`audio` シーンは音声審査を実行します。オーディオトラックを持たない入力ファイルには `audio` シーンを指定しないでください。

    {"Scenes" : ["porn"], "OutputFile":{"Bucket": "example-001","Location": "oss-cn-hangzhou","Object": "test/example-{Count}.jpg"},"SaveType" : "abnormal","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。後続の API 呼び出しのためにこの ID を保存してください。

    88c6ca184c0e47098a5b665e2****

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

    パラメータータイプ説明
    TypeStringメッセージのタイプ。値： MediaCensor。
    MediaCensorJobNotifyAliyunMediaCensorJobNotifyメディア審査ジョブの通知オブジェクト。
    UserDataStringカスタムユーザーデータ。

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

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

    変更履歴

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