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

Intelligent Media Services:QueryIProductionJob

最終更新日:Apr 02, 2026

QueryIProductionJob を呼び出して、インテリジェント制作ジョブのステータスおよび実行結果を取得します。

今すぐお試しください

この 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:QueryIProductionJob

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ClientToken

string

任意

リクエストのべき等性を保証するためのトークンです。

JobId

string

必須

インテリジェントジョブの ID です。

****20b48fb04483915d4f2cd8ac****

レスポンスフィールド

フィールド

説明

object

応答スキーマです。

RequestId

string

リクエスト ID です。

JobId

string

ジョブ ID です。

****20b48fb04483915d4f2cd8ac****

Name

string

ジョブ名です。

测试任务

FunctionName

string

使用するアルゴリズムの名称です。有効な値は以下のとおりです。

  • Cover:スマートカバー

  • VideoClip:動画要約

  • VideoDelogo:動画ロゴ除去

  • VideoDetext:動画テキスト除去

  • CaptionExtraction:字幕抽出

  • VideoGreenScreenMatting:グリーンバックマッティング

  • FaceBeauty:動画美肌処理

  • VideoH2V:横長動画から縦長動画への変換

  • MusicSegmentDetect:サビ検出

  • AudioBeatDetection:ビート検出

  • AudioQualityAssessment:音声品質評価

  • SpeechDenoise:音声ノイズ除去

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

  • MusicDemix:音楽音源分離

Cover

Input

object

入力メディアです。

Type

string

入力タイプです。有効な値は以下のとおりです。

  1. OSS:OSS ファイルの URL。

  2. Media:メディアアセットの ID。

OSS

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 はファイルパスです。

oss://bucket/object

Output

object

出力メディアです。

Type

string

メディアタイプです。有効な値は以下のとおりです。

  • OSS:OSS ファイルの URL。

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

OSS

Biz

string

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

列挙値:

  • VOD :

    VOD

  • IMS :

    IMS

IMS

Media

string

出力先です。TypeOSS の場合、このパラメーターには OSS ファイルの URL が返されます。TypeMedia の場合、指定したメディアアセット ID または新しく生成されたメディアアセット ID が返されます。

有効な OSS URL 形式は以下のとおりです。

  1. oss://bucket/object

  2. http(s)://bucket.oss-[RegionId].aliyuncs.com/objectこの形式では、bucket は現在のプロジェクトと同じリージョンにある OSS バケットの名前、object はファイルパスです。

oss://bucket/object

OutputUrl

string

出力ファイルの OSS URL です。TypeMedia の場合にのみ返されます。

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

TemplateId

string

テンプレート ID です。

****96e8864746a0b6f3****

JobParams

string

アルゴリズムジョブのパラメーターを含む JSON オブジェクトです。具体的なパラメーターは選択したアルゴリズムによって異なります。

{"Model":"gif"}

ScheduleConfig

object

ジョブの構成です。

PipelineId

string

パイプライン ID です。

a54fdc9c9aab413caef0d1150f565e86

Priority

integer

パイプライン内におけるジョブの優先度です。

  • 数値が大きいほど優先度が高くなります。最高優先度は 10 です。

  • デフォルト値:6

6

UserData

string

ユーザー定義データです。システムはこの値をそのまま返します。

{"test":1}

Result

string

アルゴリズムの出力結果で、JSON 文字列として返されます。FunctionName に応じて出力構造が異なります。詳細については、以下の補足情報をご参照ください。

{}

CreateTime

string

ジョブが作成された時刻(UTC)です。

2022-07-07T07:16:11Z

FinishTime

string

ジョブが完了した時刻(UTC)です。

2021-11-26T14:50:25Z

Status

string

ジョブのステータスです。有効な値は以下のとおりです。

  • Queuing:ジョブが処理待ちの状態です。

  • Analyzing:ジョブが処理中の状態です。

  • Fail:ジョブの実行に失敗しました。

  • Success:ジョブが正常に完了しました。

Success

OutputFiles

array

出力ファイルのパスの配列です。

string

生成されたファイルのパスおよびファイル名です。

output/xxx.mp4

OutputMediaIds

array

string

OutputUrls

array

出力ファイルの URL の配列です。

string

生成されたファイルへのアクセス可能な URL です。

http://xxx

応答例

Cover

例:[{"Score":8.270855992569906,"Time":"28278.25","Url":"cover/test-00001.jpg"},{"Score":7.474117489692728,"Time":"25942.583333333332","Url":"cover/test-00002.jpg"}]

Score は信頼度、Time はタイムスタンプ、Url はファイルパスです。

VideoClip

例:{"VideoSummaryList":[{"EndTime":"5.28","StartTime":"0.28"}]}

VideoSummaryList は、ソース動画から切り取られた時間範囲のリストで、単位は秒です。

VideoDelogo

例:{}

出力には追加情報は含まれません。

VideoDetext

例:{}

出力には追加情報は含まれません。

CaptionExtraction

例:{}

出力には追加情報は含まれません。

VideoGreenScreenMatting

例:{}

出力には追加情報は含まれません。

FaceBeauty

例:{}

出力には追加情報は含まれません。

VideoH2V

例:{}

出力には追加情報は含まれません。

MusicSegmentDetect

例:[{"start":39.32,"end":63.85,"title":"Chorus"},{"start":86.69,"end":114.45,"title":"Chorus"},{"start":135.75,"end":160.27,"title":"Chorus"}]

AudioBeatDetection

例:{}

出力には追加情報は含まれません。

AudioQualityAssessment

例: [{ "Discontinuity":"Good", "Loudness":"Excellent", "Worst MOS(0-5)":"0.38", "Discontinuity(0-5)":"3.52", "Speech Ratio":"48.55", "Loudness(0-5)":"4.91", "Worst Discontinuity(0-5)":"0.88", "Worst Coloration(0-5)":"0.42", "Channel":"1", "Coloration(0-5)":"0.99", "Bad Mute Ratio(%)":"0.0", "Time":"2022-12-02 16:14:06", "Noisiness(0-5)":"3.28", "MOS":"Poor", "Worst Noisiness(0-5)":"0.91", "Double Talk Ratio(%)":"19.23", "Input":"/home/admin/algo/quality****/example.wav", "Total Duration":"42.78", "Noisiness":"Good", "Tag":"Valid", "MOS(0-5)":"1.01", "Loudness(-90dB-0dB)":"-0.59", "Coloration":"Bad", "Saturated Ratio(%)":"37.55" }, { "Discontinuity":"Fair", "Loudness":"Excellent", "Worst MOS(0-5)":"0.65", "Discontinuity(0-5)":"2.45", "Speech Ratio":"41.68", "Loudness(0-5)":"4.52", "Worst Discontinuity(0-5)":"0.66", "Worst Coloration(0-5)":"0.72", "Channel":"2", "Coloration(0-5)":"2.34", "Bad Mute Ratio(%)":"0.0", "Time":"2022-12-02 16:14:06", "Noisiness(0-5)":"2.53", "MOS":"Poor", "Worst Noisiness(0-5)":"0.67", "Double Talk Ratio(%)":"25.93", "Input":"/home/admin/algo/quality****/example.wav", "Total Duration":"42.78", "Noisiness":"Fair", "Tag":"Valid", "MOS(0-5)":"1.69", "Loudness(-90dB-0dB)":"-4.82", "Coloration":"Fair", "Saturated Ratio(%)":"0.0" }]

パラメーターの説明

SpeechDenoise

例:{}

出力には追加情報は含まれません。

AudioMixing

例:{}

出力には追加情報は含まれません。

MusicDemix

例:{}

出力には追加情報は含まれません。

成功レスポンス

JSONJSON

{
  "RequestId": "",
  "JobId": "****20b48fb04483915d4f2cd8ac****",
  "Name": "测试任务",
  "FunctionName": "Cover",
  "Input": {
    "Type": "OSS",
    "Media": "oss://bucket/object"
  },
  "Output": {
    "Type": "OSS",
    "Biz": "IMS",
    "Media": "oss://bucket/object",
    "OutputUrl": "http(s)://bucket.oss-[RegionId].aliyuncs.com/object "
  },
  "TemplateId": "****96e8864746a0b6f3****",
  "JobParams": "{\"Model\":\"gif\"}",
  "ScheduleConfig": {
    "PipelineId": "a54fdc9c9aab413caef0d1150f565e86",
    "Priority": 6
  },
  "UserData": "{\"test\":1}",
  "Result": "{}",
  "CreateTime": "2022-07-07T07:16:11Z",
  "FinishTime": "2021-11-26T14:50:25Z",
  "Status": "Success",
  "OutputFiles": [
    "output/xxx.mp4"
  ],
  "OutputMediaIds": [
    ""
  ],
  "OutputUrls": [
    "http://xxx"
  ]
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 IdempotentParameterMismatch The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

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

変更履歴

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