5 分钟快速开始

开始前需要一个 NaNLab API Key 和控制台实际显示的模型 ID。

1. 设置环境变量

export NANLAB_API_KEY="sk-YOUR_NANLAB_API_KEY"
export NANLAB_MODEL="YOUR_AVAILABLE_MODEL_ID"

2. 查询模型

curl -sS https://sub.nanlabapi.top/v1/models \
  -H "Authorization: Bearer $NANLAB_API_KEY"

3. 发起 Responses 请求

curl -sS https://sub.nanlabapi.top/v1/responses \
  -H "Authorization: Bearer $NANLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_AVAILABLE_MODEL_ID","input":"用一句话说明 API 网关的作用。"}'

需要流式输出时加入 "stream": true，并给 curl 增加 -N。

4. 检查消费记录

回到控制台「用量记录」，确认模型、输入/输出 token、费用、状态码与调用时间。

状态	优先检查
401	Key 是否完整、是否误用登录令牌、Authorization 是否为 Bearer
403	Key 状态、分组权限、余额/订阅与平台配额
404	Base URL 是否重复或漏写 /v1，接口协议是否匹配
429	Key 限流、并发、订阅窗口额度或上游账号冷却
5xx	查看错误记录，稍后指数退避重试