すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:字幕抽出

    ドキュメントセンター

    ApsaraVideo VOD:字幕抽出

    最終更新日:Nov 09, 2025

    マイクロドラマソリューションは、API を介して字幕を抽出する機能を提供します。このトピックでは、マイクロドラマの字幕抽出ジョブの基本的な API 呼び出しメソッドについて説明します。

    説明

    マイクロドラマソリューションの字幕抽出ジョブの前提条件は、アクティベートです。

    字幕抽出

    操作の説明

    字幕抽出ジョブのための SubmitIProductionJob の呼び出しは非同期で実行されます。詳細については、「SubmitIProductionJob - インテリジェントプロダクションタスクの送信」をご参照ください。

    パラメーターの説明

    名前

    タイプ

    必須

    説明

    値の例

    Name

    string

    いいえ

    タスク名。名前は 100 文字を超えることはできません。

    テストタスク

    FunctionName

    string

    はい

    字幕抽出: CaptionExtraction

    CaptionExtraction

    Input

    object

    はい

    入力メディア。OSS がサポートされています。

    Type

    string

    はい

    メディアタイプ:

    • OSS: OSS オブジェクト。

    OSS

    Media

    string

    はい

    入力メディア。OSS アドレスのルールは次のとおりです:

    1. oss://bucket/object

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

    oss://example-bucket/example-object.mp4

    Output

    object

    はい

    出力メディア。OSS がサポートされています。

    Type

    string

    はい

    メディアタイプ:

    • OSS: OSS オブジェクト。

    OSS

    Media

    string

    はい

    出力メディア。OSS アドレスのルールは次のとおりです:

    1. oss://bucket/object

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

    oss://example-bucket/output.srt

    TemplateId

    string

    いいえ

    テンプレート ID

    ****20b48fb04483915d4f2cd8ac****

    JobParams

    string

    いいえ

    アルゴリズムジョブのパラメーター、JSON オブジェクト。アルゴリズムが異なれば、パラメーターの内容も異なります。詳細については、補足説明をご参照ください。

    {fps:10,sep:false,roi:[[0.5, 1], [0, 1]]}

    ScheduleConfig

    object

    いいえ

    タスクスケジューリング構成情報

    PipelineId

    string

    いいえ

    パイプライン ID

    5246********c3dc

    Priority

    integer

    いいえ

    値の範囲は 1 から 10 です。値が小さいほど、優先度が高くなります。

    6

    UserData

    string

    いいえ

    ユーザー定義データ。結果を取得する際にそのまま返されます。長さは 1,024 バイトを超えることはできません。

    {"test":1}

    JobParams の補足説明

    名前

    タイプ

    必須

    説明

    値の例

    fps

    Int

    いいえ

    サンプリングフレームレート (オプション)、整数、有効値 [2,10]、デフォルト 5。

    10

    roi

    List

    いいえ

    字幕選択エリア。

    • 選択エリアが入力された場合、エリア内の字幕のみが抽出され、エリア外のテキストは無視されます。このパラメーターが入力されていない場合、デフォルトでビデオの下 1/4 のエリアが検出されます。

    • フォーマット: [[top, bottom], [left, right]]。

    • デフォルト: なし。

    [[0.5, 1], [0, 1]]

    sep

    Boolean

    いいえ

    中国語と英語の出力を 2 つの srt ファイルに分割するかどうか (オプション)、デフォルトは False。

    formatter

    String

    いいえ

    SRT 字幕のフォーマット文字列 (オプション)、例: "{\an8}"、デフォルトは none。

    図

    lQLPKGcE1cH3dxfNBFfNAyCwIv7L_7b8h34G2SBvzL5wAA_800_1111.png

    例

    シナリオ:

    • 字幕抽出機能

    • アルゴリズムジョブのパラメーター: サンプリングフレームレートを 10 に設定し、字幕選択エリアを下半分のエリアに設定

    • 入力: OSS アドレス

    • 出力: OSS アドレス

    {
  "functionName": "CaptionExtraction",
  "jobParams": "{fps:10,sep:false,roi:[[0.5, 1], [0, 1]]}",
  "input":{
    "type": "OSS",
    "media": "oss://example-bucket/example-object.mp4"
  },
  "output":{
    "type": "OSS",
    "media": "oss://example-bucket/output.srt"
  }
}

    コールバック

    {
  "jobId":"270d****0d1a",
  "requestId":"********-****-****-****-************"
}

    字幕抽出結果のクエリ

    操作の説明

    QueryIProductionJob を呼び出して、字幕抽出タスクのステータスと結果をクエリできます。詳細については、「QueryIProductionJob - インテリジェントプロダクションタスクのクエリ」をご参照ください。

    パラメーターの説明

    リクエストパラメーター

    名前

    タイプ

    必須

    説明

    値の例

    JobId

    string

    いいえ

    クエリするインテリジェントプロダクションジョブの ID。SubmitIProductionJob の戻りパラメーターから取得します。

    270d****0d1a

    レスポンスパラメーター

    名前

    タイプ

    説明

    値の例

    RequestId

    string

    リクエスト ID

    JobId

    string

    タスク ID

    ****20b48fb04483915d4f2cd8ac****

    Name

    string

    タスク名

    テストタスク

    FunctionName

    string

    字幕抽出: CaptionExtraction

    Cover

    Input

    object

    入力メディア。

    Type

    string

    メディアタイプ。

    OSS

    Media

    string

    入力メディアパス。

    oss://example-bucket/example-object.mp4

    Output

    object

    出力メディア。

    Type

    string

    メディアタイプ。

    OSS

    Media

    string

    出力メディアパス。

    oss://example-bucket/output.srt

    TemplateId

    string

    テンプレート ID

    ****96e8864746a0b6f3****

    JobParams

    string

    アルゴリズムジョブのパラメーター、JSON オブジェクト。アルゴリズムが異なれば、パラメーターの内容も異なります。

    {"Model":"gif"}

    ScheduleConfig

    object

    タスク構成情報

    PipelineId

    string

    パイプライン ID

    a54f********5e86

    Priority

    integer

    対応するパイプラインでのタスクの優先度。

    • 最高優先度: 10。

    • デフォルト値: 6。

    6

    UserData

    string

    ユーザー定義データ。結果を取得する際にそのまま返されます

    {"test":1}

    Result

    string

    アルゴリズムによって出力される結果情報。FunctionName が異なれば、出力も異なります。JSON フォーマットで出力されます。以下の補足説明をご参照ください

    {}

    CreateTime

    string

    作成時間、GMT 時間

    2022-07-07T07:16:11Z

    FinishTime

    string

    完了時間、GMT 時間

    2021-11-26T14:50:25Z

    Status

    string

    ジョブのステータス。有効な値:

    • Queuing

    • Analysing

    • Failed.

    • Success

    Success

    OutputFiles

    array

    出力ファイル配列

    string

    生成されたファイルパスと名前

    output.srt

    OutputUrls

    array

    出力ファイル URL 配列

    string

    生成されたファイルのアクセス可能な URL パス

    http://xxx

    コールバックの例

    {
  "createTime": "2024-09-24T06:17:09Z",
  "finishTime": "2024-09-24T06:17:31Z",
  "functionName": "CaptionExtraction",
  "input":{
    "type": "OSS",
    "media": "oss://example-bucket/example-object.mp4"
  },
  "jobId": "270d****0d1a",
  "jobParams": "{\"fps\":10,\"roi\":[[0.5,1],[0,1]],\"sep\":false}",
  "output":{
    "type": "OSS",
    "media": "oss://example-bucket/output.srt"
  },
  "outputFiles": [
    "output.srt"
  ],
  "outputUrls": [
    "http://example-bucket.oss-region.aliyuncs.com/output.srt"
  ],
  "requestId": "********-****-****-****-************",
  "result": "{}",
  "status": "Success"
}