video-transcription

视频转录

适用场景

• 输入是视频文件，目标是提取语音、生成带时间戳的转录文本、生成字幕、多语言转录，或为剪辑准备时间戳。
• 如果用户需要语义层面的视觉分析，请改用 media-analysis。

如果已有带时间戳的转录文本，且仅需输出字幕，请跳过转录并查阅本地字幕转换参考。

不适用场景

• 任务需要新的创意生成或视觉分析，而非语音或字幕。
• 缺少必需的输入，且猜测会改变结果。

执行边界

• 托管式视频转录通过公开的 postplus media transcribe 动词运行，并以异步方式执行。下方生成的示例展示了端点键。
• 将本地路径、HTTPS URL、现有的 PostPlus 媒体引用或数据 URI 直接传给 --video。CLI 会在单次托管提交前验证并准备本地媒体。
• 如果结果用于字幕或剪辑决策，默认请求时间戳。
• 托管式视频转录以异步方式执行。提交后会记录运行句柄、当前状态，以及在可用时记录转录产物。检查返回的格式；不要假定转录文本遵循固定的规范化架构。

来源与路径

• 提交前，根据源视频或 URL 推导出 durationSeconds，并通过端点的时长标志传入，以验证请求。
• 批量处理前，先从一个源文件开始。
• 将内部请求、响应、规范化转录文本和下载的产物保存在 .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 的结构化结果和报告的后续操作；不要根据自由文本消息推断恢复方式。 如需明确的用户批准，请等待；某项操作不代表授权消费、发布或覆盖。 通过返回的检查点或操作恢复同一项任务；绝不要重新提交状态不确定的任务、重复已耗尽的恢复操作，也不要切换提供方来绕过故障。