用途:该技能用于获取 YouTube 视频的字幕或说明文字(captions),可按视频 ID 或视频 URL 提取转录文本,支持指定语言(如 en、zh-CN),并可选返回每段的时间戳,便于分析或翻译。触发关键词包括 YouTube subtitles、get captions、video transcript、extract subtitles、YouTube 字幕,也可显式使用 /felo-youtube-subtitling。不适用于实时搜索(用 felo-search)、网页内容(用 felo-web-fetch)或生成幻灯片(用 felo-slides)。
主要能力:调用 Felo YouTube Subtitling API(GET /v2/youtube/subtitling,基础地址 https://openapi.felo.ai),返回视频标题与字幕内容数组,每段含 text,可选 start 与 duration。支持完整 YouTube 链接(watch、youtu.be、embed)或 11 位视频 ID。
使用方式:先获取 API key(访问 felo.ai,Settings -> API Keys 创建并复制),配置环境变量:Linux/macOS 用 export FELO_API_KEY="your-api-key-here",Windows PowerShell 用 $env:FELO_API_KEY="your-api-key-here"。执行方式有两种:一是使用仓库脚本 node felo-youtube-subtitling/scripts/run_youtube_subtitling.mjs --video-code "dQw4w9WgXcQ" [options],或安装全局 CLI 后使用 felo youtube-subtitling -v "dQw4w9WgXcQ" [options];二是用 curl 直接调用 API:curl -X GET "https://openapi.felo.ai/v2/youtube/subtitling?video_code=dQw4w9WgXcQ" -H "Authorization: Bearer $FELO_API_KEY"。选项包括 --video-code/-v(必填)、--language/-l、--with-time(默认 false)、--json/-j(默认 false)。
限制:并非所有视频都有字幕,API 可能对部分视频返回错误;语言代码必须匹配视频实际存在的字幕轨道;需使用与其他 Felo 技能相同的 FELO_API_KEY。错误码包括 400 参数校验失败、401 INVALID_API_KEY、500/502 YOUTUBE_SUBTITLING_FAILED。失败时输出 stderr 信息并以退出码 1 结束。具体收费与价格信息暂未提供。