如果你想让自有系统顺利接入纳米AI的搜索能力，整个对接流程通常离不开三个核心步骤：先申请 API Key，再完整配置请求头，最后按照接口规范构造请求体，这三步必须形成完整闭环。具体来说，需要先登录开发者平台创建密钥，并勾选 nano-search 权限，同时安全保存这组 32 位密钥；请求头中必须包含 Authorization（Bearer + 密钥）、Content-Type 和 Accept；至于请求体，则需采用 JSON 格式，并包含 query、limit 等关键字段。
要让自有系统成功调用纳米AI搜索接口，必须完成 API Key 申请、HTTP 请求头配置、请求体构造这三个关键环节，缺一不可，否则接口通常会持续返回 401 或 422 错误。
获取并安全保存API Key
第一步：先进入纳米AI开发者平台正式站（https://developer.n.cn/），使用手机号或已有账号完成登录。
第二步：登录后进入「API管理」页面，点击「创建新密钥」按钮。
第三步：接着填写密钥名称（例如“客服知识库搜索”），并勾选「nano-search」服务权限——【如果这一项没有勾选，后续所有纳米AI搜索请求都会被系统直接拒绝】。
第四步：确认提交后，系统会生成一串由 32 位字母和数字组成的密钥字符串；这组 API Key 只会在首次弹窗中完整展示，页面关闭后将无法再次查看，【务必当场复制并妥善保存到密码管理器或加密文本文件中，避免截图，也不要以明文形式保存在桌面】。
配置HTTP请求头
所有纳米AI搜索接口调用都必须携带三类请求头：
Content-Type: application/json
Accept: application/json
Authorization: Bearer 后接你刚复制的完整密钥字符串
注意：Bearer 与密钥之间必须保留一个英文空格，且密钥前后不能出现多余空格或换行符；如果使用 curl 命令测试，可直接写成：-H "Authorization: Bearer sk-abc123xyz"。
构造并发送搜索请求体
方法一：使用curl命令行快速验证接口是否可用
打开终端，粘贴以下命令（将 sk-xxx 替换为你自己的 API Key，query 参数建议按需进行 URL 编码处理）：
curl -X POST "https://api.nano-ai.com/search/v1/query" -H "Authorization: Bearer sk-abc123xyz" -H "Content-Type: application/json" -d '{"query":"钙钛矿电池效率提升路径","limit":5,"domain":"energy"}'
方法二：Python脚本调用（需已安装requests库）
新建 search_test.py 文件，写入：
import requests
api_key = "sk-abc123xyz"
url = "https://api.nano-ai.com/search/v1/query"
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
data = {"query": "钙钛矿电池效率提升路径", "limit": 5, "domain": "energy"}
res = requests.post(url, headers=headers, json=data)
print(res.json())
运行命令：python search_test.py。
方法三：Postman图形化调试
新建 Request → URL 栏填入 https://api.nano-ai.com/search/v1/query → Headers 页添加三项字段 → Body 页选择 raw → JSON 格式 → 输入{"query":"钙钛矿电池效率提升路径","limit":5} → 点击 Send，即可快速测试纳米AI搜索接口返回结果。