new-api 用户使用文档

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

1 · 获取 API Key

1. 打开站点首页 https://ai.showkin.top,点击「注册」创建账号(如未注册)。
2. 登录后进入 控制台 → 令牌(Token) 页面。
3. 点击「添加令牌 / 新建令牌」,填写描述(便于识别用途)。
4. 创建成功后复制形如 sk-xxxxxxxxxxxxxxxx 的令牌字符串。

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

2 · 第一次调用

拿到 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 节排错表。

3 · 接入配置总览

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

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」填为本站地址即可:

4 · 额度与计费

• 余额在控制台 → 个人中心查看,以积分(或按本站设定)计。
• 每次调用按模型单价 × 实际消耗 token扣费,输入与输出 token 分别计费。
• 充值方式以本站展示为准(通常为卡密、网盘开通或客服处理),以站点实际页面为准。
• 发送的请求包含 system prompt、历史对话,token 消耗会包含这些上下文;长对话会更耗额度。

5 · 安全与合规

密钥安全

• Key 等同于你的资金凭证,泄露会导致他人消费你的额度。
• 不要把 Key 提交到 git 仓库、粘贴到公开论坛、或写进硬编码的源码。
• 用环境变量或本地配置文件存放;.gitignore 忽略含 Key 的文件。
• 建议「一个项目一个 Key」,并设置额度上限;发现异常立即在控制台删除/停用对应令牌。

令牌管理

• 令牌可随时删除重新创建,不影响其它令牌。
• 可为不同用途令牌设独立额度上限,防止某一应用失控耗尽全部余额。
• 定期在「日志」检查是否有未知来源的调用,发现立刻吊销。

使用规范

• 请遵守站点使用条款与当地法律法规,不用于违法、侵权或恶意用途。
• 本站面向合规调用;滥用(包括绕过限流、批量盗刷等)可能导致封禁。

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

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

7 · FAQ 精选

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

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

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

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

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

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

8 · gpt-image-2 图像生成教程

gpt-image-2 是 OpenAI 新一代原生图像生成模型,基于 GPT 体系可直接生成高质量图片,也支持按提示词控制风格、构图与画面比例。本站通过 new-api 中转,提供 OpenAI 兼容的 Images API,你只需要把请求里的 model 填成 gpt-image-2,其余用法与标准 Images API 一致。

9.1 接口与参数

生成图片走 POST /v1/images/generations 接口(地址仍为 https://ai.showkin.top/v1):

9.2 cURL 快速验证

curl https://ai.showkin.top/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只穿着宇航服的橘猫坐在月球上,背后是蓝色地球,电影感打光",
    "size": "1024x1024",
    "quality": "high"
  }'

返回的 JSON 形如 {"created":..., "data":[{"b64_json":"iVBORw0KGgo=..."}]},把 data[0].b64_json 的 Base64 字符串解码为 PNG 保存即可(见 9.3 / 9.4);若设了 output_format: "url",则直接下载 data[0].url。

9.3 Python(openai SDK)

from openai import OpenAI
import base64

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

resp = client.images.generate(
    model="gpt-image-2",
    prompt="赛博朋克城市夜景,霓虹灯牌,雨夜街道,电影感广角",
    size="1024x1024",
    quality="high",
)

b64 = resp.data[0].b64_json
with open("output.png", "wb") as f:
    f.write(base64.b64decode(b64))
print("已保存 output.png")

resp.data 是图片列表:output_format="url" 时字段为 url,默认(或 b64_json)时字段为 b64_json。SDK 未显式指定时通常返回 Base64,直接按上面方式解码保存即可。

9.4 Node.js(openai 官方包)

import OpenAI from "openai";
import { writeFileSync } from "node:fs";

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

const resp = await client.images.generate({
  model: "gpt-image-2",
  prompt: "水墨风格山水画,远山云雾,孤舟蓑笠翁,留白构图",
  size: "1024x1536",
  quality: "high",
});

writeFileSync("output.png", Buffer.from(resp.data[0].b64_json, "base64"));
console.log("已保存 output.png");