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

Intelligent Media Services:SubmitIProductionJob

最終更新日:Apr 07, 2026

SubmitIProductionJob 操作を呼び出して、インテリジェント制作ジョブを送信します。

操作説明

これは非同期 API です。タスクを送信すると、API はタスク ID を返し、タスクをキューに入れて非同期処理を行います。最終結果はコールバックを介して配信されます。QuerySmartProductionTask を呼び出してタスクのステータスをクエリすることもできます。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ice:SubmitIProductionJob

create

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

Name

string

任意

ジョブの名前。最大 100 文字です。

测试任务

FunctionName

string

必須

アルゴリズム関数の名前。有効な値:

  • Cover:スマートカバーを生成します。

  • VideoClip:ビデオ概要を作成します。

  • VideoDelogo:ビデオからロゴを削除します。

  • VideoDetext:ビデオからテキストを削除します。

  • CaptionExtraction:ビデオから字幕を抽出します。

  • VideoGreenScreenMatting:ビデオのグリーンバックキーイングを実行します。

  • FaceBeauty:ビデオ内の顔にビューティーフィルターを適用します。

  • VideoH2V:横型ビデオを縦型ビデオに変換します。

  • MusicSegmentDetect:音楽のコーラスセグメントを検出します。

  • AudioBeatDetection:オーディオトラックのビートを検出します。

  • AudioQualityAssessment:オーディオ品質を評価します。

  • SpeechDenoise:音声のノイズを低減します。

  • AudioMixing:オーディオトラックをミキシングします。

  • MusicDemix:音楽からボーカルと伴奏を分離します。

Cover

Input

object

必須

入力メディアアセット。OSS ファイルまたはメディアアセット ID を指定できます。

入力ファイルの要件はアルゴリズム関数によって異なります。詳細については、補足説明をご参照ください。

Type

string

必須

入力メディアのタイプ。有効な値:

  • OSS:OSS ファイルパス。

  • Media:メディアアセット ID。

OSS

Media

string

必須

入力ファイルの OSS URL または入力メディアアセットの ID。 OSS URL は、次のいずれかのフォーマットになります:

  1. oss://<bucket>/<object>

  2. http(s)://<bucket>.oss-<regionId>.aliyuncs.com/<object> これらのフォーマットでは、<bucket> はプロジェクトと同じリージョンにある OSS バケットの名前で、<object> はファイルパスです。

oss://bucket/object

Output

object

必須

出力先。OSS ファイルパスまたはメディアアセット ID を指定できます。

出力ファイルはアルゴリズム関数によって異なります。詳細については、補足説明をご参照ください。

Type

string

必須

出力メディアのタイプ。有効な値:

  • OSS:OSS ファイルパス。

  • Media:メディアアセット ID。

OSS

Biz

string

任意

メディアアセットが属するサービス。

IMS

Media

string

必須

出力先。TypeOSS の場合は OSS URL を指定し、TypeMedia の場合はメディアアセット ID を指定します。

OSS URL は、次のいずれかのフォーマットになります:

  1. oss://<bucket>/<object>

  2. http(s)://<bucket>.oss-<regionId>.aliyuncs.com/<object> これらのフォーマットでは、<bucket> はプロジェクトと同じリージョンにある OSS バケットの名前で、<object> はファイルパスです。

メディアアセット ID:

  • 既存のメディアアセットを使用するには、その ID を指定します。

    • Biz パラメーターは不要です。ソースメディアアセットのサービスが使用されます。

  • 新しいメディアアセットを作成するには、このフィールドを空のままにします。

    • Biz パラメーターは、アセットが IMS または VOD のどちらで作成されるかを決定します。Biz が指定されていない場合、システムはソースアセットのサービスを使用します。ソースがメディアアセットでない場合、出力はデフォルトで IMS になります。

説明

OSS ファイルパスはプレースホルダーをサポートしています。例:oss://example-****/iproduction/{source}-{timestamp}-{sequenceId}.png。次のプレースホルダーがサポートされています:

  • {source}:入力ファイルの名前。

  • {timestamp}:UNIX タイムスタンプ。

  • {sequenceId}:システムが生成したシーケンス ID。

  • {resultType}:サーバーが決定する出力ファイルのタイプ。 プレースホルダーはオプションです。ただし、Cover のように複数の出力を生成するアルゴリズムの場合は、{sequenceId} のようなプレースホルダーを含めて、一意のファイルパスを確保し、既存ファイルの上書きを防ぐことを推奨します。

oss://bucket/object

OutputUrl

string

任意

TypeMedia に設定されている場合、このパラメーターを使用して出力ファイルの OSS URL を指定できます。バケットは IMS または VOD のいずれかに登録されている必要があります。

http(s)://bucket.oss-[RegionId].aliyuncs.com/object

TemplateId

string

任意

テンプレートの ID。

****20b48fb04483915d4f2cd8ac****

JobParams

string

任意

アルゴリズムジョブのパラメーターを JSON 形式の文字列で指定します。JSON オブジェクトの内容はアルゴリズム関数によって異なります。詳細については、補足説明をご参照ください。

{"Model":"gif"}

ScheduleConfig

object

任意

ジョブスケジューリングの構成。

PipelineId

string

任意

パイプラインの ID。

5246b8d12a62433ab77845074039c3dc

Priority

integer

任意

ジョブの優先度。1 から 10 までの整数を指定できます。値が小さいほど優先度が高くなります。

6

UserData

string

任意

カスタムユーザーデータ。システムはこのデータをそのまま渡し、コールバックまたは応答で返します。長さは 256 文字を超えることはできません。

{"test":1}

ModelId

string

任意

アルゴリズムモデルの ID。このパラメーターを指定しない場合、システムは選択された関数のデフォルトモデルを使用します。特定の代替モデルを使用する必要がない限り、このパラメーターは空のままにすることを推奨します。

次の関数は代替モデルを提供します:

  • VideoDetext
    • ModelIdalgo-video-detext-new に設定すると、高度な字幕除去アルゴリズムが使用されます。このモデルは、デフォルトモデルよりも高品質な結果を提供しますが、処理速度が遅く、コストが高くなります。

入出力フィールド

Cover

ビデオファイルを入力として受け取り、複数の画像 (デフォルトでは 3 枚) を出力します。出力ファイルを区別するためにプレースホルダーを使用する必要があります。出力フォーマットは、JobParams で指定されたパラメーターに応じて、静止画像の場合は PNG、アニメーション画像の場合は GIF になります。

VideoDelogo

ビデオファイルからロゴを削除し、MP4 ビデオを出力します。

VideoDetext

ビデオファイルから字幕を削除し、MP4 ビデオを出力します。

CaptionExtraction

ビデオファイルから字幕を抽出し、SRT ファイルとして出力します。

VideoGreenScreenMatting

ビデオファイルを入力として受け取り、グリーンバックの背景を削除したビデオを出力します。出力フォーマットは、JobParams のパラメーターに応じて、MP4 または WebM になります。

FaceBeauty

ビデオファイルを入力として受け取り、顔美化効果を適用した MP4 フォーマットのビデオを出力します。

VideoH2V

ビデオファイルを入力として受け取り、横型のソースから変換された縦型の MP4 ビデオを出力します。

MusicSegmentDetect

オーディオファイルを入力として受け取り、コーラス検出結果を含む JSON ファイルを出力します。

AudioBeatDetection

オーディオファイルを入力として受け取り、ビート検出結果を含む JSON ファイルを出力します。

AudioQualityAssessment

オーディオファイルを入力として受け取ります。出力ファイルは生成されません。オーディオ品質評価の結果は、QueryIProductionJob の応答で直接返されます。

SpeechDenoise

オーディオファイルのノイズを低減し、結果を WAV ファイルとして出力します。

AudioMixing

入力オーディオファイルを JobParams で指定された追加のトラックとミキシングし、結果を WAV フォーマットで出力します。

MusicDemix

オーディオファイル (曲) をボーカル用と伴奏用の 2 つの別々のオーディオファイルに分離します。Output パスには、2 つのファイルを区別するために {resultType} プレースホルダーを含める必要があります。

JobParams の JSON フィールド

Cover

  • Model:文字列。スマートカバーモデルを指定します。空のままにすると、静止画像が生成されます。gif に設定すると、アニメーション画像が生成されます。

VideoDelogo

  • LogoModel:文字列。削除するロゴのタイプを指定します。有効な値:tv (テレビ放送のロゴ) および internet (オンラインメディアのロゴ)。複数の値をカンマで区切って指定できます。

  • Boxes:文字列。ターゲットロゴのバウンディングボックスの座標。座標は、[xmin, ymin, width, height] のフォーマットで、左上隅からの正規化された距離として指定します。最大 2 つのバウンディングボックスがサポートされています。例:"[[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]"

VideoDetext

  • LimitRegion:リスト。字幕検出の領域を指定します。座標は、[xmin, ymin, width, height] のフォーマットで、左上隅からの正規化された距離として指定します。複数の領域がサポートされています。例:[[0, 0, 0.3, 0.3], [0.7, 0, 0.3, 0.3]]注:このパラメーターを省略した場合、サービスはデフォルトでビデオの下部 30% をスキャンします。

  • Time:リスト。字幕を除去する時間範囲を秒単位で指定します。フォーマットは [start_time, end_time] です。たとえば、[5, 20] は、ビデオの 5 秒から 20 秒の間だけ字幕が除去されることを示します。
    • 単一の時間範囲を指定するには、[5, 20] のような 1 次元の配列を使用します。

    • 複数の時間範囲を指定するには、[[5, 20], [25, 43], [51, 80]] のような 2 次元の配列を使用します。このフォーマットは、modelIdalgo-video-detext-new の場合にのみサポートされます。

CaptionExtraction

  • fps:整数。(オプション) サンプリングフレームレート。有効範囲:[2, 10]。デフォルト:5

  • roi:字幕抽出の関心領域 (ROI)。この領域内の字幕のみが抽出されます。フォーマットは [[top, bottom], [left, right]] で、正規化された値を使用します。たとえば、[[0.5, 1], [0, 1]] はビデオの下半分を指定します。このパラメーターを省略した場合、サービスはデフォルトでビデオの下 4 分の 1 から字幕を抽出します。

  • lang:文字列。認識言語。有効な値:ch (中国語)、en (英語)、および ch_ml (中国語と英語の混合)。デフォルト:ch

  • track:文字列。main に設定すると、メインの字幕トラックのみが抽出されます。このパラメーターを省略した場合、デフォルトで指定された領域内のすべての字幕が抽出されます。

VideoGreenScreenMatting

  • bgimage:文字列。キーイング後にビデオにオーバーレイする背景画像の URL。例:http://example-image-****.example-location.aliyuncs.com/example/example.jpg。このパラメーターを省略した場合、サービスは alpha チャンネル付きの WebM ビデオを出力します。

FaceBeauty

  • beauty_params:文字列。顔美化機能のパラメーター。例:"whiten=20,smooth=50,face_thin=50"。詳細については、「パラメーターフィールドの説明」をご参照ください。

VideoH2V

なし

MusicSegmentDetect

なし

AudioBeatDetection

なし

AudioQualityAssessment

なし

SpeechDenoise

入力オーディオファイルは、サンプリングレートが 16 kHz または 48 kHz の WAV フォーマットである必要があります。

AudioMixing

  • inputs:ミキシングするオーディオトラックを含むリスト。注:現在、サポートされているファイルは 1 つだけです。例:{"file":"http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/2.mp4"}

MusicDemix

なし

レスポンスフィールド

フィールド

説明

object

返されるデータ。

RequestId

string

リクエストの ID。

C1849434-FC47-5DC1-92B6-F7EAAFE3851E

JobId

string

ジョブの ID。

****20b48fb04483915d4f2cd8ac****

成功レスポンス

JSONJSON

{
  "RequestId": "C1849434-FC47-5DC1-92B6-F7EAAFE3851E",
  "JobId": "****20b48fb04483915d4f2cd8ac****"
}

エラーコード

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

変更履歴

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