在YouTube视频中识别重要场景并附上时间戳描述性标题和缩略图预览
在 Postman 中运行
{
"search_metadata": {
"id": "search_pVr1MO4QrQFQBrmq9vblzoE9",
"status": "Success",
"created_at": "2026-08-19T21:53:29Z",
"request_time_taken": 1.67,
"parsing_time_taken": 0.02,
"total_time_taken": 1.69,
"request_url": "https://www.youtube.com/watch?v=cJRP3LRcUFg",
"html_url": "-/api/v1/searches/search_pVr1MO4QrQFQBrmq9vblzoE9.html",
"json_url": "-/api/v1/searches/search_pVr1MO4QrQFQBrmq9vblzoE9"
},
"search_parameters": {
"engine": "youtube_video",
"video_id": "cJRP3LRcUFg",
"gl": "US",
"hl": "en"
},
"video": {
"id": "cJRP3LRcUFg",
"title": "The Smiths - This Charming Man (Official Music Video)",
"length_seconds": 163,
"views": 131903053,
"likes": 819000,
"author": "The Smiths",
"category": "Music",
"published_time": "Feb 6, 2014",
"description": "Official video for This Charming Man by The Smiths \n\nStream The Smiths greatest hits here ▶ https://lnk.to/TheSmithsHits\n\nSubscribe here ▶ https://www.youtube.com/c/thesmithsofficial?sub_confirmation=1\n\nWatch The Smiths' other official music videos ▶ https://www.youtube.com/playlist?list=PLFIhsqj9dojqMSmDjAf6xLl9limlz95-e\n\n\n\"This Charming Man\" was released as the group's second single in October 1983.\nThe single was re-issued in 1992, reaching number 8 on the UK singles chart. Mojo magazine journalists placed the track at number one on their 2008 \"50 Greatest UK Indie Records of All Time\" feature.\n\n\nLyrics\n\nPunctured bicycle \nOn a hillside desolate \nWill nature make a man of me yet?\nWhen in this charming car \nThis charming man\nWhy pamper life's complexity \nWhen the leather runs smooth \nOn the passenger's seat?\nI would go out tonight \nBut I haven't got a stitch to wear \nThis man said \"it's gruesome \nThat someone so handsome should care\"\nAh ! A jumped-up pantry boy \nWho never knew his place \nHe said \"return the ring\"\nHe knows so much about these things \nHe knows so much about these things\nI would go out tonight \nBut I haven't got a stitch to wear \nThis man said \"it's gruesome \nThat someone so handsome should care\"\nLa, la-la, la-la, la-la, this charming man\nOh, la-la, la-la, la-la, this charming man\nAh ! A jumped-up pantry boy \nWho never knew his place \nHe said \"return the ring\"\nHe knows so much about these things \nHe knows so much about these things \nHe knows so much about these things\n\n#TheSmiths #ThisCharmingMan",
"keywords": [
"The Smiths",
"This Charming Man",
"The Smiths This Charming Man",
"The Smiths Official Video",
"This Charming Man Official Video",
"The Smiths Music",
"The Smiths Lyrics",
"This Charming Man Lyrics",
"The Smiths 1983",
"The Smiths Songs",
"Indie",
"Rock",
"Indie Rock",
"Alternative Rock",
"English Music",
"English Songs",
"Morrissey",
"Johnny Marr",
"Andy Rourke",
"Mike Joyce",
"Smiths",
"smiths this charming man",
"Music",
"80s",
"1980s",
"80s music",
"Charming Man"
],
"is_family_safe": true,
"thumbnail": "https://i.ytimg.com/vi_webp/cJRP3LRcUFg/maxresdefault.webp",
"formats": [
{
"itag": 137,
"mime_type": "video/mp4; codecs=\"avc1.640028\"",
"bitrate": 1955659,
"width": 1920,
"height": 1080,
"last_modified_unix": "1754953971894876",
"last_modified": "2025-08-11 23:12:51 UTC",
"content_length": "26712677",
"quality": "hd1080",
"fps": 25,
"quality_label": "1080p",
"projection_type": "RECTANGULAR"
},
{
"itag": 248,
"mime_type": "video/webm; codecs=\"vp9\"",
"bitrate": 1042274,
"width": 1920,
"height": 1080,
"last_modified_unix": "1754952798685398",
"last_modified": "2025-08-11 22:53:18 UTC",
"content_length": "13124082",
"quality": "hd1080",
"fps": 25,
"quality_label": "1080p",
"projection_type": "RECTANGULAR"
},
{
"itag": 399,
"mime_type": "video/mp4; codecs=\"av01.0.08M.08\"",
"bitrate": 953565,
"width": 1920,
"height": 1080,
"last_modified_unix": "1754953882267106",
"last_modified": "2025-08-11 23:11:22 UTC",
"content_length": "11025743",
"quality": "hd1080",
"fps": 25,
"quality_label": "1080p",
"projection_type": "RECTANGULAR"
},
{
"itag": 136,
"mime_type": "video/mp4; codecs=\"avc1.4d401f\"",
"bitrate": 652716,
"width": 1280,
"height": 720,
"last_modified_unix": "1754953355439237",
"last_modified": "2025-08-11 23:02:35 UTC",
"content_length": "8802649",
"quality": "hd720",
"fps": 25,
"quality_label": "720p",
"projection_type": "RECTANGULAR"
},
{
"itag": 247,
"mime_type": "video/webm; codecs=\"vp9\"",
"bitrate": 637838,
"width": 1280,
"height": 720,
"last_modified_unix": "1754952856986506",
"last_modified": "2025-08-11 22:54:16 UTC",
"content_length": "7856656",
"quality": "hd720",
"fps": 25,
"quality_label": "720p",
"projection_type": "RECTANGULAR"
},
{
"itag": 398,
"mime_type": "video/mp4; codecs=\"av01.0.05M.08\"",
"bitrate": 601898,
"width": 1280,
"height": 720,
"last_modified_unix": "1754952847297264",
"last_modified": "2025-08-11 22:54:07 UTC",
"content_length": "6692893",
"quality": "hd720",
"fps": 25,
"quality_label": "720p",
"projection_type": "RECTANGULAR"
},
{
"itag": 135,
"mime_type": "video/mp4; codecs=\"avc1.4d401e\"",
"bitrate": 369240,
"width": 854,
"height": 480,
"last_modified_unix": "1754953355575678",
"last_modified": "2025-08-11 23:02:35 UTC",
"content_length": "4859497",
"quality": "large",
"fps": 25,
"quality_label": "480p",
"projection_type": "RECTANGULAR"
},
{
"itag": 244,
"mime_type": "video/webm; codecs=\"vp9\"",
"bitrate": 377979,
"width": 854,
"height": 480,
"last_modified_unix": "1754953013758245",
"last_modified": "2025-08-11 22:56:53 UTC",
"content_length": "4595408",
"quality": "large",
"fps": 25,
"quality_label": "480p",
"projection_type": "RECTANGULAR"
},
{
"itag": 397,
"mime_type": "video/mp4; codecs=\"av01.0.04M.08\"",
"bitrate": 330704,
"width": 854,
"height": 480,
"last_modified_unix": "1754953139343507",
"last_modified": "2025-08-11 22:58:59 UTC",
"content_length": "3971250",
"quality": "large",
"fps": 25,
"quality_label": "480p",
"projection_type": "RECTANGULAR"
},
{
"itag": 134,
"mime_type": "video/mp4; codecs=\"avc1.4d401e\"",
"bitrate": 253995,
"width": 640,
"height": 360,
"last_modified_unix": "1754953355483447",
"last_modified": "2025-08-11 23:02:35 UTC",
"content_length": "3298445",
"quality": "medium",
"fps": 25,
"quality_label": "360p",
"projection_type": "RECTANGULAR"
},
{
"itag": 243,
"mime_type": "video/webm; codecs=\"vp9\"",
"bitrate": 261001,
"width": 640,
"height": 360,
"last_modified_unix": "1754952851653408",
"last_modified": "2025-08-11 22:54:11 UTC",
"content_length": "3317371",
"quality": "medium",
"fps": 25,
"quality_label": "360p",
"projection_type": "RECTANGULAR"
},
{
"itag": 396
}
]
},
"_note": "Response truncated for documentation purposes"
}
curl --location --request GET 'https://zylalabs.com/api/13680/youtube+scene+recognition+api/31124/key+scenes' --header 'Authorization: Bearer YOUR_API_KEY'
注册后，每个开发者都会被分配一个个人 API 访问密钥，这是一个唯一的字母和数字组合，用于访问我们的 API 端点。要使用 YouTube场景识别 API 进行身份验证，只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后，请查看上方的"您的 API 访问密钥"。
|
YouTube场景识别API帮助用户识别和探索YouTube视频中最相关的时刻，而无需手动观看整个视频。通过输入YouTube视频ID，API检索关键时刻并将其组织成结构化、用户友好的响应，包含时间戳、标题和缩略图。
该API旨在为需要快速理解YouTube长内容重要部分的应用程序服务。它不强迫用户在整个视频中搜索，而是提供直接链接到精彩片段，使视频导航更快、更高效。
每个检测到的关键时刻都包括其标题、以秒为单位的起始位置和相关缩略图。这些信息可用于创建视频摘要、章节导航、内容摘要、可搜索的视频界面和自动发现工具。
API返回关于YouTube视频中关键时刻的结构化数据，包括每个检测到的场景的时间戳、标题和缩略图。这使得用户能够快速导航到视频的相关部分，而无需完整观看。
响应中的关键字段包括 `video.id` `video.title` `video.length_seconds` `search_metadata` 以及关于每个关键时刻的详细信息，如 `timestamp` `title` 和 `thumbnail` 这些字段为视频导航提供了基本信息
响应数据被组织成几个部分：`search_metadata`包含请求细节，`search_parameters`显示输入参数，`video`提供视频本身的信息。关键时刻通常列在一个单独的部分下
API提供关于视频的信息，包括标题长度观看次数点赞数和作者，以及关键时刻及其对应的时间戳标题和缩略图，便于高效内容发现
主要参数是 `video_id`，它指定要分析的 YouTube 视频。附加参数可能包括 `gl`（地理位置）和 `hl`（语言），允许用户根据地区和语言偏好自定义请求
用户可以利用返回的数据创建视频摘要、增强导航功能或开发可搜索的界面。通过直接链接到关键时刻，应用程序可以提高用户参与度和内容可访问性
典型的用例包括创建视频摘要、为长视频开发章节导航、增强内容发现工具以及构建视频分析的自动化系统，使用户更容易找到相关内容
数据准确性通过对视频内容的自动分析得以维持，利用YouTube现有的元数据和算法来识别关键时刻。定期更新和质量检查确保所检测场景的可靠性
