Perplexity无法加载YouTube字幕主因是视频隐私设置受限或YouTube字幕API不可用；需确认视频为公开且含字幕、检查API响应与跨域头、手动注入WebVTT字幕、更新Innertube客户端参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在Perplexity中加载YouTube视频字幕，但内容始终无法解析，则可能是由于视频隐私设置限制或YouTube字幕API未对当前请求环境开放所致。以下是针对性排查与操作步骤：
一、检查视频隐私状态与字幕可用性
Perplexity依赖YouTube公开接口获取字幕元数据，若视频设为“不公开”“私享”或“未列示”，则YouTube API默认不返回任何字幕资源，导致解析链路中断。
1、在YouTube网页端打开目标视频页面，点击右下角“更多操作”（三个垂直点图标）。
2、选择“显示信息卡”，查看视频下方显示的隐私标识——确认其为“公开”状态。
3、向下滚动至“字幕”区域，确认右侧显示“已添加字幕”或“自动生成字幕可用”；若显示“无可用字幕”，则Perplexity无法从中提取任何内容。
4、复制该视频URL，在新标签页中粘贴并访问，观察地址栏是否出现“/embed/”路径；若为嵌入链接，需切换回原始watch URL（格式为https://www.youtube.com/watch?v=xxxxxxxxxxx）再试。
二、验证YouTube字幕API可访问性
Perplexity调用YouTube字幕接口时需通过合法Referer与User-Agent，并依赖YouTube服务端对Innertube协议的支持；若API端点被限流、封禁或响应结构变更，将直接导致解析失败。
1、在浏览器开发者工具（F12）中切换至Network标签，刷新Perplexity页面并触发字幕加载动作。
2、筛选XHR或Fetch请求，查找包含“timedtext”或“captions”关键词的请求项。
3、点击该请求，查看Headers中的Response Headers是否包含X-Content-Type-Options: nosniff及Access-Control-Allow-Origin: *；若缺失后者，表明跨域策略拒绝前端读取。
4、在Preview或Response面板中确认返回内容是否为XML格式的字幕文本；若为空白、重定向至错误页或返回JSON错误码（如{ "error": { "code": 403, "message": "Forbidden" } }），说明API调用已被拒绝。
三、绕过隐私限制的手动字幕注入方式
当视频确属公开但Perplexity仍无法自动获取时，可将字幕以标准WebVTT格式手动提供，强制跳过API解析环节，由前端直接渲染。
1、使用第三方工具（如youtube_transcript_api）导出字幕：执行命令python -c "from youtube_transcript_api import YouTubeTranscriptApi; print(YouTubeTranscriptApi.get_transcript('VIDEO_ID'))"，其中VIDEO_ID为视频URL中v=后的11位字符串。
2、将返回的JSON列表转换为WebVTT格式，确保每段含有效时间戳与文本，首行必须为WEBVTT，且文件扩展名为.vtt。
3、在Perplexity支持文件上传的界面（如分析PDF/文本框旁）选择该.vtt文件，系统将优先加载本地字幕而非调用远程API。
4、上传成功后，刷新播放器，确认字幕轨道列表中出现“Uploaded Subtitle”选项并可正常启用。
四、校验Innertube客户端参数兼容性
Perplexity部分部署版本通过模拟YouTube官方Innertube客户端发起字幕请求，若客户端密钥（innertube_api_key）、版本号（innertube_version）或上下文字段（context）与YouTube当前服务端要求不匹配，会导致400或404响应。
1、定位项目配置目录中src/lib/config/index.ts或类似路径下的YouTube相关常量定义。
2、确认INNERTUBE_API_KEY值是否为最新有效密钥（当前主流值为AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8）。
3、检查INNERTUBE_VERSION是否不低于20260325.00.00；若低于此值，需更新为YouTube网页源码中实际加载的版本号。
4、在请求构造逻辑中（如src/utils/youtube/caption.ts），确认context.client.clientName设为ANDROID或WEB，而非DESKTOP或IOS。
