402或“quota exceeded”错误源于赠送额度仅限特定模型，需核对API密钥的额度模型白名单、检查请求model字段是否完全匹配、通过权限设置禁用高成本模型，并用curl验证pplx-7b-chat等白名单模型调用是否成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜如果您已获取 Perplexity API Key，但调用接口时返回 402 或 “quota exceeded” 错误，即使账户显示有赠送额度，问题可能源于该额度仅适用于特定模型，而您当前请求中指定的模型不在覆盖范围内。以下是核对与修正额度适用模型范围的具体步骤：
一、确认账户赠送额度所绑定的模型白名单
Perplexity 的赠送额度（如新用户注册赠送的 $5 或 Pro 试用期额度）并非全局通用，而是按模型维度独立分配。系统仅允许将额度用于明确列入白名单的模型，例如 pplx-7b-online、pplx-7b-chat 或 sonar-small-online；而 pplx-70b-online、sonar-medium-online 等高成本模型默认排除在赠送额度之外。
1、登录 https://www.perplexity.ai/settings/api-keys 页面，找到对应 API Key 条目。
2、点击右侧“View usage & limits”链接，进入该密钥的用量仪表盘。
3、在“Quota breakdown by model”区域查看各模型名旁标注的额度状态：显示“$0.00 / $5.00”且右侧带绿色勾选图标，表示该模型可用赠送额度；若显示“N/A”或灰色禁用图标，则代表不支持。
二、检查请求中 model 参数是否匹配白名单模型
API 请求体（Body）中显式声明的 model 字段必须与赠送额度所支持的模型名称完全一致，包括大小写与连字符。任何拼写偏差（如 sonar_medium_online、pplx-7B-chat）均会导致额度判定失败，系统自动拒绝扣减并返回 402。
1、打开您发起请求的代码或调试工具（如 Postman、curl 或 Python 脚本）。
2、定位 JSON 请求体中的 "model" 字段值。
3、将其与上一步中仪表盘显示的白名单模型逐字比对，特别注意以下易错项：pplx-7b-chat（非 pplx-7b-online）、sonar-small-online（非 sonar-small-offline）、pplx-7b-online（非 pplx-7b-online-beta）
。
三、通过 API 密钥权限设置强制限定可用模型
若需确保所有请求均落在赠送额度覆盖范围内，可主动在后台关闭高成本模型的调用权限，使密钥仅能访问已授权的低价模型。该操作会直接拦截不匹配模型的请求，避免额度误判或静默失败。
1、在 API Keys 管理页，点击目标密钥右侧的“Edit permissions”链接。
2、取消勾选所有未出现在白名单中的模型，例如：pplx-70b-online、sonar-medium-online、sonar-large-online。
3、仅保留勾选状态的模型：
pplx-7b-chat、pplx-7b-online、sonar-small-online。
4、点击“Save changes”，等待页面提示“Permissions updated successfully”。
四、使用 curl 命令验证白名单模型调用是否成功
绕过应用层逻辑，直接以最简方式测试白名单模型能否正常响应并扣减赠送额度，可快速排除客户端配置干扰。
1、复制以下命令，在终端中执行（将 YOUR_API_KEY 替换为实际密钥）：curl -X POST https://api.perplexity.ai/chat/completions \-H "Authorization: Bearer YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"model":"pplx-7b-chat","messages":[{"role":"user","content":"Hello"}]}'2、观察返回结果：若响应体含 "choices" 字段且 HTTP 状态码为 200，则说明赠送额度已成功应用于该模型；
若返回 {"error":{"message":"Model not authorized for this key","type":"invalid_request_error"}}，则证明权限设置未生效或模型名仍不匹配。