SubmitAIJob を呼び出してスマートタグ付けまたは動画 Fingerprinting ジョブを提出 - VOD - Alibaba Cloud - ApsaraVideo VOD

操作説明

この操作を使用する前に、ApsaraVideo VOD の課金方法と料金を完全に理解していることを確認してください。インテリジェントタグ付けおよびメディアフィンガープリントは有料の特徴です。請求明細については、「Video AI の課金」を参照してください。
メディアフィンガープリントがサポートされているリージョン: 中国 (北京)、中国 (上海)、シンガポール。インテリジェントタグ付けがサポートされているリージョン: 中国 (北京) および 中国 (上海)。
これは非同期操作です。AI タスクを送信すると、タスク ID が返されます。この時点ではタスクはまだ完了しておらず、非同期実行のためのキューに入ります。最終的な処理結果を取得するには、イベント通知の特徴を設定し、コールバックイベントを Video AI Processing Complete にセットすることを推奨します。また、 GetTaskDetail を呼び出してタスクのステータスをクエリすることもできます。
この操作を呼び出して AI タスクを送信する前に、メディアフィンガープリントまたはインテリジェントタグ付けサービスを有効化する必要があります。詳細については、「Video AI」を参照してください。
メディアフィンガープリントを初めて使用する際は、UID とリージョン情報を記載したチケットを提出し、指紋ライブラリの無料有効化を申請してください。申請を行わない場合、メディアフィンガープリントの特徴が正常に機能しません。チケットの提出方法の詳細については、「お問い合わせ」を参照してください。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vod:SubmitAIJob

create

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
MediaId	string	任意	動画の ID。以下のいずれかの方法で動画 ID を取得できます。コンソールでアップロードされた動画の場合、ApsaraVideo VOD コンソールにログインし、メディアファイル > オーディオ/ビデオを選択して動画 ID をビューします。 CreateUploadVideo 操作を呼び出してアップロード URL と認証情報を取得する場合、動画 ID は VideoId レスポンスパラメーターの値です。動画のアップロード後、 SearchMedia 操作を呼び出して動画 ID をクエリできます。動画 ID は VideoId レスポンスパラメーターの値です。	3D3D12340d9401fab46a0b847****
Types	string	任意	AI タスクのタイプ。複数のタスクタイプはコンマ (,) で区切ります。有効な値: AIMediaDNA: メディアフィンガープリント。 AIVideoTag: インテリジェントタグ付け。	AIVideoTag。
Config	string	任意	JSON フォーマットの AI タスク構成。 `Types` が `AIVideoTag` にセットされている場合、`Config` は `AnalyseTypes` パラメーターをサポートし、インテリジェントタグ付けタスクの分析アルゴリズムタイプを指定できます。有効な値: ASR: 音声認識。動画内の音声からタグを識別します。 OCR: 光学文字認識。動画の画像内のテキストからタグを識別します。 `Types` が `AIMediaDNA` にセットされている場合、`Config` は `DNADBId` パラメーターをサポートし、メディアフィンガープリントタスクの指紋ライブラリ ID を指定できます。	{"AIVideoTag": {"AnalyseTypes": "ASR"} }
UserData	string	任意	JSON フォーマットのカスタム設定項目。パラメーター構造の詳細については、「 UserData 」を参照してください。	{"Extend":{"localId":"***","test":"www"}}

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーター。
RequestId	string	リクエスト ID。	25818875-5F78-4A13-BEF6-D73936****
AIJobList	object
AIJob	array<object>	AI タスクのリスト。
	object	AI タスクの詳細。
Type	string	AI ジョブのタイプ。有効な値： AIMediaDNA：動画 DNA。 AIVideoTag：スマートタグ。	AIVideoTag
JobId	string	AI ジョブの ID。	9e82640c85114bf5af23edfaf****
MediaId	string	動画の ID。	3D3D12340d92c641401fab46a0b847****

例

成功レスポンス

JSONJSON

{
  "RequestId": "25818875-5F78-4A13-BEF6-D73936****",
  "AIJobList": {
    "AIJob": [
      {
        "Type": "AIVideoTag",
        "JobId": "9e82640c85114bf5af23edfaf****",
        "MediaId": "3D3D12340d92c641401fab46a0b847****"
      }
    ]
  }
}

エラーコード

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

変更履歴

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