new-api 用户使用文档

本站使用开源 new-api 搭建,提供与 OpenAI 完全兼容的接口。地址:https://ai.showkin.top/v1。本页面向普通用户,涵盖获取密钥、接入各种环境、账户安全与常见问题排查。

目录 1 简介 2 获取 Key 3 首次调用 4 接入配置 Python CLI/Node 客户端 5 额度计费 6 安全合规 7 排错表 8 FAQ

1 · 什么是 new-api

new-api 是一个开源的 OpenAI API 网关/中转站,它在官方接口之上做了统一接入:一个 Key 即可调用多家模型厂商(gpt、claude、gemini、deepseek、qwen 等),并提供额度计费、多 Key、日志审计等能力。你不需要分别到每家厂商申请 Key,只需使用本站发放的这一个 Key。

协议完全兼容。 本站对外暴露的是标准的 OpenAI Chat Completions 接口(/v1/chat/completions 等),所以绝大多数为 OpenAI 设计的 SDK / 客户端 / 工具,只要改一下 base_url 和 api_key 就能直接使用。

2 · 获取 API Key

  1. 打开站点首页 https://ai.showkin.top,点击「注册」创建账号(如未注册)。
  2. 登录后进入 控制台 → 令牌(Token) 页面。
  3. 点击「添加令牌 / 新建令牌」,填写描述(便于识别用途)。
  4. 创建成功后复制形如 sk-xxxxxxxxxxxxxxxx 的令牌字符串。
令牌只显示一次! 关闭弹窗或离开页面后,令牌原文无法再查看。请立即复制保存到安全的位置(建议用密码管理器)。若丢失,删除后重新创建一个即可,无需找回。

限额说明:新令牌默认可以使用你的账户余额。你可以在令牌设置里为其单独设置额度上限/过期时间,方便控制及审计。

3 · 第一次调用

拿到 Key 后,先在命令行做一次最小请求验证(把 YOUR_API_KEY 换成你的 Key):

curl https://ai.showkin.top/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role":"user","content":"你好"}]
  }'

若返回一个包含 choices[0].message.content 的 JSON,说明 Key 正常、额度可用。如果返回错误,请对照第 7 节排错表。

4 · 接入配置总览

绝大多数接入都需要设置两个关键信息,其余保持默认即可:

配置项本站应填写的值
base_url / 接口地址https://ai.showkin.top/v1
api_key / API Key你的 sk-... 令牌
model 模型名可使用站点提供的模型(见控制台「模型」列表)
不同工具对 base_url 的书写方式可能略有差异:https://ai.showkin.top/v1 与 https://ai.showkin.top 两种写法多数工具都兼容;若遇到 404,尝试补上或去掉 /v1 后缀。

4.1 Python(openai SDK)

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.showkin.top/v1",
    api_key="YOUR_API_KEY",
)

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

异步方式 AsyncOpenAI(...) 参数相同。若用 langchain,只需把 OpenAI 换成 ChatOpenAI(base_url=..., api_key=...) 或在该实例上设置这两个参数。

4.2 CLI / cURL / Node.js

Node.js(openai 官方包)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://ai.showkin.top/v1",
  apiKey: "YOUR_API_KEY",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

OpenAI CLI / 环境变量(可选)

export OPENAI_BASE_URL="https://ai.showkin.top/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

4.3 桌面客户端 & IDE

很多客户端支持自定义接口,把「Base URL」填为本站地址即可:

工具Base URL 填写备注
Chatbox / Cherry Studiohttps://ai.showkin.top/v1「提供商/提供商类型」选 OpenAI 兼容
NextChat / LobeChat(自部署)https://ai.showkin.top/v1环境变量 OPENAI_API_BASE_URL
Claude Code / Cursor 等 CLI见各自官方文档通常设 base_url 环境变量
以 Cherry Studio 为例:设置 → 模型服务 → 添加「OpenAI 兼容」服务 → 填接口地址、API Key → 模型列表里填可用模型名,即可对话。

5 · 额度与计费

token 估算:繁体/英文约每个词约 1–2 token,中文常按字形划分。压缩/控制上下文长度可显著省额度。想要核对每次调用扣费,可在控制台的日志里查看每条请求的 token 与费用明细。

6 · 安全与合规

密钥安全

令牌管理

使用规范

7 · 常见问题对照表(Troubleshooting)

调用出错时优先看返回的 HTTP 状态码和错误 JSON里的 message,再按下面处理。

现象 / 错误含义解决办法
401 Invalid Authentication / 认证失败 Key 无效或校验失败 检查 Key 是否带空格、是否写对；确认令牌未被删除/停用；重新复制粘贴 Key。
429 触发限流 (rate limit) 请求过于频繁或超出令牌并发限制 降低请求频率、增加重试间隔；多个应用请分开 Key；等待后重试。
402 Insufficient Quota / 余额不足 账户或令牌额度不足 前往个人中心充值/购买额度；为令牌单独设的额度上限已用尽时提高限额或换 Key。
404 Not Found / 模型不存在 模型名写错或未开通 在控制台「模型」列表确认可用的确切模型名；补/删 /v1 后缀。
400 参数错误 请求体格式或字段不对 对照官方 Chat Completions 格式检查 model/messages 字段；messages 必须为数组。
500 / 502 / 504 服务错误 上游模型或网关临时故障/超时 稍后重试或换一个模型；连续失败请联系站点管理员。
timeout / connection timeout 网络或网关响应超时 检查网络；加大客户端 timeout；避免单次请求过大、过长上下文。
SSL / 证书错误 本地客户端证书校验异常 确认系统时间正确；使用受信任证书的官方客户端版本(勿在产线关验证)。
还查不出来? 把完整错误信息(HTTP 状态码、错误 JSON 的 message、请求的 model 名)发给站点管理员,有助于快速定位,不要在群里只发「没反应」。

8 · FAQ 精选

Q1:我能同时用很多模型吗?

A:可以。你的 Key 可调用站点开放的所有模型,把请求里 model 换成对应的模型名即可,按各模型单价计费。

Q2:Key 丢失/泄露了怎么办?

A:Key 只显示一次,无法找回。直接删除该令牌并创建一个新的即可;若怀疑泄露,尽快停用并更新所有在用位置。

Q3:为什么余额少了但我明明没怎么用?

A:先看控制台「日志」核对每条请求的实际 token 与费用;长时间上下文、自动重试、后台任务都会持续耗用量。若日志都对得上却仍有疑虑,联系管理员。

Q4:要不要给每个应用单独一个 Key?

A:强烈建议。每个 Key 可单独设额度上限,方便审计和止损,一个应用出问题不会拖垮其它应用。

Q5:怎么让调用更省额度/更快?

A:适当缩短上下文、配合缓存、按需控制输出长度(max_tokens)、避免无效重试,并对可重试请求设置合理的退避。

Q6:站点暂时挂掉 / 无法访问?

A:先确认本机网络与 DNS;若站点故障,等官方通知,通常不用改你的代码/Key,恢复后即可继续用。

文档由站点管理员维护 · new-api 用户使用文档 · 最后更新于撰写当日