OpenAI 兼容接口 / Claude / Gemini / 常用客户端

把 NewAPI AI 接入你的工具和代码

这里整理了中转站用户最常用的配置方式:创建 API Key、填写接口地址、 接入 Cherry Studio、LobeChat、ChatBox、OpenCat,以及排查余额、模型名和限速问题。

Base URL https://newapiai.com/v1

客户端里填写 Base URL,不要把完整的 /chat/completions 当作地址。

快速开始

  1. 注册或登录 newapiai.com
  2. 进入控制台,充值余额或购买适合自己的套餐。
  3. 打开 API 密钥页面,创建一个新的 API Key。
  4. 在客户端或代码里填写 Base URL:https://newapiai.com/v1
  5. 模型名称按控制台展示填写,先用一个小请求测试连通性。

接口地址

类型 填写地址 说明
OpenAI 兼容 https://newapiai.com/v1 适合大多数客户端和代码 SDK。
聊天补全 /v1/chat/completions 这是请求路径,不是客户端 Base URL。
模型列表 /v1/models 用于查看当前 Key 可访问的模型。

模型说明

模型名称以控制台和客户端可见列表为准。不同模型价格、速度、上下文长度可能不同; 如果提示模型不存在,先检查模型名是否完整复制,再确认账号余额、套餐和分组权限。

不建议把模型名写死在公开教程里。模型会随上游变化更新,实际可用列表以控制台为准。

常用客户端接入

Cherry Studio

添加 OpenAI 兼容提供商,Base URL 填 https://newapiai.com/v1,API Key 填控制台创建的密钥。

LobeChat

在 OpenAI 配置里填写 API Key,并把代理地址或 Base URL 设置为 https://newapiai.com/v1

ChatBox / NextChat

选择 OpenAI API 类型,接口地址填 Base URL,模型名按控制台可用模型填写。

OpenCat

团队或自定义服务地址填 https://newapiai.com,Token 填 API Key。

代码 SDK

使用 OpenAI SDK 时,将 base_urlbaseURL 改为 https://newapiai.com/v1

其他工具

只要支持 OpenAI 兼容接口,一般都可以接入。关键是 Base URL、API Key、模型名三项要一致。

调用示例

YOUR_API_KEY 换成你自己的 API Key,把 模型名称 换成控制台可用模型。

curl https://newapiai.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "模型名称",
    "messages": [
      {"role": "user", "content": "你好,请简单介绍一下你自己"}
    ]
  }'

Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://newapiai.com/v1",
)

resp = client.chat.completions.create(
    model="模型名称",
    messages=[{"role": "user", "content": "你好"}],
)

print(resp.choices[0].message.content)

余额、套餐和计费

  • 余额用于普通 API 调用,不同模型按不同价格扣费。
  • 套餐权益以购买页面展示为准,到期或用量耗尽后需要续费或切换余额调用。
  • 失败请求是否扣费取决于是否已经产生上游消耗,具体以使用记录为准。
  • 控制台的使用记录可以查看请求时间、模型、消耗和失败原因。

常见错误处理

错误 常见原因 处理方法
401 API Key 错误或没有带 Authorization 重新复制 Key,确认格式是 Bearer sk-...
403 账号权限、分组或余额限制 检查余额、套餐、账号状态和模型权限。
404 model not found 模型名填错或当前 Key 无权限 从控制台复制模型名,或换一个可用模型测试。
429 请求过快或达到限速 降低并发,增加重试间隔,必要时联系客服。
insufficient quota 余额不足或套餐额度不足 充值、续费套餐,或换用可用额度。

API Key 安全

  • 不要把 API Key 发给别人,也不要提交到公开代码仓库。
  • 不同软件建议创建不同 API Key,方便单独停用。
  • 怀疑泄露时,立即删除旧 Key 并创建新 Key。
  • 服务端项目建议使用环境变量保存 Key,不要写死在前端代码里。

客服与售后

遇到充值不到账、模型不可用、调用报错或客户端配置问题,可以通过主站右下角在线客服联系。 反馈时建议提供账号、请求时间、模型名、错误码和截图,不要直接发送完整 API Key。

打开主站联系客服

分销中心说明

NewAPI AI 保留邀请关系,但佣金以分销中心规则为准。通常需要开通有效分销套餐或由管理员授权后, 后续符合规则的充值订单才会产生佣金。套餐购买、佣金统计和提现信息请以分销中心页面为准。

通过上级邀请注册的账号不能直接购买分销套餐;如需成为独立分销商,请重新注册独立账号或联系客服处理。