按主题搜索，或分享 YouTube 视频、频道、播放列表、话题标签或搜索结果页链接，整理可获取的视频资料。本工具提供视频信息，不提供视频文件。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
YouTube
按主题搜索，或分享 YouTube 视频、频道、播放列表、话题标签或搜索结果页链接，整理可获取的视频资料。本工具提供视频信息，不提供视频文件。
记录可能包含视频标题、描述、链接、频道背景、时长、发布信息，以及来源报告的观看、点赞或评论数量。可选字幕或语音转写处理可能提供可访问的文本或引用地址。AI 摘要和按时间分段的描述是独立可选附加项；语音转写与 AI 选项可能增加费用。
查找关于[主题]的 YouTube 视频，最多[5 条]，跳过 Shorts 短视频和直播，并整理可获取的标题和链接。
请求数量不保证完整采集或固定返回条数。关键词搜索分别设置普通视频、Shorts 和直播的上限；零表示在该次搜索中排除对应类型。访问限制与筛选可能导致部分结果、字段缺失或错误记录。来源计数不证明独立观看人数或已验证触达。媒体与转写引用不等于已交付文件，生成文本或 AI 分析也可能不准确。评论数和订阅数不提供评论讨论或订阅者名单。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
视频采集设置body | object | 选填 | 可选设置，包括关键词或已选 YouTube 链接、请求的视频类型、频道筛选以及字幕或 AI 附加项。要进行有用采集，需提供可用关键词或链接。链接优先于关键词，搜索筛选仅作用于关键词路线。 |
3D 搜索筛选body.is3D | boolean | null | 选填 | 可选。true 请求对关键词搜索使用 YouTube 的 3D 特征筛选，不进行视频转换。false、null 或省略不表示请求反向筛选。 |
4K 搜索筛选body.is4K | boolean | null | 选填 | 可选。true 请求对关键词搜索使用 YouTube 的 4K 特征筛选。这是搜索标签，不独立验证或转换分辨率。false、null 或省略不表示请求反向筛选。 |
HD 搜索筛选body.isHD | boolean | null | 选填 | 可选。true 请求对关键词搜索使用 YouTube 的 HD 特征筛选，不验证或转换画面分辨率。false、null 或省略不表示请求反向筛选。 |
Creative Commons 搜索筛选body.hasCC | boolean | null | 选填 | 可选。true 请求对关键词搜索使用 Creative Commons 授权标签筛选，不负责获取字幕，也不独立验证再使用权利。false、null 或省略不表示请求反向筛选。 |
360 度搜索筛选body.is360 | boolean | null | 选填 | 可选。true 请求对关键词搜索使用 YouTube 的 360 度特征筛选，不转换或播放媒体。false、null 或省略不表示请求反向筛选。 |
HDR 搜索筛选body.isHDR | boolean | null | 选填 | 可选。true 请求对关键词搜索使用 YouTube 的 HDR 特征筛选，不独立验证或转换媒体。false、null 或省略不表示请求反向筛选。 |
直播搜索筛选body.isLive | boolean | null | 选填 | 可选。true 请求对关键词搜索使用 YouTube 的 Live 特征筛选。直播采集数量需另设对应上限，这个开关不打开播放。false、null 或省略不表示请求反向筛选。 |
VR180 搜索筛选body.isVR180 | boolean | null | 选填 | 可选。true 请求对关键词搜索使用 YouTube 的 VR180 特征筛选，不转换或播放媒体。false、null 或省略不表示请求反向筛选。 |
已购买内容搜索筛选body.isBought | boolean | null | 选填 | 可选。true 请求对关键词搜索使用 YouTube 的 Purchased 特征筛选，不购买内容或提供受限视频访问权限。false、null 或省略不表示请求反向筛选。 |
已选 YouTube 链接body.startUrls | array | 选填 | 可选视频、频道、播放列表、标签或搜索结果页链接列表，条目形式例如 {url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}，默认为空列表。提供链接后忽略 searchQueries，关键词搜索筛选不作用于这些链接。链接采集中的视频类型区分可能不同，也不保证完整清单。
|
搜索视频类型body.videoType | string | null | 选填 | 可选关键词搜索筛选：video（视频）或 movie（电影）。省略或使用 null 表示不设置该筛选，不控制直接链接采集或下载媒体。
|
搜索上传时间范围body.dateFilter | string | null | 选填 | 可选关键词搜索上传时间筛选：hour（最近一小时）、today（今天）、week（本周）、month（本月）或 year（本年）。不控制直接链接，未明确具体日历与时区边界。
|
每个关键词的普通视频上限body.maxResults | integer | 选填 | 可选整数，范围 0–999999，默认 0。限制每个关键词的普通视频数量；零表示在该次搜索中排除普通视频。也用于限制频道采集的普通视频。预填 10 是示例，不是默认值。这不是整次请求的总记录上限，也不保证固定返回条数。
|
地点标签搜索筛选body.hasLocation | boolean | null | 选填 | 可选。true 请求对关键词搜索使用 YouTube 的 Location 特征筛选，不选择国家或验证创作者实际所在地。false、null 或省略不表示请求反向筛选。 |
字幕/CC 搜索筛选body.hasSubtitles | boolean | null | 选填 | 可选。true 请求对关键词搜索使用 YouTube 的 Subtitles/CC 特征筛选。实际获取字幕需另设 transcriptionAndSubtitle。false、null 或省略不表示请求反向筛选。 |
搜索时长类别body.lengthFilter | string | null | 选填 | 可选关键词搜索筛选：under4（不足 4 分钟）、between420（4–20 分钟）或 plus20（超过 20 分钟）。不控制直接链接，未明确类别边界的具体包含方式。
|
频道视频顺序body.sortVideosBy | string | 选填 | 可选频道页面顺序：NEWEST（最新）、POPULAR（热门）或 OLDEST（最早），对应频道 Videos、Shorts 和 Live 页面的排序按钮，无默认值。它与关键词搜索的 sortingOrder 不同；设置 oldestPostDate 会将频道顺序重置为 NEWEST。
|
关键词搜索顺序body.sortingOrder | string | null | 选填 | 可选关键词搜索顺序：relevance（相关性）、rating（评分）、date（上传日期）或 views（观看数）。省略或使用 null 表示不设置，不重新排序直接链接集合。YouTube 筛选可能混合 Shorts 与普通视频。
|
另存已获取字幕body.saveSubsToKVS | boolean | 选填 | 可选。true 将已获取字幕另存到供应方的键值存储；生成的语音转写无论该开关如何都会保存在该处。存储引用不等于本地文件，也不保证完整文本可访问。 |
YouTube 搜索词body.searchQueries | array | 选填 | 可选搜索词列表，输入方式与 YouTube 搜索栏相同。预填 Crawlee 是示例，不是默认值。需设置所需视频类型的上限，三个上限默认均为零。提供 startUrls 时忽略这些搜索词。 |
可选 AI 视频摘要body.aiVideoSummary | boolean | 选填 | 可选付费附加项，默认 false。开启后，AI 可能结合画面和声音生成简短概念摘要。仅使用实际返回的摘要并注明由 AI 生成，不作为已验证内容或逐字转写。
|
频道视频发布起始日期body.oldestPostDate | string | 选填 | 可选，仅用于频道链接，请求上传日期不早于指定绝对日期或处于相对时间范围内的视频，例如 2024-01-01 或 2 days。来源将 1 day 描述为今天，2 days 描述为昨天和今天。开启后频道排序重置为 NEWEST，可能增加费用。不作用于其他链接路线或关键词搜索；未保证统一时区或具体时间戳边界。
|
字幕文本格式body.subtitlesFormat | string | 选填 | 可选，默认 srt。选择 srt、vtt、xml 或 plaintext，用于已获取字幕；需启用获取字幕的模式。该设置不保证提供可下载文件，也不决定生成语音转写的输出格式。
|
每个关键词的直播上限body.maxResultStreams | integer | 选填 | 可选整数，范围 0–999999，默认 0。限制每个关键词的直播视频数量；零表示在该次搜索中排除直播。与普通视频、Shorts 上限分开，不是整次请求的总上限，也不保证固定返回条数。
|
每个关键词的 Shorts 上限body.maxResultsShorts | integer | 选填 | 可选整数，范围 0–999999，默认 0。限制每个关键词的 Shorts 数量；零表示在该次搜索中排除 Shorts。与普通视频、直播上限分开，不是整次请求总上限或固定条数。YouTube 筛选可能混合视频类型。
|
获取字幕的语言body.subtitlesLanguage | string | 选填 | 可选，默认 en。选项：any（可用语言）、en（英语）、de（德语）、es（西班牙语）、fr（法语）、it（意大利语）、ja（日语）、ko（韩语）、nl（荷兰语）、pt（葡萄牙语）或 ru（俄语）。仅在所选模式获取字幕时生效；any 不表示所有语言，这个设置不翻译文本，也不保证对应字幕存在。
|
可选 AI 分段描述body.aiVideoDescription | boolean | 选填 | 可选付费附加项，默认 false。开启后，AI 可能结合画面和声音生成按时间分段的描述。只保留实际返回的分段并注明由 AI 生成；内容可能不准确，也不是逐字转写。
|
字幕与语音转写模式body.transcriptionAndSubtitle | string | null | 选填 | 可选，默认 NONE（跳过字幕与转写）。ALWAYS_SUBTITLES 请求已有字幕，视可用情况返回；TRANSCRIPTION_AS_FALLBACK 请求字幕，并在缺少字幕时生成语音转写；ALWAYS_TRANSCRIBE 无论是否已有字幕都请求生成转写。语音转写可能增加费用。已有字幕可能随记录返回，生成转写由供应方另存，返回结果可能只是引用地址。不保证完整文本可访问或交付原生文件。
|
优先自动字幕body.preferAutoGeneratedSubtitles | boolean | 选填 | 可选。true 在可用时优先采用自动生成字幕，而不是上传字幕；需指定字幕语言并选择获取字幕的模式。不翻译字幕，不保证字幕存在，也不强制生成新的语音转写。 |
{
"type": "object",
"required": [],
"properties": {
"body": {
"type": "object",
"title": "Input schema for the youtube-search-scraper actor",
"required": [],
"properties": {
"is3D": {
"type": "boolean",
"title": "3D",
"editor": "checkbox",
"nullable": true,
"description": "可选。true 请求对关键词搜索使用 YouTube 的 3D 特征筛选，不进行视频转换。false、null 或省略不表示请求反向筛选。"
},
"is4K": {
"type": "boolean",
"title": "4K",
"editor": "checkbox",
"nullable": true,
"description": "可选。true 请求对关键词搜索使用 YouTube 的 4K 特征筛选。这是搜索标签，不独立验证或转换分辨率。false、null 或省略不表示请求反向筛选。"
},
"isHD": {
"type": "boolean",
"title": "HD",
"editor": "checkbox",
"nullable": true,
"description": "可选。true 请求对关键词搜索使用 YouTube 的 HD 特征筛选，不验证或转换画面分辨率。false、null 或省略不表示请求反向筛选。",
"groupCaption": "Features",
"groupDescription": "What you could select under the Features section of the Filtering&Sorting menu on Youtube"
},
"hasCC": {
"type": "boolean",
"title": "Creative Commons",
"editor": "checkbox",
"nullable": true,
"description": "可选。true 请求对关键词搜索使用 Creative Commons 授权标签筛选，不负责获取字幕，也不独立验证再使用权利。false、null 或省略不表示请求反向筛选。"
},
"is360": {
"type": "boolean",
"title": "360 degrees",
"editor": "checkbox",
"nullable": true,
"description": "可选。true 请求对关键词搜索使用 YouTube 的 360 度特征筛选，不转换或播放媒体。false、null 或省略不表示请求反向筛选。"
},
"isHDR": {
"type": "boolean",
"title": "HDR",
"editor": "checkbox",
"nullable": true,
"description": "可选。true 请求对关键词搜索使用 YouTube 的 HDR 特征筛选，不独立验证或转换媒体。false、null 或省略不表示请求反向筛选。"
},
"isLive": {
"type": "boolean",
"title": "Live",
"editor": "checkbox",
"nullable": true,
"description": "可选。true 请求对关键词搜索使用 YouTube 的 Live 特征筛选。直播采集数量需另设对应上限，这个开关不打开播放。false、null 或省略不表示请求反向筛选。"
},
"isVR180": {
"type": "boolean",
"title": "VR180",
"editor": "checkbox",
"nullable": true,
"description": "可选。true 请求对关键词搜索使用 YouTube 的 VR180 特征筛选，不转换或播放媒体。false、null 或省略不表示请求反向筛选。"
},
"isBought": {
"type": "boolean",
"title": "Purchased",
"editor": "checkbox",
"nullable": true,
"description": "可选。true 请求对关键词搜索使用 YouTube 的 Purchased 特征筛选，不购买内容或提供受限视频访问权限。false、null 或省略不表示请求反向筛选。"
},
"startUrls": {
"type": "array",
"title": "Direct URLs",
"editor": "requestListSources",
"default": [],
"example": [
{
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
],
"description": "可选视频、频道、播放列表、标签或搜索结果页链接列表，条目形式例如 {url: \"https://www.youtube.com/watch?v=dQw4w9WgXcQ\"}，默认为空列表。提供链接后忽略 searchQueries，关键词搜索筛选不作用于这些链接。链接采集中的视频类型区分可能不同，也不保证完整清单。",
"sectionCaption": "🔗 Direct URLs"
},
"videoType": {
"enum": [
"video",
"movie"
],
"type": "string",
"title": "Video type filter",
"editor": "select",
"example": "video",
"nullable": true,
"enumTitles": [
"Video",
"Film"
],
"description": "可选关键词搜索筛选：video（视频）或 movie（电影）。省略或使用 null 表示不设置该筛选，不控制直接链接采集或下载媒体。"
},
"dateFilter": {
"enum": [
"hour",
"today",
"week",
"month",
"year"
],
"type": "string",
"title": "Date filter",
"editor": "select",
"example": "month",
"nullable": true,
"enumTitles": [
"Last hour",
"Today",
"This week",
"This month",
"This year"
],
"description": "可选关键词搜索上传时间筛选：hour（最近一小时）、today（今天）、week（本周）、month（本月）或 year（本年）。不控制直接链接，未明确具体日历与时区边界。"
},
"maxResults": {
"type": "integer",
"unit": "Videos",
"title": "Maximum videos per search term",
"default": 0,
"example": 10,
"maximum": 999999,
"minimum": 0,
"prefill": 10,
"description": "可选整数，范围 0–999999，默认 0。限制每个关键词的普通视频数量；零表示在该次搜索中排除普通视频。也用于限制频道采集的普通视频。预填 10 是示例，不是默认值。这不是整次请求的总记录上限，也不保证固定返回条数。"
},
"hasLocation": {
"type": "boolean",
"title": "Location",
"editor": "checkbox",
"nullable": true,
"description": "可选。true 请求对关键词搜索使用 YouTube 的 Location 特征筛选，不选择国家或验证创作者实际所在地。false、null 或省略不表示请求反向筛选。"
},
"hasSubtitles": {
"type": "boolean",
"title": "Subtitles/CC",
"editor": "checkbox",
"nullable": true,
"description": "可选。true 请求对关键词搜索使用 YouTube 的 Subtitles/CC 特征筛选。实际获取字幕需另设 transcriptionAndSubtitle。false、null 或省略不表示请求反向筛选。"
},
"lengthFilter": {
"enum": [
"under4",
"between420",
"plus20"
],
"type": "string",
"title": "Length filter",
"editor": "select",
"example": "between420",
"nullable": true,
"enumTitles": [
"Under 4 minutes",
"4-20 minutes",
"Over 20 minutes"
],
"description": "可选关键词搜索筛选：under4（不足 4 分钟）、between420（4–20 分钟）或 plus20（超过 20 分钟）。不控制直接链接，未明确类别边界的具体包含方式。"
},
"sortVideosBy": {
"enum": [
"NEWEST",
"POPULAR",
"OLDEST"
],
"type": "string",
"title": "Sort by",
"editor": "select",
"example": "NEWEST",
"enumTitles": [
"Newest",
"Popular",
"Oldest"
],
"description": "可选频道页面顺序：NEWEST（最新）、POPULAR（热门）或 OLDEST（最早），对应频道 Videos、Shorts 和 Live 页面的排序按钮，无默认值。它与关键词搜索的 sortingOrder 不同；设置 oldestPostDate 会将频道顺序重置为 NEWEST。"
},
"sortingOrder": {
"enum": [
"relevance",
"rating",
"date",
"views"
],
"type": "string",
"title": "Sorting order",
"editor": "select",
"example": "relevance",
"nullable": true,
"enumTitles": [
"Relevance",
"Rating",
"Upload date",
"View count"
],
"description": "可选关键词搜索顺序：relevance（相关性）、rating（评分）、date（上传日期）或 views（观看数）。省略或使用 null 表示不设置，不重新排序直接链接集合。YouTube 筛选可能混合 Shorts 与普通视频。",
"sectionCaption": "✅ Add filters",
"sectionDescription": "Specify the parameters you want to sort/filter videos by. They will be applied as if you manually did so on Youtube's search page. Only works if you provide search term, not for the direct URLs.\n \n ⚠️ Using YouTube filters may mix Shorts with regular videos. This is a limitation on YouTube's side. We recommend checking it manually."
},
"saveSubsToKVS": {
"type": "boolean",
"title": "Save subtitles to key-value store",
"editor": "hidden",
"example": false,
"description": "可选。true 将已获取字幕另存到供应方的键值存储；生成的语音转写无论该开关如何都会保存在该处。存储引用不等于本地文件，也不保证完整文本可访问。"
},
"searchQueries": {
"type": "array",
"title": "Search terms",
"editor": "stringList",
"example": [
"web scraping tutorials"
],
"prefill": [
"Crawlee"
],
"nullable": false,
"description": "可选搜索词列表，输入方式与 YouTube 搜索栏相同。预填 Crawlee 是示例，不是默认值。需设置所需视频类型的上限，三个上限默认均为零。提供 startUrls 时忽略这些搜索词。"
},
"aiVideoSummary": {
"type": "boolean",
"title": "Add-on: AI video summary ($)",
"default": false,
"example": false,
"description": "可选付费附加项，默认 false。开启后，AI 可能结合画面和声音生成简短概念摘要。仅使用实际返回的摘要并注明由 AI 生成，不作为已验证内容或逐字转写。"
},
"oldestPostDate": {
"type": "string",
"title": "Scrape videos published after [date]",
"editor": "datepicker",
"example": "2024-01-01",
"pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$",
"dateType": "absoluteOrRelative",
"description": "可选，仅用于频道链接，请求上传日期不早于指定绝对日期或处于相对时间范围内的视频，例如 2024-01-01 或 2 days。来源将 1 day 描述为今天，2 days 描述为昨天和今天。开启后频道排序重置为 NEWEST，可能增加费用。不作用于其他链接路线或关键词搜索；未保证统一时区或具体时间戳边界。",
"sectionCaption": "📅 Date range (applicable only to scraping by channels URL) ($)"
},
"subtitlesFormat": {
"enum": [
"srt",
"vtt",
"xml",
"plaintext"
],
"type": "string",
"title": "Subtitle format",
"editor": "select",
"default": "srt",
"example": "srt",
"enumTitles": [
"SRT",
"WEBVTT",
"XML",
"plaintext"
],
"description": "可选，默认 srt。选择 srt、vtt、xml 或 plaintext，用于已获取字幕；需启用获取字幕的模式。该设置不保证提供可下载文件，也不决定生成语音转写的输出格式。"
},
"maxResultStreams": {
"type": "integer",
"unit": "Videos",
"title": "Maximum streams per search term",
"default": 0,
"example": 0,
"maximum": 999999,
"minimum": 0,
"prefill": 0,
"description": "可选整数，范围 0–999999，默认 0。限制每个关键词的直播视频数量；零表示在该次搜索中排除直播。与普通视频、Shorts 上限分开，不是整次请求的总上限，也不保证固定返回条数。"
},
"maxResultsShorts": {
"type": "integer",
"unit": "Videos",
"title": "Maximum shorts per search term",
"default": 0,
"example": 5,
"maximum": 999999,
"minimum": 0,
"prefill": 0,
"description": "可选整数，范围 0–999999，默认 0。限制每个关键词的 Shorts 数量；零表示在该次搜索中排除 Shorts。与普通视频、直播上限分开，不是整次请求总上限或固定条数。YouTube 筛选可能混合视频类型。"
},
"subtitlesLanguage": {
"enum": [
"any",
"en",
"de",
"es",
"fr",
"it",
"ja",
"ko",
"nl",
"pt",
"ru"
],
"type": "string",
"title": "Subtitle language",
"editor": "select",
"default": "en",
"example": "en",
"enumTitles": [
"Any",
"English",
"German",
"Spanish",
"French",
"Italian",
"Japanese",
"Korean",
"Holland",
"Portuguese",
"Russian"
],
"description": "可选，默认 en。选项：any（可用语言）、en（英语）、de（德语）、es（西班牙语）、fr（法语）、it（意大利语）、ja（日语）、ko（韩语）、nl（荷兰语）、pt（葡萄牙语）或 ru（俄语）。仅在所选模式获取字幕时生效；any 不表示所有语言，这个设置不翻译文本，也不保证对应字幕存在。"
},
"aiVideoDescription": {
"type": "boolean",
"title": "Add-on: AI video description ($)",
"default": false,
"example": false,
"description": "可选付费附加项，默认 false。开启后，AI 可能结合画面和声音生成按时间分段的描述。只保留实际返回的分段并注明由 AI 生成；内容可能不准确，也不是逐字转写。",
"sectionCaption": "🤖 AI video analysis ($)"
},
"transcriptionAndSubtitle": {
"enum": [
"NONE",
"ALWAYS_SUBTITLES",
"TRANSCRIPTION_AS_FALLBACK",
"ALWAYS_TRANSCRIBE"
],
"type": "string",
"title": "Transcription & subtitles",
"editor": "select",
"default": "NONE",
"nullable": true,
"enumTitles": [
"None",
"Only download subtitles (when present on the video)",
"Download subtitles + transcribe videos without subtitles (using speech-to-text models) ($)",
"Always transcribe ($)"
],
"description": "可选，默认 NONE（跳过字幕与转写）。ALWAYS_SUBTITLES 请求已有字幕，视可用情况返回；TRANSCRIPTION_AS_FALLBACK 请求字幕，并在缺少字幕时生成语音转写；ALWAYS_TRANSCRIBE 无论是否已有字幕都请求生成转写。语音转写可能增加费用。已有字幕可能随记录返回，生成转写由供应方另存，返回结果可能只是引用地址。不保证完整文本可访问或交付原生文件。",
"sectionCaption": "🖹 Download YouTube transcript"
},
"preferAutoGeneratedSubtitles": {
"type": "boolean",
"title": "Prefer automatically generated subtitles.",
"editor": "hidden",
"example": false,
"description": "可选。true 在可用时优先采用自动生成字幕，而不是上传字幕；需指定字幕语言并选择获取字幕的模式。不翻译字幕，不保证字幕存在，也不强制生成新的语音转写。"
}
},
"description": "可选设置，包括关键词或已选 YouTube 链接、请求的视频类型、频道筛选以及字幕或 AI 附加项。要进行有用采集，需提供可用关键词或链接。链接优先于关键词，搜索筛选仅作用于关键词路线。",
"schemaVersion": 1
}
},
"additionalProperties": false
}暂未配置返回字段说明。
视频附带的频道资料描述来源报告的背景。认证标记、国家标签或变现标记不构成对身份、所在地或收入的独立核实。
搜索[主题，例如做菜]，并要求最多[5 条]普通视频。按主题搜索时不会包含 Shorts 短视频和直播；实际返回数量可能更少。
查找关于[主题]的 YouTube 视频，最多[5 条]，跳过 Shorts 短视频和直播，并整理可获取的标题和链接。
粘贴[YouTube 视频链接]，查看可获取的视频资料。本工具返回视频信息，不会提供视频文件。
三个搜索上限各自默认零，需为所需类型设置正数；零表示在关键词搜索中排除该类型。每个上限按搜索词计算，不是整次请求的统一额度，普通视频预填的 10 也不是默认值。筛选、访问限制与平台上限仍可能导致较少记录、空结果或错误。空结果或失败不证明没有匹配视频。
提供直接链接时优先使用链接并忽略 searchQueries。关键词的顺序、上传时间类别、时长、类型与特征筛选仅作用于关键词路线，不作用于直接链接，搜索结果页链接也不例外。频道链接另有排序及可选发布起始日期，日期包含当天，启用后强制 NEWEST 且可能增加费用；普通视频上限也限制频道的普通视频。不要假设所有链接集合都严格区分视频类型，或共用一个总上限。
默认处理模式为 NONE。字幕模式仅请求可用的已有字幕；回退模式在缺少字幕时生成语音转写，始终转写模式则无论是否有字幕都请求生成转写。语音转写和 AI 附加项可能增加费用。已有字幕可能随记录返回，生成转写可能另存并仅返回引用地址。语言与格式选项不保证可访问文本、翻译或已交付文件。AI 摘要和分段描述是独立生成分析，不是已认证事实或逐字转写。