サポート問い合わせ先| システムステータス
ページコンテンツ

    取り込みフィールドリファレンス

    このトピックでは、Dynamic IngestAPIのリクエスト本文フィールドへの参照を提供します。APIリファレンスも参照してください。

    動的取り込みフィールド

    ビデオクラウドインジェストフィールド
    フィールド タイプ 説明
    master オプショナル オブジェクト

    取り込まれるビデオマスター

    master.url オプショナル Url

    ビデオソースの URL。デジタルマスターがアーカイブされた場所の再トランスコード、または既存のビデオに画像またはテキストトラックを追加する場合以外は必須

    master.use_archived_master オプショナル ブール値

    再トランスコードリクエストの場合、に設定されている場合、アーカイブされたマスターを使用しますtrue ;に設定されている場合false、も含める必要がありますurlソースビデオ用

    master.audio_tracks オプショナル オブジェクト

    NS audio_tracks内のオブジェクトmasterオブジェクトには、ビデオファイルに含まれるオーディオトラックのメタデータが含まれます(存在する場合-これは、 混ざり合った オーディオ)-オーディオトラックはすでにビデオファイルに含まれているため、これにはオーディオファイルのURLなしで、メタデータのみが含まれます-を参照してくださいAPIを使用した複数のオーディオトラックの実装詳細については

    master.audio_tracks.language オプショナル 文字列

    のサブタグからの音声で多重化された言語コードhttp://www.iana.org/assignments/language-subtag-registry/language-subtag-registry(Brightcoveサポートに連絡することでアカウントにデフォルトを設定できます)動的配信のみ

    master.audio_tracks.variant オプショナル 文字列

    多重化されたオーディオトラックのタイプ(デフォルトはBrightcoveサポートに連絡することでアカウントに設定できます)-多重化されたオーディオの場合、これは通常ですmain動的配信のみ

    許容値:"main""alternate""commentary""dub""descriptive"

    audio_tracks オプショナル 動的配信のみ オブジェクト []

    オーディオトラックオブジェクトの配列-を参照してくださいAPIを使用した複数のオーディオトラックの実装詳細については。

    audio_tracks.merge_with_existing オプショナル ブール値

    既存のオーディオトラックを置き換えるか、新しいオーディオトラックを追加するか動的配信のみ

    デフォルト値:true

    audio_tracks.masters オプショナル オブジェクト []

    オーディオトラックオブジェクトの配列動的配信のみ

    audio_tracks.masters.url オプショナル 文字列

    オーディオファイルのURL 動的配信のみ

    audio_tracks.masters.language オプショナル 文字列

    のサブタグからのオーディオトラックの言語コードhttp://www.iana.org/assignments/language-subtag-registry/language-subtag-registry(Brightcoveサポートに連絡することでアカウントにデフォルトを設定できます)動的配信のみ

    audio_tracks.masters.variant オプショナル 文字列

    オーディオトラックのタイプ(デフォルトはBrightcoveサポートに連絡することでアカウントに設定できます)動的配信のみ

    許容値:"main""alternate""commentary""dub""descriptive"

    forensic_watermarking オプショナル ブール値 フォレンジック透かしをビデオレンディションに追加する必要があるかどうか-に設定した場合NSアカウントでフォレンジック透かしを有効にする必要があります。有効にしないと、フィールドが無視されます。を参照してください。概要:フォレンジック透かし詳細については
    forensic_watermarking_stub_mode オプショナル ブール値 かどうか見えるフォレンジック透かしをビデオレンディションに追加する必要があります-trueに設定した場合、アカウントでフォレンジック透かしを有効にする必要があります。 forensic_watermarkingフィールドもtrueに設定する必要があります-を参照してください概要:フォレンジック透かし詳細については、目に見える透かしテストにのみ使用する必要がありますフォレンジック透かしがビデオに正常に追加されたことを確認するための統合(少なくとも10分の長さのビデオを使用)。確認が完了したら、新しい取り込みリクエストを送信して動画を再エンコードして削除する必要があります- forensic_watermarking_stub_mode再トランスコード要求ではfalseに設定する必要があります。
    profile オプショナル 文字列

    トランスコーディングに使用する取り込みプロファイル。存在しない場合は、デフォルトのプロファイルが使用されます

    transcriptions オプショナル オブジェクト[]

    自動キャプション/トランスクリプト用の transcriptions オブジェクトの配列

    transcriptions.autodetect オプショナル ブール値 true のときオーディオから言語を自動検出します。false のとき srclang で言語を指定します。
    transcriptions.default オプショナル ブール値 true の場合、srclang は無視され、メインのオーディオトラックが使用され、言語はオーディオから検出されます。
    transcriptions.input_audio_track オプショナル オブジェクト 複数のオーディオトラックがある場合に、キャプション抽出元のオーディオを定義します。languagevariant の両方が必要です。
    transcriptions.input_audio_track.language input_audio_track 指定時は必須 文字列 テキストトラックの BCP-47 形式の言語コード(en-US、fr-FR など)。対応言語を参照してください。
    transcriptions.input_audio_track.variant input_audio_track 指定時は必須 文字列 使用するバリアント:
    • main
    • alternate
    • dub
    • commentary
    • descriptive
    transcriptions.kind オプショナル 文字列 生成する出力の種類。許容値:
    • captions
    • transcripts
    メモ:
    1. kindtranscripts で、かつトランスクリプト用の url含まれる場合、トランスクリプトファイルが取り込まれ、自動キャプションは生成されません。詳細は トランスクリプトファイルの取り込み を参照してください。
    2. kindtranscriptsurl含まれない場合、トランスクリプトファイルとキャプションが生成されます。
    3. kindcaptions の場合、キャプションのみが生成され、トランスクリプトファイルは生成されません。
    transcriptions.label 必須 文字列 人が読めるラベル。
    transcriptions.srclang オプショナル 文字列 テキストトラックの BCP-47 言語コード。 対応言語を参照してください。
    transcriptions.status オプショナル 文字列 テキストトラックの状態。published または draft(追加済みだがユーザーには未公開)。公開前にレビューする場合は draft を指定し、公開時は CMS APIpublished に更新します。
    transcriptions.url オプショナル 文字列 トランスクリプトファイルの URL。kindtranscripts のときに含める必要があります。kindcaptions のときは含めないでください
    transcriptions.use_dictionary オプショナル 真偽値 true のとき、対応する場合はアカウントの自動キャプション辞書を生成されたキャプション/トランスクリプトに適用します。
    transcriptions.max_chars_per_line オプショナル 整数 指定する場合の 1 行あたりの最大文字数。設定時は 25 以上 60 以下である必要があります。
    transcriptions.max_lines_per_cue オプショナル 整数 指定する場合のキューあたりの最大行数。設定時は 1 または 2 である必要があります。
    transcriptions.diarization_mode オプショナル 文字列 対応する場合の話者変更の表現方法: hyphenspeaker_labelsspeaker_names のいずれか。
    transcriptions.enable_audio_tags オプショナル 真偽値 true のとき、対応する場合は出力にオーディオイベントタグを含めます。
    transcriptions.allow_multilanguage_caption オプショナル 真偽値 true のとき、対応する場合はこのエントリで多言語キャプションの動作を許可します。
    transcriptions.ai_transparency_label オプショナル 文字列 AI 生成のテキストトラック用のオプションラベル(AI トランスペアレンシー)。
    transcriptions.polished_transcription オプショナル 真偽値 true のとき、対応する場合は整形されたトランスクリプトスタイルを要求します。
    transcriptions.translation_languages オプショナル オブジェクト[]

    この transcriptions エントリの自動キャプションが存在したあとに、キャプションを翻訳(およびオプションでダビング)する対象言語。各オブジェクトに srclang(BCP-47、必須)と、オプションの labelstatusdraft | published)、dubbing(ブール値)、disable_voice_cloning(ブール値)、ai_transparency_label(文字列、対応する場合は翻訳キャプション用の AI トランスペアレンシー ラベル)、ai_transparency_label_dubbing(文字列、対応する場合は生成されたダビング音声用の AI トランスペアレンシー ラベル)を含めます。トランスクリプトファイルの取り込みおよび Universal Translator を参照してください。

    transcriptions.metadata_optimizer オプショナル オブジェクト

    トランスクリプション/キャプション要求と同じワークフローで AI メタデータ強化ジョブをキューします。POST .../videos/{video_id}/ai/metadata-enhancement/{language} と同じペイロード形状で、オプションの translation_requestlanguages のみ(BCP-47 の配列)です。取り込みでは、translation_request を送るのは skip_reviewauto_translate がどちらも true のときに限り、transcriptions には明示の srclang を使い(autodetect: true は不可)、language(BCP-47)を含めます。トランスクリプトファイルの取り込みおよび AI Metadata Optimizer を参照してください。

    transcriptions.audio_descriptions オプショナル オブジェクト

    この transcriptions エントリで AI オーディオディスクリプションをキューします。POST .../videos/{video_id}/ai/audio-descriptions と同じ本文で、必須の languages(BCP-47 文字列の配列)および任意の ai_transparency_label(文字列、対応する場合は生成される解説音声用の AI トランスペアレンシー ラベル)を含めます。トランスクリプトファイルの取り込みおよび オーディオディスクリプション を参照してください。

    text_tracks オプショナル オブジェクト []

    の配列text_tracksオブジェクト-参照WebVTTファイル(テキストトラック)の取り込み

    text_tracks.url Url

    WebVTT ファイルの URL

    text_tracks.srclang 文字列

    ISO 639 テキストトラックの 2 文字 (アルファ-2) 言語コード

    text_tracks.kind オプショナル 文字列

    vtt ファイルの使用方法について

    デフォルト値:captions

    許容値:"captions""subtitles""chapters""metadata"

    text_tracks.label オプショナル 文字列

    ユーザーが読めるタイトル

    text_tracks.default オプショナル ブール値

    キャプション/字幕のデフォルト言語を設定します

    images 配列{} 取り込む画像を説明するオブジェクトの配列-を参照画像と動的取り込み詳細については
    variant 文字列 画像の種類-次のいずれか:
    • poster
    • thumbnail
    • portrait
    • square
    • wide
    • ultra-wide
    language 文字列 多言語バリアントの言語コード-からのコードhttp://www.iana.org/assignments/language-subtag-registry/language-subtag-registry
    height 数値 ピクセル単位の高さ
    Width 数値 ピクセル単位の幅
    url 文字列 画像が掲載されているURL
    capture-images オプショナル ブール値

    トランスコーディング中にポスターとサムネイルをキャプチャする必要があるかどうか。デフォルトはtrueプロファイルに画像レンディションがある場合、falseそうでない場合-を参照してください画像とDynamicIngest API詳細については

    capture-images-at オプショナル 数値

    ポスターとサムネイル画像をキャプチャするタイムスタンプ(秒、小数可)。0以上である必要があります。値がビデオの長さを超える場合は中間点が使用されます。省略した場合はデフォルトでビデオの中間点が使用されます。詳細については画像をキャプチャするを参照してください。

    注意:capture-imagesfalseの場合は使用できません。

    poster オプショナル オブジェクト

    摂取するビデオポスター-参照画像とDynamicIngest API詳細については

    poster.url Url

    動画ポスター画像のURL

    poster.height オプショナル 整数

    画像のピクセル高さ

    poster.width オプショナル 整数

    画像のピクセル幅

    thumbnail オプショナル オブジェクト

    取り込むビデオサムネイル-を参照画像とDynamicIngest API詳細については

    thumbnail.url Url

    動画のサムネイル画像の URL

    thumbnail.height オプショナル 整数

    画像のピクセル高さ

    thumbnail.width オプショナル 整数

    画像のピクセル幅

    callbacks オプショナル 文字列 [] そのURLの配列通知に送信する必要があります

    ページの最終更新日22 Sep 2021