纳米AI_API_Key接入智能体操作步骤

需确认API Key状态为启用并从平台复制完整密钥，电脑端创建智能体时在「高级设置→外部服务接入」中粘贴；API创建时需在auth_config.value字段填入纯字符串密钥，且请求头Authorization值为Bearer+密钥。

你想把纳米AI的API Key嵌入到自己创建的智能体中，让智能体调用真实后端能力而非仅靠前端模型响应，但卡在密钥配置环节——密钥粘贴后仍提示“认证失败”，或根本找不到API Key填写入口。

确认API Key有效性并完成平台绑定

登录纳米AI开发者平台（https://developer.n.cn/）→ 使用手机号+密码登录 → 进入「API管理」→ 查看已有密钥状态是否为「启用」。若显示「已禁用」或「过期」，需点击右侧【重新启用】或【生成新密钥】。

【必须从「复制」按钮获取完整密钥，手动输入易漏末尾字符导致401错误】

复制成功后，不要关闭该页面——密钥仅首次展示时可见，关闭后无法再次查看，只能重置生成。

在电脑端创建智能体时嵌入API Key

打开纳米AI电脑版（V1.3.13及以上）→ 左侧导航栏点击【智能体】→ 右上角点【创建智能体】→ 填写名称、上传头像、设置欢迎语。

滚动至页面底部「高级设置」区域 → 找到「外部服务接入」模块 → 点击【添加API凭证】→ 在弹窗中选择「纳米AI搜索」或「Nano-Banana-2对话」等服务类型 → 粘贴你刚复制的完整API Key字符串 → 点击【保存】。

此时该密钥将与当前智能体唯一绑定，后续所有调用均自动携带此凭证，无需每次请求手动拼接Header。

通过API接口动态创建带密钥的智能体

方法一：使用Python发送POST请求

准备一个含API Key的请求头：headers = {"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"}，其中YOUR_API_KEY必须是开发者平台生成的原始密钥，不能加空格或换行。

构造请求体JSON，关键字段包括name、tools列表、domain，以及新增的"auth_config": {"type": "nanoai_api_key", "value": "sk-xxx"}——【value字段必须为纯字符串，不可包裹在引号内再加引号】。

向https://api.nanoai.com/agent/create发起POST请求，返回200即表示智能体已创建并完成API Key注入。

方法二：使用curl命令行快速验证

执行以下命令（将YOUR_API_KEY替换为实际密钥）：

curl -X POST https://api.nanoai.com/agent/create

-H "Authorization: Bearer YOUR_API_KEY"

-H "Content-Type: application/json"

-d '{"name":"MyAPIAgent","tools":["nano-search"],"auth_config":{"type":"nanoai_api_key","value":"YOUR_API_KEY"}}'