Release Notes
お知らせ

処理タイプ | ハイライト自動生成バージョン分類 | 説明 | 対応動画シナリオ | 課金について |
オフラインファイルの処理 | ハイライト自動生成 - 大規模モデル版 | 大規模モデルによる動画理解に基づき、動画コンテンツを自動分析し、重要シーンとハイライトシーンを抽出します。動画理解用のPromptをカスタマイズできます。 | カスタムシナリオ 全天球カメラ・VLOG動画シナリオ ショートドラマ・映像作品シナリオ | 「ハイライト自動生成 - 大規模モデル版」の料金が発生します。 |
| ハイライト自動生成 - 高級版 | 高級版の自動生成アルゴリズムです。スポーツイベントやゲーム・eスポーツ系の動画に最適化されています。 | サッカーイベント バスケットボールイベント ゲーム・eスポーツ動画 汎用シナリオ | 「ハイライト自動生成 - 高級版」の料金が発生します。 |
| ハイライト自動生成 - 基本版 | 2025年12月より、本モデルバージョンは提供終了となり、既存ユーザーへのサービスのみ継続されます。 | | 「ハイライト自動生成 - 基本版」の料金が発生します。 |
ライブストリームの処理 | ハイライト自動生成 - ライブストリーム処理 | 大規模モデルによる動画理解に基づき、ライブ配信シナリオ向けのモデル最適化を実施しています。 | 放送・ニューメディアライブ配信 オンライン教育ライブ配信 EC・ライブコマース配信 金融ライブ配信 サッカー・バスケットボールイベントライブ配信 | 「ハイライト自動生成 - 大規模モデル版」の料金が発生します。 |

multimodal_promptにカスタムPromptを入力できます。拡張パラメータの例は以下のとおりです。//Promptのサンプルです。自由にカスタマイズできます。詳細なフィールド定義は後述の付録をご参照ください。{"hht":{"top_clip":5,"force_cls":10020,"prompts":{"multimodal_prompt":"スキーシナリオ,人物のハイライトを出力"},"scenario":"スキー","model_segment_limit":[3,6]}}

//平面動画のハイライト。詳細なフィールド定義は後述の付録をご参照ください。{"hht":{"top_clip":5,"force_cls":10020,"model_segment_limit":[3,6]}}//全天球動画のハイライト。詳細なフィールド定義は後述の付録をご参照ください。{"hht":{"top_clip":5,"force_cls":10020,"model_segment_limit":[3,6],"use_panorama_direct":1,"panorama_video":1}}

{"hht":{"force_cls":"10010","merge_type":0, "need_vad":1, "top_clip":100, "res_save_type":1,"scenario":"ドラマのハイライト"}}

{"hht":{"force_cls":"4001","merge_type":0, "need_vad":1, "top_clip":100, "res_save_type":1}}

{"hht":{"force_cls":"4002","merge_type":0, "need_vad":1, "top_clip":100, "res_save_type":1}}


{"InputInfo": { //入力ファイルパス"Type": "URL","UrlInputInfo": {"Url": "https://mg-aidata-1258344699.cos-internal.ap-guangzhou.tencentcos.cn/test/hht_test/MyStoryForYouEP39.mp4"}},"OutputStorage": {//出力ファイルの保存パス"Type": "COS","CosOutputStorage": {"Bucket": "mg-aidata-1258344699","Region": "ap-guangzhou"}},"OutputDir": "/test_data/","AiAnalysisTask": {"Definition": 26, //26を指定するとハイライト自動生成機能を使用することを示します"ExtendedParameter": "{\\"hht\\":{\\"top_clip\\":5,\\"force_cls\\":10020,\\"prompts\\":{\\"multimodal_prompt\\":\\"スキーシナリオ、人物のハイライトを出力\\"},\\"scenario\\":\\"スキー\\",\\"model_segment_limit\\":[3,6]}}" //拡張パラメータ。自動生成シナリオの指定や特定機能の実現に使用します。パラメータの渡し方はドキュメントをご参照ください}}








hhtで始まるファイルがハイライト自動生成の出力ファイルであり、各自動生成クリップの動画とサムネイルが含まれています。
TaskNotifyConfigパラメータでイベントコールバックを設定できます。タスクの処理が完了すると、設定したコールバック情報にタスク結果が通知されます。ParseNotificationを使用してイベント通知結果を解析できます。TaskId)が返されます(例:24000022-WorkflowTask-b20a8exxxxxxx1tt110253、24000022-ScheduleTask-774f101xxxxxxx1tt110253)。DescribeTaskDetail APIを呼び出してタスクIDを入力するとタスク結果を取得できます。WorkflowTask ->AiAnalysisResultSetフィールドを解析してタスク結果を取得してください。{"hht":{"force_cls":10010,"scenario":"news"}, "des":{"sent_threshold":200,"time_threshold":300},"live":{"ssrf_ignore":true, "caller":"live"}}
{"hht":{"force_cls":10010,"scenario":"education"}, "des":{"sent_threshold":200,"time_threshold":300},"live":{"ssrf_ignore":true}}
{"hht":{"force_cls":10010,"scenario":"E-commerce"}, "des":{"sent_threshold":200,"time_threshold":300},"live":{"ssrf_ignore":true}}
{"hht":{"force_cls":10010,"scenario":"finance"}, "des":{"sent_threshold":250,"time_threshold":600},"live":{"ssrf_ignore":true}}
{"hht":{"force_cls":4001,"football_close_replay":1},"live":{"ssrf_ignore":true,"caller":"live"}}
Definitionには26を入力します。これはインテリジェント分析のプリセットテンプレート26番を使用して自動生成タスクを開始することを示します。ExtendedParameterは自動生成シナリオの指定に使用します。パラメータの入力例については、前述のライブ配信自動生成シナリオの指定と拡張パラメータの例をご参照ください。なお、API Explorerを使用する場合、ExtendedParameterにはJSONをそのまま入力すればよく、エスケープ処理は不要です。
ExtendedParameterのJSON文字列はエスケープ処理が必要です。以下に参考用のリクエスト例を示します。{"Url": "http://mps-pull.test.org/live/test.flv","TaskNotifyConfig": {"NotifyType": "URL","NotifyUrl": "http://test.cloud.com/callback"},"OutputStorage": {"Type": "COS","CosOutputStorage": {"Bucket": "my-mpsdata-12345xxx99","Region": "ap-guangzhou"}},"OutputDir": "/output/","AiAnalysisTask": {"Definition": 26,"ExtendedParameter": "{\\"hht\\":{\\"top_clip\\":10, \\"force_cls\\":5003, \\"need_vad\\":1, \\"threshold\\":0.9, \\"merge_time\\":60, \\"merge_type\\":0, \\"res_save_type\\":1}}"}}
パラメータ | 必須入力かどうか | タイプ | 説明 |
top_clip | No | int | 信頼度が最も高い自動生成クリップを選択します。デフォルト値は5です。 例: \\"top_clip\\":10 は、信頼度が最も高い自動生成クリップを最大10個出力することを示します。 |
force_cls | No | int | ハイライトのカテゴリを指定します: 10010:ショートドラマ・テレビドラマシナリオ 4001:サッカー 4002:バスケットボール 1001:王者栄耀 100101:王者栄耀競技 1003:リーグ・オブ・レジェンド 10020:大規模モデル自動生成(カスタム動画シナリオ、VLOG・風景動画シナリオなどに適用) |
need_vad | No | int | VADは、映像内の一文の終わりを判断するために使用されます。VADを拡張することで、音声が途切れることなく完全になります。デフォルトで有効です。 1:VADを使用 0:使用しない |
threshold | No | float | 信頼度のしきい値。このしきい値を下回るシーンはすべて除外されます。各カテゴリのハイライトには、デフォルトのしきい値が設定されています。 備考:初めてご利用の際は設定しないことをお勧めします。 |
res_save_type | No | int | 結果を保存するかどうか。デフォルトで保存します。 1:結果を保存 0:期間のみを出力 |
output_pattern | No | string | 出力ビデオの命名規則。{}はプレースホルダーです。 {year}-{month}-{day}-{hour}-{minute}-{second}_{start_dts}-{end_dts}-{timestamp}-{session}.mp4 デフォルトの出力形式: hht-{year}{month}{day}{hour}{minute}-{session}-{timestamp}-index.mp4 |
image_pattern | No | string | image-{start_dts}.jpg 使用可能なプレースホルダーは上記と同じです デフォルトの出力形式: hht-{year}{month}{day}{hour}{minute}-{session}-{timestamp}-index.jpg |
merge_type | No | int | 注意:オフラインシナリオでのみ利用可能です。デフォルト値:5003は結合せず、その他のシナリオでは結合します。 結果を一つのビデオに結合するかどうか? 1:結合する(top_clipパラメータは無効になります) 0:結合しない(merge_timeパラメータは無効になります) |
merge_time | No | int | 注意:オフラインシナリオでのみ利用可能です。デフォルト値:5003は実際の出力時間、その他のシナリオでは最長1時間まで。 一つのビデオに結合する際に、ビデオの出力時間を指定します。 |
prompts | No | Object | promptsの定義リストです。promptを指定することで希望する結果を出力できます。使用方法は大規模モデルの例をご参照ください。 |
scenario | No | string | シナリオを指定します。force_clsが10020の場合に有効になります。 |
model_segment_limit | No | Array | 注意:このパラメータはモデルの出力時間を制御するためのものですが、実際の出力はモデルの判断が優先されます。 出力動画の長さの目安です。モデルへの参考値として渡されますが、強制的な制約値ではありません。force_clsが10020の場合に有効になります。例: "model_segment_limit":[3,6] // 大規模モデルの出力クリップを3~6秒にすることを期待します。 |
パラメータ | 必須/任意 | タイプ | 説明 |
multimodal_prompt | No | string | マルチモーダルモデルのprompt。 |
フィードバック