字幕提取

POST/openapi/v1/extract/subtitles — 每次调用消耗 1 积分。

返回视频元信息与全部可用字幕轨道（人工与自动生成、所有语言），每轨附七种格式的下载直链：srt、vtt、ttml、json3、srv1、srv2、srv3。当前支持 YouTube。

curl -X POST https://api.snapany.com/openapi/v1/extract/subtitles \
  -H "Authorization: Bearer sk_snapany_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=jNQXAC9IVRw"}'

响应包含：

• id / title / text / duration / published_at / thumbnail_url：视频元信息
• subtitles：每个语言轨道一条——language_name（展示名，自动生成轨会标注，如 English (auto-generated)）、language_tag（BCP 47 风格）、urls（各格式的下载直链）

按需下载对应格式——播放器与剪辑用 srt/vtt，程序化处理（带逐句时间轴）用 json3。直链带签名且会过期，请及时拉取，不要长期存储链接本身。

没有字幕的视频报 no_subtitles 错误（HTTP 404）且不扣费——捕获该错误码后回退到转录。

完整 schema 与真实形状的响应示例：API 参考。

字幕提取 vs. 转录

• 本接口返回 YouTube 已有的字幕——即取即得，每次 1 积分，但仅限有字幕的视频。
• 转录用 Whisper large-v3 对音频转写——任何视频都可用（包括没有字幕的），支持说话人分离，每分钟 4 积分。

常见流水线：先调 /extract/subtitles；遇到 no_subtitles 错误再回退到/transcriptions。

计费

每次成功调用消耗 1 积分，提取成功后扣除；失败的调用（无效链接、不支持的站点、无字幕）不扣费。详见积分与计费。