SubmitVideoCognitionJob API でビデオコンテンツを分析 - IMS - Alibaba Cloud - Intelligent Media Services

操作説明

これは非同期 API です。ジョブを送信すると、サービスはジョブ ID を返し、処理のためにキューに入れます。最終結果はコールバック通知によって配信されます。QueryIntelligentContentUnderstandingTask 操作を呼び出してジョブのステータスを確認することもできます。

今すぐお試しください

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

create

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
Title	string	任意	ビデオのタイトル。タイトルには、中国語文字、英字、数字、ハイフン (-) を使用できます。タイトルを特殊文字で始めることはできず、長さは 256 バイトを超えることはできません。	example-title-****
Params	string	任意	自然言語処理、ショット検出、カスタムタグ付け、アクション認識などのオペレーターの追加パラメーターを含む JSON 文字列。	{ "nlpParams": { "sourceLanguage": "cn", "diarizationEnabled": true, "speakerCount": 2, "summarizationEnabled": true, "summarizationTypes": "Paragraph,Conversational,QuestionsAnswering,MindMap", "translationEnabled": true, "targetLanguages": "en", "autoChaptersEnabled": true, "meetingAssistanceEnabled": true } }
UserData	string	任意	ユーザー定義データ。サービスは、コールバック通知でこのデータを変更せずに返します。このパラメーターは 1,024 バイトを超えることはできません。	{"test":1}
Input	object	任意	入力メディアオブジェクト。
Type	string	任意	入力メディアのタイプ。有効な値： `OSS` `Media` `URL`	Media
Media	string	任意	`Type` が `OSS` の場合は、メディアファイルの Object Storage Service (OSS) の URL を指定します。例：`OSS://test-bucket/video/202208/test.mp4` `Type` が `Media` の場合は、メディア ID を指定します。例：`c5c62d8f0361337cab312dce8e77dc6d` `Type` が `URL` の場合は、メディアファイルの HTTP URL を指定します。例：`https://zc-test.oss-cn-shanghai.aliyuncs.com/test/unknowFace.mp4`	c5c62d8f03613************c6d
TemplateId	string	任意	使用する分析アルゴリズムを指定するテンプレートの ID。テンプレートの管理の詳細については、「Create Custom Template」および「AI 搭載のタグ付けテンプレート」をご参照ください。	39f8e0bc00***************
TemplateConfig	string	任意

nlpParams

機能	パラメーター	タイプ	必須	説明	例
	nlpParams	object	はい	自然言語処理 (NLP) のパラメーターが含まれます。テンプレートの分析タイプに NLP が含まれている場合、このオブジェクトは必須です。それ以外の場合、ジョブは失敗します。	{"sourceLanguage":"cn"}
文字起こし	sourceLanguage	string	はい	文字起こしのソース言語モデル。有効な値：`cn` (中国語)、`en` (英語)、`yue` (広東語)、`fspk` (中国語と英語の混合)。	"cn"
話者分離	diarizationEnabled	boolean	いいえ	話者分離を有効にするかどうかを指定します。デフォルト値は `false` です。	true
	speakerCount	integer	いいえ	話者分離の話者の数。これを `0` に設定すると、サービスは自動的に話者の数を検出します。話者の数を固定で指定するには、値をその数 (例：`2`) に設定します。	2
要約	summarizationEnabled	boolean	いいえ	要約を有効にするかどうかを指定します。有効にすると、サービスは全文要約や話者ごとの要約などの出力を生成します。	true
	summarizationTypes	string	いいえ	`summarizationEnabled` が `true` の場合に必須です。`Paragraph` (全文要約)、`Conversational` (話者ごとの要約)、`QuestionsAnswering` (Q&A 要約)、`MindMap` (マインドマップ) のうち、1 つ以上の要約タイプを指定します。	"Paragraph,Conversational,QuestionsAnswering,MindMap"
翻訳	translationEnabled	boolean	いいえ	翻訳を有効にするかどうかを指定します。	true
	targetLanguages	string	いいえ	翻訳のターゲット言語。`translationEnabled` が `true` の場合に必須です。有効な値：`cn` (中国語)、`en` (英語)、`yue` (広東語)、`fspk` (中国語と英語の混合)。	"en,cn"
チャプター検出	autoChaptersEnabled	boolean	いいえ	チャプター検出を有効にするかどうかを指定します。結果には、チャプターのタイトルと要約が含まれます。	true
会議アシスタンス	meetingAssistanceEnabled	boolean	いいえ	会議アシスタンスを有効にするかどうかを指定します。結果には、カテゴリ、キーワード、キーセンテンス、アクションアイテムが含まれます。	true

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエストの ID。	****11-DB8D-4A9A-875B-275798****
JobId	string	ジョブの ID。	**20b48fb04483915d4f2cd8ac**

例

成功レスポンス

JSONJSON

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "JobId": "****20b48fb04483915d4f2cd8ac****"
}

エラーコード

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

変更履歴

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