API 使用教程

本地 AI（LM Studio）通过 Cloudflare 暴露的 OpenAI 兼容接口。需要人工审批的 key。

申请 API Key

1. 基础信息

Base URL：https://ai.nnnnagato.dev/v1

认证：请求头 x-api-key: nk_...，也支持 Authorization: Bearer nk_...

兼容：OpenAI Chat Completions 格式，Chatbox / LobeChat / OpenAI SDK 都能接。

每日默认 200 次请求，响应头会带 x-quota-limit 和 x-quota-used。

2. 模型列表

下面是网关当前实际加载的模型（实时读取）。

读取中…

也可以直接请求 GET /v1/models（需要 key）。

3. 快速开始

curl

curl https://ai.nnnnagato.dev/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "x-api-key: nk_your_key" \
  -d '{
    "model": "your-model-id",
    "messages": [{"role": "user", "content": "你好"}]
  }'

JavaScript

const r = await fetch("https://ai.nnnnagato.dev/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "nk_your_key"
  },
  body: JSON.stringify({
    model: "your-model-id",
    messages: [{ role: "user", content: "你好" }]
  })
});
console.log(await r.json());

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.nnnnagato.dev/v1",
    api_key="nk_your_key",
)

resp = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

4. 常用参数

参数	说明
`model`	模型 ID，见上面的列表
`messages`	对话数组，role 为 system / user / assistant
`stream`	true 时流式返回（SSE）
`temperature`	随机度，0～2
`max_tokens`	最多生成多少 token

5. 错误码与配额

状态	含义 / 处理
200	正常
401	key 缺失、错误或已吊销 → 检查 `x-api-key`
429	当天次数用完 → 看 `x-quota-*`，次日 0 点（北京时间）重置
502	本地模型没开 / 网关连不上 → 稍后再试

额度、吊销都由管理员在后台控制；不要把自己的 key 发到公开群。

6. 可以用在哪

Chatbox / LobeChat / NextChat、OpenAI SDK、脚本、浏览器 fetch 都行。Base URL 填 https://ai.nnnnagato.dev/v1，API Key 填发给你的 nk_...。

← 回主页 · 申请 key