SuperAPI AI 工具集

video-transcription

设计与创作

查看项目

更新于 10-16 08:07

技能介绍

用途:当输入是视频文件,目标是提取语音、生成带时间戳的文字稿、字幕、多语言转写或剪辑用时间戳时使用本技能。若需要语义化的画面分析,应改用 media-analysis;若已有带时间轴的字幕、仅需输出字幕文件,则跳过转写,直接读取本地字幕转换参考。

主要能力:托管视频转写通过公开的 postplus media transcribe 动词执行,且为异步。可向 --video 直接传入本地路径、HTTPS URL、已有 PostPlus 媒体引用或 data URI;CLI 会在单次托管提交前校验并准备本地媒体。结果用于字幕或剪辑决策时,默认请求时间戳。提交会记录运行句柄、当前状态及可用时的转写产物;应检查返回格式,不要假定固定的规范化转写结构。

使用方式:提交前从源视频或 URL 推导 durationSeconds,并通过端点的 duration 标志传入以做请求校验。建议先处理单个源文件再批量。示例命令:postplus media transcribe transcription-video --video ./reference.mp4 --duration-seconds 1 --wait --output ./result.json。就绪诊断:postplus doctor --skill video-transcription。仅在需要完整端点、标志与枚举契约或修复未知请求结构时使用 postplus media schema --json。若 CLI 返回报价确认挑战,需先获得用户对范围与成本的批准,再运行 postplus quote confirm --json --challenge-file <challenge.json> 并用返回的 token 重试。

路径与交接:内部请求、响应、规范化转写和下载产物放在 .postplus/video-transcription 下;最终面向用户的转写导出放在 .postplus 之外。若状态为 pending,保留结果路径并遵循 CLI 返回的 action 或 resume 命令继续同一操作,不要另提交新任务;到达 CLI 等待/恢复边界时停止并报告。需要 SRT/ASS 时,使用实际带时间轴转写并读取本地字幕转换,在本地转换,不再发起托管请求,也不要臆造 CLI 导出命令。

限制:不适用于需要新创意生成或视觉分析的任务;缺少必要输入且猜测会改变结果时不要使用。等待用户明确批准,动作本身不授权花费、发布或覆盖;不要重复提交不确定的工作、重复已耗尽的恢复或切换提供方绕过失败。资料未提供具体价格、平台支持范围与效果指标。