已经实名认证但无法使用免费 API（通常指阿里云百炼/通义千问的免费额度），通常是因为免费额度的领取规则、账号状态或调用方式存在误解。
请按照以下步骤逐一排查，90% 的问题都能找到原因：
1. 确认是否“手动领取”了免费额度
这是最常见的原因。 实名认证通过后，免费额度不会自动到账，通常需要您手动点击领取。
操作步骤：
登录 阿里云百炼控制台。
在首页或左侧菜单找到 “用户中心” 或 “免费额度” / “资源包” 页面。
查看是否有 “立即领取” 或 “激活免费试用” 的按钮。
注意：部分活动仅限新用户（即从未开通过百炼服务、从未创建过 API Key 的账号）。如果您之前不小心点过“开通服务”或创建过 Key，可能被视为“老用户”而失去领取资格。
2. 检查免费额度的适用范围
免费额度通常有严格的限制，如果您的调用不符合条件，会直接扣费（导致余额不足报错）或拒绝访问。
指定模型限制：免费额度通常仅限
qwen-turbo或部分特定时期的qwen-plus。如果您调用的是qwen-max、qwen-vl或其他第三方模型，不会消耗免费额度，而是直接扣除账户余额。解决方法：在代码中将
model参数显式指定为qwen-turbo测试一下。有效期限制：免费额度通常有有效期（如领取后 30 天内有效，或截止到某年某月）。如果已过期，额度会失效。
场景限制：部分免费额度仅限“在线调试”或“控制台体验”，不支持 API 调用（较少见，但需确认）。
3. 检查账户余额与欠费状态
即使有免费额度，如果账户处于欠费或停服状态，API 调用可能会被阻断。
操作步骤：
进入 阿里云费用中心。
检查账户余额是否为负数。
检查是否有未支付的订单。
重要：阿里云的抵扣顺序通常是：免费额度 > 资源包 > 按量付费（余额）。但如果账户欠费，所有服务（包括免费额度）都可能被暂停。请先充值恢复账户正常状态。
4. 检查 API Key 与权限
Key 的有效性：确认您使用的 API Key 是当前账号下创建的，且状态为“正常”。如果 Key 被禁用或删除，会报错。
RAM 子账号权限：如果您使用的是 RAM 子账号（非主账号）：
主账号虽然实名，但子账号可能没有
AliyunDashScopeFullAccess权限。解决方法：联系主账号管理员，在 RAM 控制台给该子账号授予
AliyunDashScopeFullAccess策略。
5. 查看具体的报错信息
“无法使用”的具体表现是什么？不同的报错对应不同的解法：
报错
InvalidApiKey：Key 写错了，或者 Key 属于另一个账号。报错
InsufficientBalance(余额不足)：说明免费额度已用完/过期，或者您调用的模型不在免费范围内，而账户余额为 0。
解决：充值或切换回
qwen-turbo模型。报错
QPSExceeded：免费额度通常有 QPS 限制（如 2 QPS），并发太高会被限流。报错
ResourceNotFound：该模型在您所在的地域未开放，或未开通服务。
6. 特殊场景：新注册用户 vs 老用户
新用户定义：阿里云对“新用户”定义严格。如果您以前用同一个手机号、身份证或支付宝注册过阿里云（哪怕只是买过一台最便宜的 ECS），都可能不算“百炼新用户”，从而无法领取新人免费包。
企业实名：部分免费活动仅限“个人实名”，如果您是用“企业营业执照”实名的，可能无法参与个人用户的免费活动。
✅ 快速自救清单
去控制台看一眼：登录百炼控制台，看“免费额度”页面是否有剩余量，是否显示“已领取”。
换模型测试：将代码中的模型改为
qwen-turbo，再次尝试调用。查余额：确保阿里云账户没有欠费。
看日志：查看 API 返回的具体 JSON 错误信息（
code和message字段），这是最准确的诊断依据。
如果以上都确认无误仍无法使用，建议直接在阿里云控制台提交工单，附上您的 Account ID 和 API 调用失败的 RequestID，技术人员可以后台查询具体拦截原因。