SubmitSmarttagJob - Intelligent Media Services - Alibaba Cloud ドキュメントセンター

スマートタギングジョブを送信します。

操作説明

前提条件

スマートタギングジョブを送信する前に、テンプレートで分析タイプを設定しておく必要があります。詳細については、「CreateCustomTemplate」をご参照ください。

制限事項

スマートタギング機能は、China (Beijing)、China (Shanghai)、China (Hangzhou) リージョンでのみ利用可能です。
スマートタギングパイプラインのデフォルトの同時実行数は 2 です。より高い同時実行数が必要な場合は、チケットを送信してください。
スマートタギングジョブとその結果は 180 日間保持された後、自動的に削除されます。

今すぐお試しください

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

create

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
Title	string	任意	動画のタイトルには、中国語の文字、英字、数字、およびハイフン (-) を使用できます。先頭に特殊文字は使用できず、256 バイトを超えることはできません。	example-title-****
Content	string	任意	動画コンテンツの説明には、中国語の文字、英字、数字、およびハイフン (-) を使用できます。先頭に特殊文字は使用できず、1 KB を超えることはできません。	example content ****
ContentType	string	任意	非推奨です。
ContentAddr	string	任意	非推奨です。
Params	string	任意	追加のリクエストパラメーターです。JSON 文字列として指定します。例： `{"needAsrData":true, "needOcrData":false}`。 `needAsrData` ：分析出力に、自動音声認識 (ASR) の生の結果を含めるかどうかを指定します。デフォルト値は `false` です。 `needOcrData` ：分析出力に、光学文字認識 (OCR) の生の結果を含めるかどうかを指定します。デフォルト値は `false` です。 `needMetaData` ：分析出力にメタデータを含めるかどうかを指定します。デフォルト値は `false` です。 `nlpParams` ：自然言語処理 (NLP) オペレーターの入力パラメーターを指定する JSON オブジェクトです。指定しない場合、このオペレーターは使用されません。詳細は、後述の `nlpParams` テーブルを参照してください。	{"needAsrData":true, "needOcrData":false, "nlpParams":{"sourceLanguage":"cn"}}
NotifyUrl	string	任意	コールバック URL です。HTTP および HTTPS URL のみがサポートされています。	https://example.com/endpoint/aliyun/ai?id=76401125000***
UserData	string	任意	コールバックに含めるカスタムデータです。コールバックとして Message Service (MNS) を使用する場合、このデータはメッセージに含まれます。最大長は 1 KB です。	{“a”:"test"}
Input	object	任意	ジョブの入力ファイルです。
Type	string	任意	入力メディアファイルのタイプを指定します。有効な値： OSS Media URL	Media
Media	string	任意	`Type` パラメーターが `OSS` の場合は、メディアファイルの OSS URL を指定します。例： `OSS://test-bucket/video/202208/test.mp4`。 `Type` パラメーターが `Media` の場合は、メディア ID を指定します。例： `c5c62d8f0361337cab312dce8e77dc6d`。 `Type` パラメーターが `URL` の場合は、メディアファイルの HTTP または HTTPS URL を指定します。例： `https://zc-test.oss-cn-shanghai.aliyuncs.com/test/unknowFace.mp4`。	c5c62d8f0361337cab312dce8e77dc6d
TemplateId	string	任意	分析アルゴリズムを指定するテンプレートの ID です。	39f8e0bc005e4f309379701645f4
ScheduleConfig	object	任意	スケジューリング設定です。
PipelineId	string	任意	パイプラインの ID です。パイプラインはビジネスワークロードを分離し、メッセージ通知をバインドします。このパラメーターを指定しない場合は、デフォルトのパイプラインが使用されます。デフォルトのパイプラインの同時実行数は 2 です。同時実行数を増やすには、チケットを送信してください。	acdbfe4323bcfdae
Priority	string	任意	ジョブの優先度です。この機能はまだ実装されていません。このパラメーターは空のままにするか、任意の値を指定できます。	4
TemplateConfig	string	任意	ジョブの動的パラメーターです。`TemplateId` で指定したベーステンプレートを一時的にオーバーライドまたは補完します。動的パラメーターとテンプレートパラメーターをマージして、現在のジョブの最終設定を生成し、実行前に有効性を検証します。マージルール：リクエスト内の値は、テンプレート内の対応する値をオーバーライドします。テンプレートに存在しないリクエスト内のフィールドは、設定に追加されます。現在サポートされている動的フィールド： `FaceCategoryIds` ：認識に使用する顔ライブラリ ID のリストです。カンマ (,) で区切ります。システムライブラリとカスタムライブラリ両方の ID を使用できます。注：これらの動的パラメーターは現在のジョブにのみ影響します。テンプレート自体は変更されません。	{"FaceCategoryIds":"custom_face_lib1"}

nlpParams

機能	パラメーター	タイプ	必須	説明	例
	nlpParams	オブジェクト	はい	NLP 処理に関連するすべてのパラメーターが含まれます。テンプレートの分析タイプに NLP が含まれる場合、このパラメーターは必須です。指定しない場合、ジョブは失敗します。	{"sourceLanguage":"cn"}
文字起こし	sourceLanguage	文字列	はい	文字起こしのためのソース言語モデルです。有効な値： `cn` (中国語)、`en` (英語)、`yue` (広東語)、`fspk` (中国語と英語の混合)、`ja` (日本語)。音声に複数の言語が含まれる場合、このパラメーターを `multilingual` に設定して、各言語のテキストを認識できます。このパラメーターは `languageHints` と併用します。16 kHz の音声のみがサポートされます。	"cn"
	languageHints	list[string]	いいえ	`sourceLanguage` が `multilingual` に設定されている場合に認識する言語を指定します。有効な値 (複数選択可能)： `cn` (中国語)、`en` (英語)、`yue` (広東語)、`ja` (日本語)、`ko` (韓国語)、`de` (ドイツ語)、`fr` (フランス語)、`ru` (ロシア語)。このパラメーターは言語検出の範囲を制限し、無関係な言語の誤識別を防ぎます。`sourceLanguage` が `multilingual` に設定されている場合にのみ有効です。	['cn', 'en', 'yue']
	transcriptionModel	文字列	いいえ	使用する文字起こしモデルを指定します。有効な値： `fun-asr`。このモデルは `sourceLanguage` を `multilingual` に設定して使用する必要があります。	fun-asr
	diarizationEnabled	ブール値	いいえ	話者ダイアライゼーションを有効にするかどうかを指定します。デフォルトは `false` です。	true
	speakerCount	整数	いいえ	話者ダイアライゼーションの話者数を設定します。`0`：話者数は自動的に検出されます。`2`： 2 人の話者でダイアライゼーションを実行します。	2
ホットワード	phraseId	文字列	いいえ	ホットワード語彙の ID です。	ce9c2a34b6d847bf92a77d0a196f***
PPT 抽出と要約	pptExtractionEnabled	ブール値	いいえ	PPT 抽出と要約を有効にするかどうかを指定します。有効にすると、サービスはビデオから PPT スライドを抽出し、要約を生成します。デフォルトは `false` です。	true
要約	summarizationEnabled	ブール値	いいえ	要約を有効にするかどうかを指定します。有効にすると、サービスは全文要約、話者別要約、およびその他の結果を生成できます。	true
	summarizationTypes	文字列	いいえ	要約が有効な場合、目的の要約タイプを指定する必要があります。有効な値： `Paragraph` (全文要約)、`Conversational` (話者別要約)、`QuestionsAnswering` (Q&A 要約)、`MindMap` (マインドマップ)。	"Paragraph,Conversational,QuestionsAnswering,MindMap"
翻訳	translationEnabled	ブール値	いいえ	翻訳を有効にするかどうかを指定します。	true
	targetLanguages	文字列	いいえ	翻訳のターゲット言語です。翻訳が有効な場合、このパラメーターは必須です。有効な値： `cn` (中国語)、`en` (英語)、`yue` (広東語)。	"en,cn"
チャプター検出	autoChaptersEnabled	ブール値	いいえ	自動チャプター生成を有効にするかどうかを指定します。出力にはチャプターのタイトルと要約が含まれます。	true
会議支援	meetingAssistanceEnabled	ブール値	いいえ	会議支援機能を有効にするかどうかを指定します。出力には、カテゴリ、キーワード、キーセンテンス、アクションアイテムが含まれます。	true

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID です。	****11-DB8D-4A9A-875B-275798****
JobId	string	スマートタギングジョブの ID です。後続の API 呼び出しで使用するため、この ID を保存しておいてください。	**d80e4e4044975745c14b**

例

成功レスポンス

JSONJSON

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

エラーコード

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

変更履歴

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