纳米AI API Key接入Python项目教程

要正常调用纳米AI的 API，第一步不是写代码，而是先把 API Key 配好；这一步如果没做好，接口通常会直接返回 HTTP 401，或者提示“invalid api key”。需要注意的是，Key 必须在正式控制台中创建，而且只会显示一次，因此更稳妥的做法是通过 .env 文件或 config.py 安全保存，绝对不要把它硬编码后提交到 Git。实际调用时，还要提前安装 requests 和 python-dotenv，正确配置 Authorization 请求头与相关请求参数，同时记得检查响应状态码，确认请求是否真正成功。

将纳米AI的API Key接入Python项目，是调用其文本生成、对话或嵌入模型的前提，缺少这步配置会导致HTTP 401错误或“invalid api key”响应。

获取纳米AI API Key

登录纳米AI正式控制台 → 点击右上角头像 → 进入「API密钥管理」页面 → 点击「创建新密钥」 → 复制生成的Key字符串（以nan-开头，共48位）。

注意：该Key仅在首次生成时完整显示一次，关闭页面后无法再次查看明文。如遗忘，必须删除旧密钥并新建一个。

在Python项目中安全存储API Key

方法一：使用环境变量（推荐）
在项目根目录下新建.env文件，写入：
NANO_API_KEY=nan-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

方法二：使用config.py配置文件
新建config.py，内容为：
API_KEY = "nan-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
然后在主程序中from config import API_KEY导入。

通过requests调用纳米AI接口

第一步：安装依赖
pip install requests python-dotenv

第二步：加载环境变量并构造请求
在主脚本开头添加：
from dotenv import load_dotenv
import os, requests
load_dotenv()
api_key = os.getenv("NANO_API_KEY")

第三步：向/nano/v1/chat/completions发起POST请求
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
data = {"model": "nano-chat", "messages": [{"role": "user", "content": "你好"}]}
response = requests.post("https://api.nano.ai/v1/chat/completions", headers=headers, json=data)

第四步：检查响应状态
若response.status_code == 200，则print(response.json()["choices"][0]["message"]["content"])可输出回复；若返回401，请确认Key是否复制完整、环境变量是否加载成功、域名是否拼写正确（必须是api.nano.ai，不是nan.ai或nanoapi.ai）。