你的 new-api 服务
十分钟上手指南
按这份指南从头走一遍,最多 10 分钟,你就能让自己的客户开始调用 API。不懂技术也没关系——每一步都写了你会看到什么、做完应该什么样。
你手上这张卡片是什么?
开通的时候,我们会给你发一张"交付卡片"。它长这样 ——
- 🌐 访问地址
https://你的域名- 👤 账号
root- 🔑 初始密码
••••••••••••(你的卡片里是真实密码)- 📍 服务器 IP
45.77.135.194
把这张卡片放在手边。接下来的每一步都会用到它。
能在手边看到自己的域名、账号、初始密码、服务器 IP 这四个值。缺任何一个请联系我们。
把你的域名"指"到我们服务器
你在哪里买的域名,就去哪里做这件事。下面按常见的几家分了 tab ——点你用的那家就行。
先别急,DNS 是什么?
想象 DNS 是一本"电话本"。
- 你的域名 = 联系人名字("张三")
- 服务器 IP = 电话号码(
45.77.135.194) - 改 DNS = 在电话本里把"张三"的号码改成我们的号码
别人访问你的域名时,浏览器先查电话本(DNS),拿到号码(IP),再拨过去(连到服务器)。所以你必须先告诉电话本"我的号码是 45.77.135.194"。
- 登录 dynadot.com,右上角切到中文(如果你习惯中文)。正常会看到:左上角绿色的"My Domains / 我的域名"。
- 点左侧 我的域名 → 管理域名,勾选你要用的那个域名。
- 上方操作栏点 DNS 设置。正常会看到:一个下拉框写着"Dynadot DNS / Dynadot 自有 DNS / 名称服务器"等。
- 选 Dynadot DNS(不要选 Name Servers / 名称服务器那个选项)。
- 在 主域名记录 那一行:
Record Type 选
A,IP Address 填45.77.135.194。 - 如果你要用带
www的域名,再加一条 子域名记录:子域名填www,类型A,IP 同样45.77.135.194。 - 拉到最下面点 保存 DNS(Save DNS)。
- 登录 dash.cloudflare.com,点你的域名进去。
- 左侧菜单点 DNS → 记录 / Records。
- 点 添加记录 / Add record:类型
A,名称填@(代表主域名),IPv4 地址填45.77.135.194。 - 代理状态(Proxy status)这一列必须点成灰色的云 "DNS only",不要橙色的云。橙色云 = Cloudflare 替你转发流量,会把 HTTPS 证书搞坏。
- 再加一条
A记录:名称www,IP45.77.135.194,同样 DNS only。 - 点保存。
记录那一行最右边的小云朵一定要是 灰色。橙色会导致 HTTPS 一直报错。
- 登录 阿里云控制台(或万网,万网已经并入阿里云)。
- 搜索 云解析 DNS,进入后找到你的域名。
- 点 解析设置 → 添加记录。
- 记录类型
A,主机记录填@,记录值填45.77.135.194,TTL 保持默认。 - 再加一条:主机记录
www,其他同上。 - 确定。
- 登录 腾讯云控制台,搜索 DNS 解析 DNSPod。
- 找到你的域名,点 解析。
- 点 添加记录:主机记录
@,记录类型A,记录值45.77.135.194。 - 再加一条
www。 - 保存。
- 登录 namecheap.com,Dashboard → 找到域名 → 点 Manage。
- 切到 Advanced DNS 标签。
- 点 Add New Record:Type 选
A Record,Host 填@,Value 填45.77.135.194,TTL 默认。 - 再加一条 Host =
www的 A 记录。 - 点绿色对勾保存。
- 登录 godaddy.com,右上角头像 → My Products。
- 找到域名,点右边 DNS。
- 找到类型为
A、名称为@的那行,点铅笔编辑,把"指向"改成45.77.135.194。 - 如果没有,点 Add → A:Name
@,Value45.77.135.194。 - 再加一条 Name
www。保存。
不论在哪家注册的,你要做的就一件事——
找到域名的 DNS 管理 / 解析设置,添加一条 A 记录:主机/Host 填 @,值填 45.77.135.194。再加一条把 Host 改成 www。保存。
找不到入口就把服务商名字发给我们,我们帮你定位。
A 记录,值是 45.77.135.194。等 HTTPS 自动签发(5-10 分钟)
DNS 改完后,我们的服务器会自己去签 SSL 证书(浏览器地址栏左边那把小锁)。你什么都不用做,就是等。
为什么要等?我能不能不等?
DNS 改动需要时间传播到全世界的"电话本",通常 1–10 分钟,极少数情况要半小时。服务器只有在能通过你的域名被访问到的时候,才能去签证书。所以只能等 DNS 先生效,再签证书,两步自动串起来。
怎么确认成功了?打开浏览器访问 https://你的域名:
- 看到 new-api 的登录页(有登录框、logo) = 成功 ✓
- 浏览器说"不安全"/"证书错误"/"无法访问" = 再等 5 分钟刷新
- 等了 20 分钟还不行 = 联系我们,多半是 DNS 没改对
手机浏览器可能会缓存很久。用电脑浏览器的"无痕模式"打一次最准。
登录后台,先改密码
- 打开
https://你的域名,点右上角 登录。 - 账号
root,密码 = 交付卡片上的初始密码。复制粘贴时注意别带首尾空格。 - 进去后立刻做两件事:
- 右上角头像 → 个人设置 → 修改密码(起一个你自己记得住的)
- 同一个页面绑定你的邮箱(以后忘密码能找回)
初始密码出厂就弱,长期不改早晚被人撞进来。换成你自己的,立刻换。
添加你要中转的"上游渠道"
渠道就是你要中转的那个 AI 服务商。你要先把上游配好,你的下游用户才能通过你的平台调 API。
常见的有这几种选一种就能跑起来:
蹬车俱乐部中转(最省心,推荐)
直接用我们自己的 API,价格稳定、模型齐全、出了问题我们兜底。适合没有自己资源、不想折腾的新手。
- 类型:
OpenAI(我们兼容 OpenAI 协议) - Base URL:
https://api.dengche.cc[蹬车占位 · 以交付时告知为准] - 密钥:我们会单独给你一个
sk-...[蹬车占位] - 模型:GPT / Claude / Gemini 全系 [蹬车占位]
填完点右下角 测试,绿色对勾就通了。
OpenAI 官方
- 类型:
OpenAI - Base URL:
https://api.openai.com(默认就行,可以留空) - 密钥:去
platform.openai.com→ API keys 新建一个sk-... - 模型:
gpt-4o, gpt-4o-mini, gpt-4-turbo, o1-preview, o1-mini - 注意:OpenAI 需要账单里有余额,不然调用会 429
Anthropic Claude
- 类型:
Anthropic - Base URL:
https://api.anthropic.com - 密钥:
console.anthropic.com→ API Keys 新建,sk-ant-... - 模型:
claude-sonnet-4-5, claude-opus-4-5, claude-haiku-4-5
Google Gemini
- 类型:
Gemini - Base URL:
https://generativelanguage.googleapis.com - 密钥:
aistudio.google.com→ Get API key - 模型:
gemini-2.5-pro, gemini-2.5-flash
怎么加?
- 左侧菜单 渠道 → 添加渠道。
- 按上面对应那块,把"类型/Base URL/密钥/模型"填进去。
- "分组"留默认
default就行。 - 保存 → 回到列表 → 找到这条 → 点 测试。
- 绿色对勾 = 通了;红色 = 看错误信息(一般是 Key 错了或余额不够)。
Base URL 末尾不要带斜杠。https://api.openai.com 对,https://api.openai.com/ 错。
创建"令牌"——发给下游用户的 Key
令牌就是你发给你客户的 API Key。一个客户一个,互不影响,还能分别限额。
- 左侧菜单 令牌 → 添加令牌。
- 名称:建议写客户名,比如
张三-测试,以后好认。 - 额度:起步可以填
$5或无限(看你和客户怎么约定)。 - 过期时间:默认永不过期就行。
- 保存后回到列表,点 复制,会得到形如
sk-xxxxxxxxx的字符串。 - 把 两样东西一起发给客户:
- API 地址:
https://你的域名/v1 - API Key:
sk-xxxxxxxxx
- API 地址:
手里有一个 sk- 开头的 Key,以及 /v1 结尾的 API 地址。把它俩发给你的下游客户,他们就能用了。
下游用户怎么用?
你可以把下面这段任选一段发给他们,复制粘贴即可。
curl https://你的域名/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-xxxxxxxxx" \ -d '{ "model": "gpt-4o-mini", "messages": [{"role":"user","content":"你好"}] }'
from openai import OpenAI client = OpenAI( api_key="sk-xxxxxxxxx", base_url="https://你的域名/v1", ) resp = client.chat.completions.create( model="gpt-4o-mini", messages=[{"role":"user","content":"你好"}], ) print(resp.choices[0].message.content)
# 在工具的"模型设置"里填: Base URL: https://你的域名/v1 API Key: sk-xxxxxxxxx Model: gpt-4o-mini # 或其他你渠道里有的模型
你的平台已经能对外服务了。后面的事就是不断加客户、加渠道、收钱。
钱从哪来、到哪去?
简单说:你按更便宜的批发价从上游买额度,加一点利润卖给你自己的下游。这是标准的 API 经销模式,合法合规。
- 定价策略:在后台 设置 → 倍率 里可以全局加价,比如
1.5倍 - 也可以单独给 VIP 客户建分组,用不同的倍率
- 余额用完 → 找我们续,几分钟到账
常见问题
DNS 改了但访问还是原网站?
浏览器缓存没刷新。换一个浏览器 / 用无痕模式 / 换设备试试,或者等一小时再访问。手机流量和 WiFi 也可能看到不同结果,都正常。
HTTPS 报"不安全"或证书错误?
90% 是 Cloudflare 用户把小云朵点成了橙色。必须是灰色的 DNS only。改完再等 5 分钟。还不行就联系我们。
登录提示密码错误?
检查复制密码时是不是带了首尾空格。手动输一遍最靠谱。还不行就找我们重置。
渠道测试失败?
按顺序排查:① Key 是不是复制全了;② 上游账户有没有余额;③ Base URL 末尾不要带斜杠;④ 模型名字是不是渠道真支持的那个。
下游用户说响应慢 / 超时?
去 日志 页面看具体报错。最常见是:上游渠道出问题(加个冗余渠道分担)、客户 prompt 太长、模型本身慢(比如 o1 系列)。
怎么给老下游补额度?
令牌列表找到他的令牌 → 编辑 → 在"额度"上增加数字 → 保存。他立即就能继续用,不用换 Key。
能不能改界面 Logo / 网站名?
可以。设置 → 系统设置 里有"网站名称""Logo URL""页脚" 这些字段,换成你自己的品牌。
忘了初始密码 / root 密码?
找我们重置,后台一条命令的事。
我的余额用完了怎么办?
联系我们续费,几分钟内到账。建议在余额剩 20% 时就续,别等到 0 影响下游。
想换一个域名?
新域名按 Step 1 做好 DNS,然后联系我们在后台把绑定改过去,几分钟完成。老域名可以保留一段时间做过渡。