“Unsupported Model for this Key”错误表明API密钥未授权访问指定模型，需确认账户为Pro订阅、在API密钥权限页勾选对应模型、严格匹配模型名称大小写与拼写，必要时新建密钥并重设权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在调用Perplexity API时收到“Unsupported Model for this Key”错误提示，则说明当前API Key未被授权访问所指定的模型。该错误与密钥权限配置直接相关，而非网络或认证失败。以下是修复此问题的具体步骤：
一、验证API Key所属账户类型及订阅状态
Perplexity对不同模型的访问权限严格区分免费版与Pro版账户。部分模型（如pplx-70b-online、sonar-medium-online）仅对Pro订阅用户开放，免费账户生成的Key即使格式正确也无法调用。
1、登录Perplexity官网https://www.perplexity.ai/，点击右上角头像进入账户菜单。
2、确认页面顶部显示“Pro Active”标识；若显示“Free Tier”，则需先完成Pro订阅流程。
3、若已订阅但未生效，检查邮箱中是否收到Stripe付款确认邮件，并等待系统同步（通常在5分钟内完成）。
二、检查API Key的模型白名单设置
每个API Key在创建后可单独配置允许调用的模型列表。若未勾选目标模型，请求将被拒绝并返回“Unsupported Model”错误。
1、访问https://www.perplexity.ai/settings/api-keys，进入密钥管理页。
2、在密钥列表中找到出错的Key，点击其右侧的“Edit permissions”链接。
3、在弹出面板中查看“Allowed models”区域，确认目标模型（例如pplx-70b-online或sonar-medium-online）已被勾选。
4、若未勾选，立即勾选对应模型，然后点击“Save changes”保存配置。
三、确认请求中使用的模型名称拼写与大小写完全匹配
Perplexity API对模型名称区分大小写且要求精确匹配。任何多余空格、连字符位置错误或版本后缀遗漏均会导致该错误。
1、查阅官方模型文档确认当前可用模型全称，例如有效值为pplx-7b-chat而非pplx-7b-chat-v1或PPLX-7B-CHAT。
2、检查请求体中model字段值，确保与API密钥权限页中显示的模型名字符逐位一致。
3、在cURL或Postman中复现请求时，将model值替换为从权限页直接复制的原始字符串。
四、重新生成API Key并重设权限
若原有Key存在权限缓存延迟或配置异常，可创建新Key以排除状态残留问题。新Key将强制加载最新权限策略。
1、在API密钥管理页点击“Create new API key”按钮。
2、为新Key输入唯一描述名（如“debug-model-access-key”），避免复用旧名称。
3、在权限编辑界面中，**主动勾选全部需调试的模型**，包括pplx-7b-chat、pplx-70b-online、sonar-medium-online等。
4、点击“Confirm”生成后，立即复制新Key，并在代码或工具中替换旧Key值。
五、使用curl命令验证模型访问能力
绕过应用层逻辑，直接通过底层HTTP请求验证模型权限是否生效，可快速定位是配置问题还是集成问题。
1、打开终端，执行以下命令（将YOUR_API_KEY和MODEL_NAME替换为实际值）：
curl -X POST https://api.perplexity.ai/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "model": "MODEL_NAME", "messages": [{"role":"user","content":"test"}] }'
2、观察响应：若返回200及有效reply，说明模型权限已就绪；若仍返回400错误且message含“Unsupported Model”，则需返回第二步复查权限勾选状态。
