应检查模型名是否在官方列表中、升级SDK至最新版、用cURL手动验证、确认API密钥权限及请求体结构正确；特别注意大小写、连字符、账户类型与字段位置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您调用Perplexity API时收到“Invalid Model”错误，说明请求中指定的模型名称未被当前API版本识别或已弃用。以下是解决此问题的步骤：
一、确认所用模型是否在官方支持列表中
Perplexity API仅接受其文档明确列出的模型标识符，如pplx-7b-online、pplx-70b-online、sonar-medium-online、sonar-pro等。使用不存在或拼写错误的模型名将直接触发400响应与“Invalid Model”提示。
1、访问Perplexity官方模型文档页面：https://docs.perplexity.ai/docs/models
2、核对您代码中model字段的值是否与文档中“Available Models”表格完全一致（区分大小写、连字符、后缀）
3、特别注意已下线模型（如pplx-3b-online）不可再使用，即使历史代码曾有效
二、升级Perplexity官方SDK至最新版本
旧版SDK可能内置过期的模型白名单或默认模型参数，无法识别新上线模型（如sonar-deep-research），亦可能因请求结构变更导致模型字段被忽略或误解析。
1、若使用Node.js环境，执行：npm install @perplexity-ai/sdk@latest
2、若使用Python环境，执行：pip install --upgrade perplexity-sdk
3、检查SDK版本号是否≥v2.4.0（Node）或≥v1.8.2（Python），该版本起全面支持Sonar系列模型
4、更新后，替换原初始化代码中的模型调用方式，例如从new PerplexityClient({ model: 'pplx-70b-online' })改为client.chat.completions.create({ model: 'sonar-pro', messages: [...] })
三、手动验证模型可用性（绕过SDK）
排除SDK缓存或封装逻辑干扰，通过原始HTTP请求确认服务端是否接受目标模型，有助于判断是配置问题还是模型本身不可用。
1、打开终端，执行以下cURL命令（将YOUR_API_KEY替换为真实密钥）：
curl -X POST https://api.perplexity.ai/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
Perplexity SEO 优化指南 — 如何获得 Perplexity AI 的引用。涵盖 Perplexity 引用行为、面向 Perplexity 答案的内容结构、Perplex...
-H "Content-Type: application/json" \
-d '{ "model": "sonar-pro", "messages": [{"role": "user", "content": "test"}] }'
2、观察响应体：若返回200且含choices[0].message.content，证明模型有效；若仍报错，则模型名不合法或账户无权限
3、若需调用sonar-deep-research，必须确保API密钥来自Pro订阅账户，免费密钥不支持该模型
四、检查API密钥权限与账户类型
部分高级模型（如sonar-deep-research、sonar-reasoning-pro）仅对Pro计划用户开放，即使模型名正确，免费密钥也会返回“Invalid Model”而非“Insufficient permissions”。
1、登录https://www.perplexity.ai/api，查看右上角账户状态是否显示Pro Active
2、进入Settings → API Keys，点击对应密钥右侧的“View details”，确认Permissions列包含Deep Research或Reasoning Pro
3、若权限缺失，需升级订阅并重新生成密钥，旧密钥不会自动获得新增权限
五、校验请求体结构与字段位置
“Invalid Model”也可能由JSON结构错误引发，例如model字段未置于根对象、被嵌套在错误层级、或与messages同级但拼写为modle等低级错误。
1、确保请求体为标准JSON对象，且model与messages为同级键
2、确认messages为非空数组，首项role为"user"，content为字符串类型
3、禁用任何中间件对请求体的自动修改（如Axios的transformRequest、Express bodyParser预处理）
4、使用Postman或curl发送最小化请求体进行比对，例如：
{ "model": "pplx-7b-online", "messages": [{"role": "user", "content": "hi"}] }
