纳米AI API Key调用失败主因是认证网关拦截，需检查密钥完整性、前缀有效性、Authorization头格式（Bearer+单空格）、Base URL匹配性及环境变量引号污染。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
纳米AI API Key调用失败时，无法正常发起搜索、对话或MCP工具调用请求，服务端直接返回401 Unauthorized或Invalid API key错误，说明身份认证链路在第一道网关就被拦截，根本未进入密钥比对环节。
确认API Key是否完整粘贴且格式合规
第一步：打开纳米AI客户端设置页→点击「账户与API」→确认「API Key」输入框中已粘贴完整密钥字符串。
第二步：复制密钥时务必从原始平台（如OpenRouter、Fireworks.ai或NanoAI控制台）的「Copy」按钮获取，【手动输入或截断末尾字符会导致401认证失败】。
第三步：密钥开头应为“sk-”“or-”“fw-”等有效前缀，若以“pk_”“rk_”开头，说明误用了前端公钥，需更换为服务端私钥。
验证请求头Authorization字段是否构造正确
方法一：检查Bearer前缀与密钥之间是否有一个且仅有一个空格
错误写法：Authorization: Bearer sk-xxx（多一个Bearer）或Authorization: Bearer sk-xxx（多一个空格）都会被网关拒绝。
方法二：确认未混用其他平台规范
OpenAI兼容接口必须用Authorization: Bearer sk-xxx；Azure要求用api-key: xxx；纳米AI只认前者，用后者必报401。
方法三：排查环境变量注入是否带引号或换行符
若通过export NANO_API_KEY="sk-xxx"设置，双引号会随值一起传入请求头，导致密钥实际变成"sk-xxx"——【引号会被当作密钥一部分，服务端查无此key】。
用最小化curl命令绕过SDK直连验证
① 打开终端，执行以下命令（替换为你的真实密钥）：
纳米AI是一款基于人工智能大模型技术开发的智能应用工具，主要用于提供AI问答、内容生成、信息整理与智能搜索辅助等功能。用户可通过自然语言交互方式获取结构化信息与文本内容，用于学习、办公及内容创作等多种场景。
curl -X POST https://api.nano-ai.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的完整密钥" \
-d '{"model":"nano-banana-2","messages":[{"role":"user","content":"hi"}]}'
② 若返回{"error":{"message":"Invalid API key","type":"invalid_request_error","param":null,"code":"invalid_api_key"}}，说明密钥本身或请求头仍有问题；若返回403或429，则证明Key已生效，问题转向权限或额度。
③ 注意：该命令必须在无代理、未设全局HTTP_PROXY的环境下运行，否则网关可能丢弃Authorization头。
检查Base URL是否与密钥所属平台匹配
纳米AI密钥只能用于https://api.nano-ai.com/及其子路径，若代码中误配为https://openrouter.ai/api/v1或https://api.fireworks.ai/v1，即使密钥正确也会触发401——因为请求根本没有抵达纳米AI认证网关。
查看你调用的接口文档URL，确保域名部分与密钥发放平台完全一致。例如搜索接口必须是https://api.nano-ai.com/search/v1/query，少一个/search或错写成/v1/search都属无效Endpoint。
