SubmitIProductionJob - インテリジェント制作ジョブの送信 - Alibaba Cloud - ApsaraVideo Media Processing

インテリジェント制作ジョブを送信します。

操作説明

この操作は、非同期実行のためにジョブを送信します。システムは各ジョブをパイプラインに追加し、スケジューリング、キューイング、および処理を行います。ジョブの結果は、QueryIProductionJob 操作を呼び出すか、非同期のメッセージ通知によって取得できます。

QPS 制限

この操作の QPS 制限は、ユーザーごとに 1 秒あたり 100 クエリ (QPS) です。この制限を超えると、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:SubmitIProductionJob

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
FunctionName	string	必須	関数の名前。各関数をサポートするリージョンについては、「サービスリージョン」をご参照ください。有効な値： VideoH2V：横向き動画を縦向き動画に変換します。 VideoDelogo：動画からウォーターマークまたはロゴを削除します。 Cover：インテリジェントカバーを生成します。 VideoClip：動画概要を生成します。 ImageH2V：横向き画像を縦向き画像に変換します。 ImageDelogo：画像からウォーターマークまたはロゴを削除します。 CaptionExtraction：字幕抽出を実行します。アルゴリズムは入力動画から字幕を抽出し、字幕ファイルを返します。 VideoDetext：動画からハードコーディングされた字幕を削除します。 VideoGreenScreenMatting：グリーンバック合成を実行します。アルゴリズムは、入力されたグリーンバック動画を背景画像と合成し、結果の動画を返します。 MusicSegmentDetect：サビ検出を実行します。アルゴリズムは、入力されたオーディオまたは動画ファイル内のサビ区間を検出し、その開始時間と終了時間を返します。サビが検出されない場合、結果は空になります。 AudioMixing：オーディオミキシングを実行します。 AudioBeatDetection：ビート検出を実行します。アルゴリズムは、オーディオまたは動画ファイルの URL を入力として受け取り、ビートのタイムスタンプのリスト (BeatList) とダウンビートのタイムスタンプのリスト (DownBeatList) を出力します。 ImageCartoonize：顔に 3D またはスタイル化エフェクトを適用します。顔のスタイル化機能を使用するには、DingTalk (yuanzhigao1209) でお問い合わせください。 AudioQualityAssessment：オーディオ品質を評価します。 FaceBeauty：動画内の顔に美顔フィルターを適用します。 SpeechDenoise：インテリジェントノイズ低減を実行します。説明オーディオ品質評価の場合、入力オーディオは 16 ビット量子化された WAV ファイルである必要があります。モノラルおよびステレオチャンネルの両方がサポートされています。サポートされているサンプリングレートの範囲は 8,000 Hz から 48,000 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	任意	サービスがコールバック通知で返すオプションのカスタムデータ。	{\"key\":\"value\"}
PipelineId	string	任意	ジョブパイプラインの ID。パイプライン ID は、MPS コンソールで [グローバル設定] > [パイプライン] に移動して取得できます。この ID は、ジョブのコールバックキューを決定し、テナント隔離を提供します。このパラメーターを指定しない場合、デフォルトのパイプラインが使用されます。デフォルトのパイプラインは、同時実行数が 10 で、通知用のメッセージキューにバインドされていません。	39f8e0bc005e4f309379701645f4****
Input	string	任意	OSS バケット内の入力ファイル。OSS パスのみがサポートされています。ファイルは、MPS サービスと同じリージョンにある OSS バケットに存在する必要があります。パスは、MPS コンソールで [メディア管理] > [メディアリスト] に移動するか、OSS コンソールで対応するバケットを選択することで取得できます。説明一部のアルゴリズムでは `Input` パラメーターが必要です。ビジネス要件に基づいてこのパラメーターを指定してください。	oss://example-****.oss-cn-shanghai.aliyuncs.com/example.mp4
Output	string	任意	OSS バケット内の出力ファイル。OSS パスのみがサポートされています。宛先の OSS バケットは、MPS サービスと同じリージョンにある必要があります。パスは、MPS コンソールで [メディア管理] > [メディアリスト] に移動するか、OSS コンソールで対応するバケットを選択することで取得できます。説明フォーマットは `oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt` です。このフォーマットでは、`{source}`、`{timestamp}`、および `{sequenceId}` はプレースホルダーです。システムはこれらを入力ファイル名、UNIX タイムスタンプ、およびシーケンス番号にそれぞれ置き換えます。プレースホルダーは必須ではありません。ただし、インテリジェントカバーなど、複数の出力を生成するアルゴリズムの場合は、各出力ファイルに一意のパスを確保するために、`{sequenceId}` のようなシーケンス番号のプレースホルダーを含める必要があります。ファイル拡張子は定義できます。	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\" }"
}

エラーコード

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

変更履歴

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