跳转到正文
中文
获取 API 密钥
浏览文档

开始使用

FlashData 与官方 YouTube Data API 对比

按任务选择接口,对比一个元数据响应,并确认字幕授权要求及使用成本。

本页内容

按任务选择

FlashData 与 Google 的 YouTube Data API 是独立服务,两者的凭据、响应字段及计费模型不同。

对比概览

任务官方 YouTube Data APIFlashData
视频元数据videos.listyoutube_metadata
搜索与发现YouTube 资源查询与分页。标准搜索、扩展搜索、频道及联想词。
字幕轨道已授权的字幕操作;下载需要对视频拥有编辑权限。获取指定语言和来源的现有字幕轨道。
账户操作文档支持的视频上传及其他授权写入。数据读取及媒体交付,不修改 YouTube 账户。
媒体文件视频资源响应提供元数据。后台下载至你的存储。

对比一次元数据请求

使用 Bash、cURL 和 jq。Google 侧需在项目中启用 YouTube Data API v3,并设置 GOOGLE_API_KEY。FlashData 侧设置具备 youtube_metadata 权限的 FLASHDATA_API_KEY。每个标签执行一次请求并保存响应,选择你要评估的提供方运行。

Bash · flashdata-metadata.json
(
set -euC
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 120 \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "source": "youtube_metadata",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "include_formats": false,
    "include_chapters": false
  }
}' > flashdata-metadata.json
jq -e '.status == "done"' flashdata-metadata.json >/dev/null
jq '.results | map({video_id: .videoId, title, channel, duration_seconds: .duration})' \
  flashdata-metadata.json
)

映射结果字段

成功响应包含所请求的视频;items/results 为空表示未返回匹配记录。保留原始响应,并在应用中明确映射字段。

数据官方响应FlashData 响应
视频 IDitems[0].idresults[0].videoId
标题items[0].snippet.titleresults[0].title
频道名items[0].snippet.channelTitleresults[0].channel
时长contentDetails.duration · ISO 8601duration · 秒

单独确认字幕访问

Google captions.download 需要 OAuth 授权及视频编辑权限。FlashData 获取现有轨道:Transcript 默认自动字幕,Captions 默认上传者字幕。对比结果时明确设置 language 和 auto。

FlashData 不生成转录或翻译。许可标签来源报告 Creative Commons 元数据,不授予训练权利,也不读取创作者独立的训练许可设置。

从单个视频扩展到集合

按输入选择 FlashData 流程。标准搜索最多请求 20 条结果,扩展搜索最多请求 700 条,费率单独计算。

输入流程
主题或搜索词标准或扩展搜索 → 保存视频 ID → 获取元数据。
少量请求常规批量提交,并分别读取任务结果。
视频 ID 文件Bulk 元数据、转录、字幕、许可标签或下载。

比较配额与 Credits

Google 使用项目配额及各方法的配额成本。FlashData 使用共享账户 Credits 及各来源费率,下载按交付媒体字节计量。按实际使用的方法、套餐费及工作量进行计算。