401 Unauthorized错误表明身份认证失败，核心原因包括API密钥无效（错误、过期、被撤销）、Authorization请求头格式不规范（Bearer后缺空格、Content-Type缺失）、权限未开通或密钥被代理剥离。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
纳米AI API调用时提示“API key invalid”“401 Unauthorized”或“AuthenticationError”，说明身份认证环节已中断，系统未将你的请求送入鉴权模块比对——这不一定是密钥字符串本身错了，而是认证链路在第一道门就被拦下。
先确认报错类型和状态码
打开开发者工具或日志，找到完整响应：重点看HTTP状态码（如401/403/429）和返回体中的错误字段（如"error": {"message": "Invalid API key"}）。不要跳过这一步，【401代表认证未通过，403代表有身份但无权限，429代表额度或并发超限】——三者修复路径完全不同。
如果只看到模糊提示如“请求失败”“网络异常”，请检查是否被代理、网关或SDK封装隐藏了真实状态码；可临时改用curl命令直连验证：
curl -X POST https://api.nano-ai.com/v1/chat/completions \-H "Authorization: Bearer sk-nano-xxxxx" \-H "Content-Type: application/json" \-d '{"model":"nano-banana-2","messages":[{"role":"user","content":"hi"}]}'
排查API Key本身是否有效
方法一：核对密钥来源与格式
登录纳米AI开发者平台→进入「API管理」→确认当前使用的Key状态为“Active”，且创建时间未早于2026年7月15日（旧版密钥已于该日期起逐步停用）。【密钥必须以sk-nano-开头，长度为32位以上字母数字组合，不含下划线或中文字符】
方法二：检查复制过程是否带入隐藏字符
在终端执行：echo "你的密钥" | xxd | head -n 2。若输出中出现0a（换行）或20（空格）等非打印字符，说明粘贴时混入了不可见符号。此时应回到平台页面，点击「重新显示」按钮，用鼠标拖选后手动复制，勿用Ctrl+A全选。
纳米AI是一款基于人工智能大模型技术开发的智能应用工具，主要用于提供AI问答、内容生成、信息整理与智能搜索辅助等功能。用户可通过自然语言交互方式获取结构化信息与文本内容，用于学习、办公及内容创作等多种场景。
方法三：验证环境变量是否生效
若Key通过环境变量注入（如NANO_API_KEY=sk-nano-xxx），运行printenv NANO_API_KEY确认值存在且无引号包裹。常见错误是写成NANO_API_KEY="sk-nano-xxx"，导致程序读取到的值包含双引号。
检查请求头Authorization字段构造
第一步：确认Header键名拼写为Authorization，不是Authrization或X-API-Key。
第二步：确认值格式为Bearer sk-nano-xxxxx，中间有且仅有一个空格，【Bearer后不能重复写一次，也不能漏掉Bearer前缀】。错误示例：Bearer Bearer sk-nano-xxx或sk-nano-xxx都会触发401。
第三步：检查是否被中间层剥离。如果你使用了Nginx网关、Cloudflare Workers或自建API中转服务，请确认其配置中包含proxy_set_header Authorization $http_authorization;，否则Authorization头会在转发时丢失。
验证模型权限与服务开通状态
① 登录开发者平台 → 进入「API管理」→ 点击对应密钥右侧「编辑权限」→ 检查是否勾选了你正在调用的服务，例如nano-chat（对话）、nano-search（搜索）或nano-mcp（工具调用）。未勾选即无权限，会返回403而非401。
② 若调用的是/v2/check/text等校对接口，需确认密钥已开通nano-check子权限。该权限默认关闭，需手动开启并保存。
③ 查看账户余额页（https://www.php.cn/link/f34d3f5532b0dce1ef66eb6c5a5c7db9billing），确认「可用配额」大于0。即使Key有效，额度耗尽也会返回403 Forbidden，而非401。
