すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Media Processing:SubmitIProductionJob

    ドキュメントセンター

    ApsaraVideo Media Processing:SubmitIProductionJob

    最終更新日:Aug 27, 2026

    インテリジェントプロダクションタスクを送信します。

    操作説明

    この操作を呼び出して送信されたタスクは、非同期モードで実行されます。タスクは MPS キューに追加され、スケジューリングおよび実行が行われます。 QueryIProductionJob 操作を呼び出してタスクの実行結果をクエリするか、非同期メッセージ通知メカニズムを使用して結果を取得できます。

    QPS 制限

    この操作は、アカウントあたり毎秒最大 100 回呼び出すことができます。毎秒の呼び出し回数が制限を超えると、速度制限がトリガーされます。これにより、ビジネスに影響が生じる可能性があります。詳細については、「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:SubmitIProductionJob

    *すべてのリソース。

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    FunctionName

    string

    必須

    アルゴリズムの名前。各アルゴリズムでサポートされるリージョンについては、「リージョン」をご参照ください。有効な値:

    • VideoH2V: 動画のインテリジェント横型から縦型への変換

    • VideoDelogo: 動画のロゴ除去

    • Cover: インテリジェントカバー

    • VideoClip: ビデオシノプシス

    • ImageH2V: 画像のインテリジェント横型から縦型への変換

    • ImageDelogo: 画像のロゴ除去

    • CaptionExtraction: 字幕抽出 (アルゴリズムは処理対象の動画の URL を入力として受け取り、抽出された字幕ファイルを出力します)

    • VideoDetext: 動画の字幕除去

    • VideoGreenScreenMatting: イメージマッティング (アルゴリズムはマッティング対象の動画の URL と差し替え用バックグラウンド画像の URL を入力として受け取り、合成動画を出力します)

    • MusicSegmentDetect: サビ検出 (処理対象の音声または動画の URL を入力として受け取り、検出された各サビセグメントの開始時間と終了時間を出力します。サビが検出されない場合は、空の結果が返されます)

    • AudioMixing: オーディオミキシング

    • AudioBeatDetection: ビート検出 (処理対象の音声または動画の URL を入力として受け取り、検出されたビート時間リスト BeatList およびダウンビート時間リスト DownBeatList を出力します)

    • ImageCartoonize: 3D スタイルおよび顔のスタイル化 (顔のスタイル化特徴を使用するには、DingTalk アカウント yuanzhigao1209 に連絡先までお問い合わせください)

    • AudioQualityAssessment: 音声品質評価

    • FaceBeauty: 動画の顔美化

    • SpeechDenoise: インテリジェントノイズリダクション

      説明

      音声品質評価は、16 ビット量子化 WAV 音声ファイル、モノラルまたはステレオチャンネル、8000 Hz から 48000 Hz のサンプリングレートをサポートしています。

    ImageCartoonize
    ModelId

    string

    任意

    アルゴリズムモデル ID。このパラメーターが空の場合、対応するアルゴリズムのデフォルトモデルが使用されます。通常は、このパラメーターを空にしてデフォルトモデルを使用してください。

    null
    JobParams

    string

    任意

    アルゴリズムタスクのパラメーター。これは JSON フォーマットのオブジェクトであり、内容はアルゴリズムによって異なります。詳細については、「インテリジェントプロダクション操作パラメーターの補足説明」をご参照ください。

    {"Model":"gif"}
    ScheduleParams

    string

    任意

    タスクのスケジューリングを設定するためのジョブスケジューリングパラメーター。このパラメーターはオプションです。不要な場合は空のままにしてください。

    null
    NotifyUrl

    string

    任意

    コールバック URL。現在、MNS メッセージキューのみがサポートされています。メッセージキューのパスは、MNS コンソール > キューリスト > ビュー で確認できます。

    mns://125340688170****.mns.cn-beijing.aliyuncs.com/queues/example-pipeline
    UserData

    string

    任意

    コールバック URL へのコールバックメッセージで返されるカスタムビジネスデータ。このパラメーターはオプションです。不要な場合は空のままにしてください。

    {\"key\":\"value\"}
    PipelineId

    string

    任意

    MPS キューの ID。ID は MPS コンソール > グローバル設定項目 > MPS キュー から取得できます。このパラメーターは、タスクのコールバックキューを決定し、テナント分離を提供するために使用されます。このパラメーターが指定されていない場合、デフォルトの MPS キューが使用されます。デフォルトキューは最大値 10 の同時タスクをサポートしますが、メッセージ通知にはバインドされていません。

    39f8e0bc005e4f309379701645f4****
    Input

    string

    任意

    入力ファイルの OSS バケット。現在、OSS パスのみがサポートされており、OSS バケットのリージョンは現在の MPS サービスのリージョンと同じである必要があります。パスは MPS コンソール > メディア管理 > メディア ライブラリ から取得するか、OSS コンソールで対応するバケットを選択して取得できます。

    説明

    アルゴリズムによっては、特定のシナリオで Input が必須となる場合があります。ビジネス要件に応じてこのパラメーターを指定してください。

    oss://example-****.oss-cn-shanghai.aliyuncs.com/example.mp4
    Output

    string

    任意

    出力ファイルの OSS バケット。現在、OSS パスのみがサポートされています。パスは MPS コンソール > メディア管理 > メディア ライブラリ から取得するか、OSS コンソールで対応するバケットを選択して取得できます。OSS バケットのリージョンは、現在の MPS サービスのリージョンと同じである必要があります。

    説明

    フォーマットは oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt です。ここで {source}、{timestamp}、{sequenceId} はプレースホルダーであり、それぞれ入力ファイル名、UNIX タイムスタンプ、シーケンス番号が入力されます。プレースホルダーは必須ではありません。ただし、インテリジェントカバーのように複数の出力を生成するアルゴリズムの場合は、一意の出力ファイルパスを保証するためにシーケンス番号のプレースホルダーを含めてください。ファイル拡張子はユーザー定義です。

    oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答パラメーター。

    RequestId

    string

    リクエスト ID。

    5210DBB0-E327-4D45-ADBC-0B83C8796E26
    JobId

    string

    タスク ID。他の操作を呼び出す際に使用できるよう、この ID を保存してください。

    39f8e0bc005e4f309379701645f4****
    Result

    string

    返される結果。結果はアルゴリズムによって異なります。詳細については、「インテリジェントプロダクション操作パラメーターの補足説明」をご参照ください。

    { "Code":"Success", "Details":[], "FunctionName":"ImageCartoonize", "JobId":"39f8e0bc005e4f309379701645f4****", "Message":"success", "State":"Success", "Type":"IProduction" }

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "5210DBB0-E327-4D45-ADBC-0B83C8796E26",
  "JobId": "39f8e0bc005e4f309379701645f4****",
  "Result": "{ \"Code\":\"Success\", \"Details\":[], \"FunctionName\":\"ImageCartoonize\", \"JobId\":\"39f8e0bc005e4f309379701645f4****\", \"Message\":\"success\", \"State\":\"Success\", \"Type\":\"IProduction\" }"
}

    エラーコード

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

    変更履歴

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