字幕生成
video-generate-subtitles
ショートフォーム動画の開始
ショートフォーム動画のパラメータを有効にするには fm=mp4 を設定する必要があります。
処理時間について
字幕生成は初回リクエスト時に処理され、数分かかる場合があります。処理中は VTT URL へのリクエストが 423 ステータスを返し、字幕を表示できません。処理完了後は、ソースの Video Cache TTL に従ってキャッシュされます。
エンドユーザーへの遅延を防ぐには、アップロードや公開ワークフローの一部として VTT URL をリクエストし、字幕を事前生成しておくことをお勧めします。これによりキャッシュがウォームアップされ、プレーヤーが公開される前に字幕が準備完了の状態になります。
video-generate-subtitles パラメータは、動画のAI文字起こしを有効にします。有効化すると、Imgixは動画の音声から自動的に字幕トラックを生成します。字幕は HLS または DASH マニフェストに埋め込んで配信することも、fm=vtt を使ったサイドカー VTT ファイルとして単独で配信することもできます。
文字起こしを有効にする
video-generate-subtitles を true（または on）に設定すると、常にAI文字起こしが有効になります。auto を使用すると、ソース動画に既存の字幕トラックがない場合にのみ文字起こしが行われます。これは、すでに埋め込み字幕がある動画の再文字起こしを避けたい場合に便利です。話されている言語は自動的に検出されます。
https://assets.imgix.net/videos/girl-reading-book-in-library.mp4?fm=hls&video-generate-subtitles=true文字起こしを無効にするには、false（または off）を設定します。
ソース言語を指定する
デフォルトでは、Imgixは話されている言語を自動検出します。video-subtitle-lang を使用すると、ソース言語を明示的に指定できます。自動検出の精度が低い場合や、特定の言語の音声を扱う場合に有効です。値は ISO 639-1 または ISO 639-2 の言語コードである必要があります。
https://assets.imgix.net/videos/girl-reading-book-in-library.mp4?fm=hls&video-generate-subtitles=true&video-subtitle-lang=esサイドカー VTT ファイルをリクエストする
ネイティブの <video> 要素で使用するには、fm=vtt と video-generate-subtitles=true を組み合わせてAI文字起こし済みの字幕ファイルをリクエストします。これにより、<track> 要素で直接読み込める WebVTT ファイルが返されます。
https://assets.imgix.net/videos/girl-reading-book-in-library.mp4?fm=vtt&video-generate-subtitles=true<track> 要素を使った完全な HTML の例については、ユーザーフレンドリーな動画プレーヤーの作成チュートリアルを参照してください。
字幕を他の言語に翻訳するには、字幕翻訳を参照してください。
ライブデモ
以下の例は、サイドカー VTT ファイルとして読み込んだ AI 生成の英語字幕トラックを持つネイティブ <video> 要素を示しています。動画プレーヤーのコントロールにある CC／字幕ボタンで字幕を有効にしてください。