在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/13679/youtube+scene+analysis+api/31123/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现有的元数据和算法来识别关键时刻 定期更新和质量检查确保检测到的场景的可靠性
