本文档面向平台的普通用户,介绍如何注册账号、管理额度、创建令牌(API Key)、通过 API 或客户端调用模型,以及查看用量与计费。
目录
1. 平台简介
New API 是一个 AI 接口网关与资产管理系统。它将 OpenAI、Claude、Gemini、Midjourney、Suno 等多种上游 AI 服务聚合在统一的接口后面,你只需要一个账号和一个令牌,就可以用 OpenAI 兼容的格式调用多种模型,并由平台统一完成鉴权、计费、限流和用量统计。
对你来说,使用流程非常简单:
注册 / 登录账号;
在钱包中充值或兑换额度;
创建一个令牌(
sk-开头的 API Key);把
https://你的站点地址当作 OpenAI 的 Base URL,配合令牌调用模型。
2. 快速上手
2.1 注册与登录
打开站点首页,点击「注册」进入注册页面。
填写用户名、密码、邮箱(目前支持邮箱有:gmail.com、163.com、126.com、qq.com、hotmail.com、icloud.com、yahoo.com)。
注册完成后自动登录;之后可通过用户名/邮箱 + 密码登录。
忘记密码时,点击登录页的「忘记密码」,通过邮箱接收重置链接完成密码重置。
2.2 三步完成第一次调用
第一步:确认余额。 登录后进入「钱包」页面查看当前额度。新用户有站点赠送的初始额度(0.5 CNY)。
第二步:创建令牌。 进入「令牌」页面,点击「添加令牌」,填写名称后保存,复制生成的 sk- 开头的密钥(详见第 5 节)。
第三步:发起请求。 以 OpenAI 兼容格式调用,把 Base URL 换成你的站点地址:
curl https://你的站点地址/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxxxxxx" \
-d '{
"model": "gpt-4o-mini",
"messages": [{"role": "user", "content": "你好"}]
}'
也可以在控制台「游乐场(Playground)」里直接选择想测试的分组以及模型进行对话测试,无需写代码(见第 8 节)。
3. 账号管理
登录后点击右上角头像进入「个人资料」(/profile),可管理以下内容:
基本信息:头像、用户名、邮箱等;
系统访问令牌:生成用于访问个人管理接口的 access token(区别于调用模型的
sk-令牌);安全设置:
Passkey:注册通行密钥用于免密登录和敏感操作验证;
两步验证(2FA):绑定 TOTP 验证器(如 Google Authenticator),并可生成备用恢复码;
登录设备管理:查看当前所有登录会话,一键退出其他设备;
邀请与收益:查看邀请码(aff),通过邀请获得的奖励可转入余额。
每日签到:每日签到领取随机额度。
4. 额度与钱包
4.1 额度单位
本平台参考官方模型价格均以美元计费,为方便管理与计算,本平台基础设置基础优惠为 中美比例 1:1。及平台所有模型有0.14倍率优惠。
平台内部以「额度(quota)」计费,默认 500,000 额度 = $1(站点可在设置中改为以人民币等币种显示)。每次调用模型后,按模型的计价比率和实际消耗的 token 数(或图片张数、视频时长等)从你的余额中扣费。
4.2 充值与兑换
在「钱包」(/wallet)页面可以进行:
在线充值(暂未开通):选择充值金额,通过站点配置的支付渠道付款(易支付、Stripe、Creem 等,以页面显示为准);
兑换码充值:可以在钱包页面或https://catfk.com/shop/cc.code购买。在钱包页或「兑换码」页面输入兑换码,将码内额度充入余额;
邀请奖励划转:把推广奖励额度转入可用余额;
订阅套餐:如果站点开放了订阅计划,可以按周期购买套餐额度;
每日签到:如果站点开启了签到功能,可每日领取少量额度。
4.3 计费方式速览
不同模型的计费方式不同,常见规则如下(具体价格以「模型定价」页为准):
调用失败(上游报错、参数校验不通过等)不扣费;已预扣的额度会退回。
5. 令牌(API Key)管理
令牌是你调用 API 的凭证,格式为 sk- + 随机字符串。进入「令牌」(/keys)页面管理:
5.1 创建令牌
点击「添加令牌」,可配置以下选项:
创建后立即复制并妥善保存密钥。列表中只显示掩码形式,需要时可通过「复制/查看」操作重新获取完整密钥。
5.2 令牌安全建议
不要把令牌提交进代码仓库或分享给他人;泄露后在令牌页点「删除」即可立即作废;
不同用途创建不同令牌:配合「固定额度 + 模型限制 + IP 白名单」,可以把泄露的影响降到最低;
长期不用的令牌及时删除或设为过期。
6. 调用 API
6.1 通用约定
Base URL:
https://你的站点地址(不带路径),接口路径与官方一致;鉴权:
Authorization: Bearer sk-你的令牌(Claude 格式用x-api-key,Gemini 格式用x-goog-api-key或?key=);模型列表:
GET /v1/models返回你当前可用分组下的全部模型,网页端「模型」页(/models)也可查看。
6.2 支持的接口族
平台兼容多套主流 API 协议,常见端点包括:
可用模型及其分组取决于站点接入的渠道;调用未授权的模型会返回权限错误。
6.3 常用调用示例
OpenAI SDK(Python)
from openai import OpenAI
client = OpenAI(
api_key="sk-你的令牌",
base_url="https://你的站点地址/v1",
)
resp = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "你好"}],
stream=True,
)
for chunk in resp:
print(chunk.choices[0].delta.content or "", end="")
Claude(Anthropic 格式)
curl https://你的站点地址/v1/messages \
-H "x-api-key: sk-你的令牌" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "你好"}]
}'
Gemini
curl "https://你的站点地址/v1beta/models/gemini-2.5-pro:generateContent?key=sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{"contents": [{"parts": [{"text": "你好"}]}]}'
图片生成
curl https://你的站点地址/v1/images/generations \
-H "Authorization: Bearer sk-你的令牌" \
-H "Content-Type: application/json" \
-d '{"model": "dall-e-3", "prompt": "一只在月球上喝咖啡的猫", "n": 1, "size": "1024x1024"}'
6.4 流式输出与重试
支持
stream: true的 SSE 流式返回;计费在流结束后按实际 token 结算;令牌选择
auto分组并开启跨分组重试时,渠道失败可自动切换到其他分组重试;建议在客户端设置合理超时,并对 429 / 5xx 做指数退避重试。
7. 在第三方客户端中使用
大多数支持自定义 OpenAI Base URL 的客户端都可以直接接入,通用配置:
API 地址 / Base URL:
https://你的站点地址(部分客户端要求带/v1)API Key:你的
sk-令牌模型:填「模型」页中列出的任意模型名
常见客户端示例:
8. 控制台功能一览
登录后顶部 / 侧边导航中的主要页面:
9. 常见问题
Q:令牌复制后还能再看到完整密钥吗?
A:列表默认显示掩码。可通过令牌的「复制密钥」操作重新获取完整 sk- 密钥;如果担心泄露,直接删除重建更稳妥。
Q:为什么返回「无可用渠道」或「模型不可用」?
A:说明当前分组下没有提供该模型的渠道,或令牌开启了模型限制但未包含该模型。换一个可用模型、调整令牌的分组/模型限制,或联系管理员。
Q:扣费是怎么算的?
A:按实际消耗结算:对话类按输入/输出 token × 模型比率;图片按张数与规格;视频按时长。每次调用的明细可在「使用日志」中查看。
Q:调用失败会扣钱吗?
A:不会。失败请求的预扣额度会自动退回;如对某条记录有疑问,可在日志中核对或联系管理员。
Q:余额为负 / 不足时会怎样?
A:请求会在预扣费阶段被拒绝(余额不足错误)。请及时充值;固定额度的令牌消耗完后同样会拒绝请求。
Q:如何限制某个令牌的调用范围?
A:创建/编辑令牌时设置模型限制、固定额度、过期时间和 IP 白名单即可。
Q:如何查看每天的消耗趋势?
A:「仪表盘」页提供按时间 / 模型维度的统计图表;「使用日志」页支持按令牌、模型、时间筛选导出明细。
Q:忘记密码怎么办?
A:在登录页使用「忘记密码」,通过绑定邮箱接收重置邮件。未绑定邮箱请联系站点管理员协助重置。