提供一个完整的 YouTube 观看 URL，查询视频元数据和可用媒体链接。阅读标题、作者等识别信息，再让 Agent 根据实际返回内容整理视频参考说明。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
YouTube
提供一个完整的 YouTube 观看 URL，查询视频元数据和可用媒体链接。阅读标题、作者等识别信息，再让 Agent 根据实际返回内容整理视频参考说明。
返回内容可包含视频标题与 ID、作者和频道链接、缩略图、时长、可用格式及直接媒体链接。Agent 可将这些信息整理成视频参考说明，并保留返回的链接，供后续单独使用。
请根据[YouTube 视频链接]整理实际返回的视频标题、频道、时长和可用版本，重点核对[我想了解的内容]。媒体链接与后续保存文件的步骤分开说明。
可用信息和链接取决于视频访问情况。格式列表或媒体 URL 不表示文件已被读取或保存。使用链接时还需检查访问情况和媒体质量。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
视频媒体请求body | object | 必填 | 必填请求对象，包含要查看的一个 YouTube 视频的完整观看 URL。
|
YouTube 观看 URLbody.url | string | 必填 | 必填目标 YouTube 观看页面的完整 URI。请提供完整视频 URL，不要只填写视频 ID、视频标题或频道名称。
|
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "完整的 YouTube 视频页面链接。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
请求需要一个完整 YouTube 观看 URL，放在 body.url 中。这是单个视频查询，不能用搜索词或频道名称替代观看页面。
可用元数据通过标题、视频 ID、作者或频道链接、缩略图帮助识别视频。Agent 可将这些内容整理成参考说明，并保留缺失信息，不自行补齐。
时长和媒体格式信息描述实际返回的媒体选项。保留已有标签和单位，不从没有说明的数值推断编码、分辨率、文件大小或音频选项。
直接媒体链接供后续另行访问。链接出现不表示文件已被读取或保存；使用时应检查该链接是否可访问。
能否取回内容取决于视频和来源访问情况。单个观看页面请求不能据此确认播放列表或频道覆盖、受限视频访问能力，或格式是否齐全。重要信息应与提供的原页面核对。
告诉助手你想核对什么，例如[这是不是我要引用的视频]。
请根据[YouTube 视频链接]整理实际返回的视频标题、频道、时长和可用版本，重点核对[我想了解的内容]。媒体链接与后续保存文件的步骤分开说明。
查看可用格式的说明和媒体链接，不假定特定分辨率、编码或永久有效链接。Agent 可记录适合后续查看的选项；读取或保存文件是单独步骤。
将完整观看 URL 放入 body.url。单独的视频 ID 不是要求的输入，也没有单独的标题、频道或关键词搜索字段。如果只知道 ID，应先取得对应观看 URL 再查询。
不会。返回链接供后续单独访问或保存文件，使用时应检查它是否仍可访问；链接本身不是已保存文件。
此请求只提交观看 URL。请查看实际返回的格式选项，这里没有格式、分辨率、编码或音频选择输入。选择或转换媒体供其他用途是另一步，也不能保证目标选项可用。
任务针对一个观看页面，不能据此确认播放列表或整个频道覆盖，也不能保证访问私人、会员专享或年龄受限视频。若信息缺失，仅凭返回内容不能判断具体访问原因。