纳米AI的API Key必须从官方开发者平台实名注册生成，且仅限服务端私钥（sk-/or-/fw-开头），第三方工具配置时需正确填写密钥、Base URL及Authorization请求头，验证时应检查状态码200与响应字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想用Obsidian、Typora或Notion这类第三方工具调用纳米AI的文本生成、搜索或MCP工具能力，但卡在API Key配置环节——密钥填不进去、报错401、提示“invalid credentials”，问题往往出在密钥来源、格式或请求头写法上。
确认API Key来源与类型
纳米AI的API Key必须从官方开发者平台（https://www.php.cn/link/f34d3f5532b0dce1ef66eb6c5a5c7db9）实名注册后生成，不能使用客户端内“账户与API”页显示的登录令牌（token）或MCP工具预置密钥替代。前者是OAuth 2.0短期会话凭证，后者仅限纳米AI App内部调用，【两者均无法用于第三方HTTP请求】。
登录开发者平台后，在「API管理」→「创建新密钥」中勾选 nano-chat、nano-search 或 nano-mcp 权限，生成的密钥字符串以 sk-、or- 或 fw- 开头，长度为48～64位字符。
若密钥以 pk_、rk_、api_ 开头，说明你复制的是前端公钥或测试密钥，立即返回平台删除并新建一个服务端私钥。
在第三方工具中填写API Key
不同工具配置位置差异较大，需按实际界面操作：
方法一：Obsidian + Text Generator插件
打开设置 → 社区插件 → 找到Text Generator → 点击设置图标 → 在「API Key」输入框中粘贴完整密钥字符串 → 在「API Base URL」栏填入 https://api.nano-ai.com → 保存。
方法二：Typora + 自定义脚本
偏好设置 → 高级 → 勾选「启用自定义CSS/JS」→ 点击「打开用户脚本目录」→ 新建 nanoai.js 文件，写入：const API_KEY = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
注意：此处必须用双引号包裹密钥，且【不可换行、不可含空格、不可添加注释符号//】。
方法三：Notion AI集成（需通过Zapier或Make）
进入Zapier → 创建Zap → 触发应用选Notion → 动作应用选「HTTP」→ 方法选POST → URL填 https://api.nano-ai.com/v1/chat/completions → Headers里手动添加 Authorization 字段，值为 Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。
验证配置是否生效
第一步：在第三方工具中发起最简请求，例如向 nano-chat 接口发送空消息体：
POST https://api.nano-ai.com/v1/chat/completions
Headers：
Content-Type: application/json
Accept: application/json
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Body：
{ "model": "nano-banana-2", "messages": [{ "role": "user", "content": "hi" }] }
第二步：观察响应状态码。返回200且body含"choices"字段即成功；若返回401，检查密钥是否复制完整、是否多粘了一个空格；若返回403，说明密钥未勾选 nano-chat 权限，需回开发者平台编辑该密钥权限。
第三步：在第三方工具界面触发一次实际调用（如Obsidian中选中文本→右键→“用纳米AI润色”），确认结果正常返回且无乱码——乱码通常因未声明 Accept: application/json 导致，此时需补全该Header。
