浏览文档
开始使用
按任务选择接口,对比一个元数据响应,并确认字幕授权要求及使用成本。
本页内容
按任务选择
FlashData 与 Google 的 YouTube Data API 是独立服务,两者的凭据、响应字段及计费模型不同。
对比概览
| 任务 | 官方 YouTube Data API | FlashData |
|---|---|---|
| 视频元数据 | videos.list | youtube_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
)Bash · official-metadata.json
(
set -euC
: "${GOOGLE_API_KEY:?Set GOOGLE_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 30 --get \
'https://www.googleapis.com/youtube/v3/videos' \
--data-urlencode "key=$GOOGLE_API_KEY" \
--data-urlencode 'part=snippet,contentDetails' \
--data-urlencode 'id=jNQXAC9IVRw' > official-metadata.json
jq '.items | map({video_id: .id, title: .snippet.title,
channel: .snippet.channelTitle, duration_iso8601: .contentDetails.duration})' \
official-metadata.json
)映射结果字段
成功响应包含所请求的视频;items/results 为空表示未返回匹配记录。保留原始响应,并在应用中明确映射字段。
| 数据 | 官方响应 | FlashData 响应 |
|---|---|---|
| 视频 ID | items[0].id | results[0].videoId |
| 标题 | items[0].snippet.title | results[0].title |
| 频道名 | items[0].snippet.channelTitle | results[0].channel |
| 时长 | contentDetails.duration · ISO 8601 | duration · 秒 |
单独确认字幕访问
Google captions.download 需要 OAuth 授权及视频编辑权限。FlashData 获取现有轨道:Transcript 默认自动字幕,Captions 默认上传者字幕。对比结果时明确设置 language 和 auto。
FlashData 不生成转录或翻译。许可标签来源报告 Creative Commons 元数据,不授予训练权利,也不读取创作者独立的训练许可设置。
从单个视频扩展到集合
按输入选择 FlashData 流程。标准搜索最多请求 20 条结果,扩展搜索最多请求 700 条,费率单独计算。
| 输入 | 流程 |
|---|---|
| 主题或搜索词 | 标准或扩展搜索 → 保存视频 ID → 获取元数据。 |
| 少量请求 | 常规批量提交,并分别读取任务结果。 |
| 视频 ID 文件 | Bulk 元数据、转录、字幕、许可标签或下载。 |
比较配额与 Credits
Google 使用项目配额及各方法的配额成本。FlashData 使用共享账户 Credits 及各来源费率,下载按交付媒体字节计量。按实际使用的方法、套餐费及工作量进行计算。