需先完成开发者平台实名认证并申请API密钥，再按规范配置HTTP请求头（含Authorization、Content-Type、Accept）、构造合法JSON请求体，最后通过Postman或Python requests调用验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将纳米AI的智能搜索或大模型能力集成到自有应用中，但尚未获取API密钥或不清楚如何构造有效请求，则可能是由于未完成开发者平台认证或请求配置不合规。以下是完成申请与使用的具体步骤：
一、注册账号并申请API密钥
API密钥是调用纳米AI服务的身份凭证，必须通过其官方开发者平台实名注册后生成，且每个密钥可绑定权限范围与调用配额。
1、访问纳米AI开发者平台官网（https://developer.n.cn/），使用手机号或已有账号登录。
2、进入「API管理」页面，点击「创建新密钥」按钮。
3、填写密钥名称（如“生产环境-搜索服务”），勾选所需服务权限（例如 nano-search、nano-chat、nano-mcp）。
4、点击确认后，系统立即生成一串由字母和数字组成的密钥字符串，该密钥仅在首次展示时可完整复制，请务必立即保存至安全位置。
二、配置HTTP请求头与基础参数
所有API调用均需通过标准HTTP协议发起，请求头中必须携带身份认证信息，否则将返回401错误；同时需明确指定内容类型与接收格式，确保服务端能正确解析请求。
1、设置请求方法为POST（部分查询类接口支持GET，但推荐统一使用POST）。
2、在Headers中添加以下三项必填字段：
Content-Type：application/json
Accept：application/json
Authorization：Bearer 后接您复制的完整API密钥字符串
三、构造合法的请求体（Body）
请求体采用JSON格式，结构需严格遵循对应接口文档定义，不同服务（如搜索、对话、MCP工具调用）字段差异显著，不可混用。
1、对于纳米AI搜索接口（https://api.nano-ai.com/search/v1/query），Body至少包含query字段：
{ "query": "钙钛矿太阳能电池最新综述", "limit": 10, "domain": "materials-science" }
2、对于Nano-Banana-2对话接口（https://api.nano-ai.com/v1/chat/completions），Body需含model与messages数组：
{ "model": "nano-banana-2", "messages": [ { "role": "user", "content": "解释量子退火原理" } ] }
纳米AI是一款基于人工智能大模型技术开发的智能应用工具，主要用于提供AI问答、内容生成、信息整理与智能搜索辅助等功能。用户可通过自然语言交互方式获取结构化信息与文本内容，用于学习、办公及内容创作等多种场景。
3、所有字符串值必须使用双引号包裹，JSON语法必须严格合法，否则返回400错误。
四、使用Postman进行快速验证
Postman提供图形化界面，可避免手写代码出错，适合前端开发者与产品人员快速验证接口可用性及响应结构。
1、新建Request，粘贴目标URL（如https://api.nano-ai.com/search/v1/query）。
2、切换至Headers标签页，逐项填入上一步配置的三个Header字段。
3、切换至Body → raw → JSON，粘贴已校验的JSON请求体。
4、点击Send，观察下方Response区域中的Status码与返回内容；成功响应状态码恒为200，且body中含data或choices字段。
五、在Python中发起调用（requests库示例）
Python是主流后端语言之一，使用requests库可简洁实现稳定调用，适用于服务端集成场景。
1、确保已安装requests：pip install requests
2、编写脚本，定义URL、headers、payload变量：
import requests
url = "https://api.nano-ai.com/search/v1/query"
headers = { "Authorization": "Bearer sk-nano-xxxxxx-xxxxxx", "Content-Type": "application/json" }
payload = { "query": "石墨烯导热性能文献", "limit": 5 }
3、发起POST请求并捕获响应：
response = requests.post(url, headers=headers, json=payload)
4、必须检查response.status_code == 200，且response.json()可正常解析，否则需根据error字段排查。
