video-transcription

動画の文字起こし

使用する場合

• 入力が動画ファイルで、音声の抽出、タイムスタンプ付きの文字起こし、字幕の生成、多言語の文字起こし、または編集準備用のタイムスタンプが目的の場合。
• 意味的な映像分析が必要な場合は、代わりに media-analysis を使用してください。

タイムスタンプ付きの文字起こしがすでにあり、字幕の出力だけが求められている場合は、 文字起こしをスキップし、ローカルの字幕変換リファレンスを参照してください。

使用しない場合

• 音声や字幕ではなく、新たなクリエイティブ生成や映像分析が必要なタスク。
• 必要な入力が不足しており、推測すると結果が変わる場合。

実行境界

• ホスト型の動画文字起こしは、公開されている postplus media transcribe 動詞を通じて非同期で実行されます。以下に生成される例には、エンドポイントキーが示されています。
• ローカルパス、HTTPS URL、既存の PostPlus メディア参照、またはデータ URI を --video に直接渡してください。CLI は、ホストへの送信を 1 回行う前にローカルメディアを検証し、準備します。
• 結果を字幕や編集の判断に使う場合は、デフォルトでタイムスタンプを要求してください。
• ホスト型の動画文字起こしは非同期です。送信すると、実行ハンドル、現在のステータス、利用可能な場合は文字起こしのアーティファクトが記録されます。返された形式を確認してください。正規化された文字起こしスキーマが固定されていると想定しないでください。

ソースとパス

• 送信前に、ソース動画または URL から durationSeconds を取得し、 リクエストの検証に使うため、エンドポイントの duration フラグに渡してください。
• 大規模なバッチ処理の前に、ソースファイルを 1 つ使って開始してください。
• 内部リクエスト、レスポンス、正規化された文字起こし、ダウンロードしたアーティファクトは .postplus/video-transcription の下に保管してください。ユーザー向けの最終的な文字起こしのエクスポートは .postplus の外に保管してください。

引き継ぎ

• ステータスが保留中の場合は、結果のパスを保持し、同じ操作について CLI が返したアクションまたは再開コマンドに従ってください。別のジョブを送信しないでください。 CLI の待機／復旧境界に達したら、停止して報告してください。
• SRT／ASS が要求された場合は、実際のタイムスタンプ付き文字起こしを使い、 ローカルでの字幕変換を参照してください。別のホストリクエストを行わずローカルで変換してください。CLI エクスポートコマンドを捏造しないでください。

停止条件

• 必要なユーザーの意図、ソースの根拠、または管理対象の入力アーティファクトが不足しており、推測すると結果が変わる場合は停止してください。

公開コマンドの境界

• ユーザー入力に合致する最小限のコマンドまたはワークフローを選び、直接実行してください。

• 準備状況の診断：postplus doctor --skill video-transcription。

• エンドポイント、フラグ、列挙型の完全な仕様が必要な場合、または不明なリクエスト形式を修正する場合に限り、postplus media schema --json を使用してください。

• 以下の生成されたコマンドでホスト型の文字起こしジョブを実行してください。別の実行インターフェイスは使用しないでください。

• ソースは --video を通じて直接渡してください。事前にアップロードしたり、手動でリクエストオブジェクトを作成したりしないでください。

• 要求されたタスクでは、現在の価格と残高を確認したうえで、既存の PostPlus クレジットを使用します。 見積もりのみのリクエストは実行されません。クレジットが不足している場合は停止してください。チャージ、サブスクリプションの購入、不確実な有料操作の繰り返しは行わないでください。

postplus media transcribe transcription-video \
  --video ./reference.mp4 \
  --duration-seconds 1 \
  --wait \
  --output ./result.json

CLI の構造化された結果と報告された次のアクションに従ってください。自由記述のメッセージから復旧方法を推測しないでください。 要求があった場合は、明示的なユーザーの承認を待ってください。アクションによって、支出、公開、または上書きが許可されるわけではありません。 返されたチェックポイントまたはアクションを通じて同じ操作を再開してください。不確実な処理を再送信したり、復旧を繰り返して上限を超えたり、失敗を回避するためにプロバイダーを切り替えたりしないでください。