纳米AI API Key接入搜索接口操作步骤

要让自有系统调用纳米AI搜索能力，必须完成API Key申请、请求头配置、请求体构造三步闭环。需登录开发者平台创建密钥并勾选nano-search权限，安全保存32位密钥；请求头必含Authorization（Bearer+密钥）、Content-Type和Accept；请求体为JSON格式，含query、limit等字段。

要让自有系统调用纳米AI搜索能力，必须完成API Key申请、请求头配置、请求体构造三步闭环，缺一不可，否则会持续返回401或422错误。

获取并安全保存API Key

第一步：访问纳米AI开发者平台正式（https://developer.n.cn/），使用手机号或已有账号登录。

第二步：进入「API管理」页面，点击「创建新密钥」按钮。

第三步：填写密钥名称（例如“客服知识库搜索”），勾选「nano-search」服务权限——【未勾选此项将导致后续所有搜索请求被拒绝】。

第四步：点击确认后，系统生成一串32位字母数字组合的密钥字符串；该密钥仅在首次弹窗中完整显示，关闭页面即无法再次查看，【必须立即复制并存入密码管理器或加密文本文件，切勿截图或明文保存在桌面】。

配置HTTP请求头

所有搜索接口调用必须携带三类请求头：

Content-Type: application/json

Accept: application/json

Authorization: Bearer 后接你刚复制的完整密钥字符串

注意：Bearer与密钥之间需保留一个英文空格，且密钥前后不能有多余空格或换行符；若用curl命令测试，可直接写为：-H "Authorization: Bearer sk-abc123xyz"。

构造并发送搜索请求体

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

打开终端，粘贴以下命令（将sk-xxx替换为你自己的密钥，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。