鉴权 | NanoAPI

每个请求都用 API Key 鉴权，以 Bearer Token 的形式放在请求头里。

在控制台 → API Keys 创建 Key，Key 以 nf_ 开头。每个请求都在 Authorization 请求头里带上 Key：

Authorization: Bearer nf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl https://api.nanoapi.ai/v1/balance \
  -H "Authorization: Bearer $NANOAPI_API_KEY"

Key 不存在、已删除或已被重置时，返回 401 invalid_api_key。

Key 可以直接花费你的余额。只在服务端使用，不要放进前端、移动端代码或公开仓库。

管理 Key

完整的 Key 只显示一次，在创建或重置时。请放进密钥管理服务或环境变量。
重置 Key 后，旧 Key 立即失效，还在用它的程序会马上收到 401。不停机更换：先创建新 Key 并部署，再删除旧 Key。
可以创建多个 Key，各有自己的名字。每个任务都在 api_key 字段里记录创建它的 Key（id、name、prefix），任务列表可按 api_key_id 筛选。
限流按用户计算，不按 Key：同一用户的所有 Key 共享限额。

以下操作只能在控制台进行，不提供 API：

在控制台 → API Keys 创建 Key，Key 以 nf_ 开头。每个请求都在 Authorization 请求头里带上 Key：

Authorization: Bearer nf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl https://api.nanoapi.ai/v1/balance \
  -H "Authorization: Bearer $NANOAPI_API_KEY"

Key 不存在、已删除或已被重置时，返回 401 invalid_api_key。

Key 可以直接花费你的余额。只在服务端使用，不要放进前端、移动端代码或公开仓库。

完整的 Key 只显示一次，在创建或重置时。请放进密钥管理服务或环境变量。
重置 Key 后，旧 Key 立即失效，还在用它的程序会马上收到 401。不停机更换：先创建新 Key 并部署，再删除旧 Key。
可以创建多个 Key，各有自己的名字。每个任务都在 api_key 字段里记录创建它的 Key（id、name、prefix），任务列表可按 api_key_id 筛选。
限流按用户计算，不按 Key：同一用户的所有 Key 共享限额。

以下操作只能在控制台进行，不提供 API：