模型接入与用量指南

先看一张图：谁在连接谁？

Agent 先把请求交给 Sub2API，网关再用管理员已授权的上游账号调用模型。两段网络可以分别出问题。

我现在要不要开代理？

主页 Sub2API 卡片的直达箭头与勾形小标识“无需代理”，说明的是访问者这一段：当前设备能连接网关时，通常无需额外开启本机代理。它不是实时检测结果，也不表示 NAS 到上游不需要代理。

客户端到 Sub2API：先使用当前设备能连上的网关入口。能连接并正常调用时，通常不用为了模型服务额外打开电脑或手机代理，也不用把上游节点订阅填进 Agent。局域网入口通常直接访问；外网入口能否直连，取决于当前网络。

NAS 上的 Sub2API 到 OpenAI：当前 OpenAI 上游账号已接入 NAS 的出站代理，代理程序、订阅和节点需要可用。电脑上 Clash Verge 的系统代理开关只影响电脑，不能代替 NAS 的代理；停止 NAS 代理核心会影响依赖它的上游调用。

忘记开关状态，按这个顺序检查

1. 先访问选定的网关地址。地址拒绝连接或超时时，先检查入口、DNS、局域网或 IPv6 条件；若本地开启代理后反而连不上家中地址，检查局域网是否按直连规则访问。
2. 再用自己的 Key 刷新模型列表并发送一句短问题。网页或模型目录正常，而生成请求失败时，由管理员检查 NAS 出站代理、上游账号和额度。
3. 只有客户端到网关这段确实需要代理时，才开启客户端代理；更换已有入口后重新测试。401、403、429 要按实际错误定位，开代理不能修复错误 Key、权限或额度。

“网站能打开”“Key 能认证”“模型能生成”是不同的检查，不能互相代替。

网站登录、调用 Key、上游授权，各管一件事

分享给朋友，按人分开

1. 管理员生成有效邀请码，私下交给对方；过期或用完后重新生成。
2. 对方用自己的邮箱注册，管理员确认分组与额度。当前默认不自动赠送余额，也不自动加入专用分组。
3. 对方在自己的 API Key 页面创建 Key，名称写清用途。建议一个客户端一个 Key，方便核对和单独停用。
4. 先试一句短问题，确认个人用量出现记录后再日常使用。

公开注册入口配合邀请码使用；关闭注册时，访客不能自行完成注册。不要用管理员密码、上游授权或大家共用的 Key 代替邀请码。

公告、帮助和联系入口

登录后点右上角的公告铃铛，可查看亲友使用须知、充值返利说明和接入常见问题。欢迎公告在未读时弹出一次；标记已读后不再自动弹出，仍可从铃铛重看。充值和排查公告保留在公告列表中。

桌面顶部的文档按钮与公告内的使用指南链接进入同一份教程；手机可从公告内打开指南。个人资料和兑换码页面的联系说明指向 ldz 的原有联系方式；反馈时提供发生时间、客户端、模型名与错误提示，遮住密码、Key 和不必要的私人内容。

当前没有邮件自助找回，忘记密码请联系 ldz。

模型广场：直接看原生价格表

登录后打开模型广场 →。顶部只留一句充值提醒，下面按获授权分组显示可视化价格表；不再重复铺开同一套价目文字。两条通路合计28个型号／档位／别名，不等于28个不同基础模型。

未获分配分组时，可展开本节参考价目；实际调用仍按个人Key与分组权限执行，充值不会自动开通所有模型。下方快照不代替广场实时价格。

在哪里聊天？怎样看用量百分比？

当前官方Sub2API版本的模型广场用于展示价格，没有通用聊天页或隐藏的聊天开关。日常对话通过已获准的客户端接入个人Key；管理员“测试”用于检查连通性，不能代替多轮聊天。

账号管理的OpenAI用量窗口显示已用百分比；官方客户端通常显示剩余。对照同一账号、同一周窗口：已用13%＝剩余87%。这与本站美元余额是两套数据，不能相互换算。需要更新数据时在对应账号的用量窗口点“查询”；不要点“重置”，它会消耗可用的重置次数。还应核对更新时间和重置日期，5h与7d不能混为同一窗口。

亲友充值：人民币 1 元，增加 1 美元站内额度

仅供 ldz 的朋友和家人凭邀请使用。充值人民币 ¥1，由 ldz 核实收款后增加 $1 站内额度；例如充值 ¥10，增加 $10。页面继续使用美元符号显示站内余额，模型单价沿用现价 1 倍，优惠体现在充值比例。

1. 充值前先联系 ldz，确认站内账号和人民币付款金额；在本人充值页查看支付宝二维码，点图可放大。
2. 付款后提供站内账号、付款时间和金额；ldz 核对支付宝真实收款后，按人民币与美元额度 1:1 人工添加余额。
3. 入账后核对自己的账户余额。模型分组和使用权限另由 ldz 安排；原有 5% 邀请返利保留，按现有邀请关系和后台规则计入。

扫码后不会自动到账。当前没有在线自动支付通道，不需要创建自动支付订单；未确认入账时先联系 ldz，请勿重复付款。站内美元额度用于模型调用记账，不表示收到真实美元。

登录后打开充值页 → · 请勿公开转发二维码、注册邀请码和 API Key。

三个入口怎样填？先选可达的，再测速度

内网、默认外网和 IPv6 可以指向同一套网关，Key 与获准模型通常相同，客户端地址随入口改变。下面是符号示例；实际信息从本人获准的连接说明或管理员处取得。

http://NAS_ADDRESS:APP_PORT/v1

https://API_HOST/v1

https://API_V6_HOST:HTTPS_PORT/v1

IPv6 一定最快吗？

直连可能减少绕路，你当前也可能体验更快，但它不保证每个网络都最快。比较相同模型、相同短问题、相近时段的首次响应和完成时间。网页测速主要反映到网关的线路，上游代理、模型拥堵和生成长度仍影响整体体验。

换入口后，网页登录状态可能分开保存，API 仍使用自己的 Key。长回答进行中不要改地址，换入口不能保证接回中断的生成。

接入 Agent：四个字段与一次小测试

最常见的地址错误：重复追加路径

Base URL： https://API_HOST/v1
客户端补： /responses
最终请求： /v1/responses

Endpoint：
https://API_HOST/v1/responses
客户端不再追加路径

把完整 Endpoint 当作 Base URL，又让客户端追加一次，可能请求不存在的地址；重复 /v1 也一样。404 时先看字段定义，不要不停追加后缀。

第一次连接，按这个顺序验收

1. 选一个本人获准的文本模型，只发一个请求。
2. 发送“请只回复：连接成功”，先不用文件、联网或工具，分开检查基础生成。
3. 确认正常回复，再回个人用量页找到这次记录。仅显示“认证成功”或“模型列表已加载”还不够。
4. 然后让 Agent 做一个可撤回的小任务，例如读取测试文本并摘要，验证工具调用和上下文衔接。

GET https://API_HOST/v1/models
Authorization: Bearer MY_SUB2API_KEY

POST https://API_HOST/v1/responses
Authorization: Bearer MY_SUB2API_KEY
Content-Type: application/json

{
  "model": "MY_TEXT_MODEL_ID",
  "input": "请只回复：连接成功",
  "store": false
}

有些 Agent 固定使用专有登录或协议；能填 URL 不代表全部兼容。先确认是否支持自定义 OpenAI 兼容连接，再做工具任务。

文字、看图、生图：分开选择，分开验证

创建界面的模型选项是候选目录。名称出现在列表、分组允许调用、上游当前可用、实际请求成功，是不同层次。淘汰模型不必为了“看起来齐全”保留，清理旧名称也不等于自动换成新模型。

第一次生图怎么试？

1. 在本人可用列表中找生图模型。本站已实际用 gpt-image-2.5-flare 生成过单图；这是核验样例，不保证所有账号权限相同。
2. 选支持 Images API 的客户端，填写相同入口和个人 Key，模型填本人获准的图片模型。
3. 先生成单张简单内容，例如“白底，一个蓝色圆形”。界面支持时选低质量、单张输出。
4. 看到真实图片后再检查用量。HTTP 成功、任务 ID 或一串编码，不能代替图片展示验收。

POST https://API_HOST/v1/images/generations
Authorization: Bearer MY_SUB2API_KEY
Content-Type: application/json

{
  "model": "MY_IMAGE_MODEL_ID",
  "prompt": "白底，一个蓝色圆形",
  "size": "1024x1024",
  "quality": "low",
  "n": 1
}

怎样收窄旧模型？

列出实际需要的文本和图片模型 → 分别做对应调用 → 检查客户端是否还引用旧名称 → 再由管理员收窄允许范围。保留明确的生图入口，不把精简文本列表做成取消生图。

WebSocket 与透传：体验区别在哪里？

WebSocket 改变连接方式

HTTP 配合 SSE 已经能边生成边显示。WebSocket 在一条持续连接上收发事件，多轮工具往返密集时有机会减少请求开销。它不会提升模型智力，也不替代账号授权。

透传改变网关处理请求的方式

强制透传关闭，表示不强制所有请求走透传，仍按网关兼容逻辑处理。它不是 VPN 直连开关，也不绕过 Key、分组、用量和账号配额。当前先保持关闭，出现可复现协议问题再判断是否需要。

机制来源：OpenAI 流式响应、WebSocket 模式；网关行为以当前 Sub2API 版本为准。

代理自动切换：只在指定的五个节点里选

这部分由管理员维护。普通用户不必把节点订阅填进 Agent；Agent 连接网关，网关使用已接好的出站代理。

• 日本 04 → 日本 07 → 美国 01 → 美国 02 → 台湾 01，前一个不可用才向后选，不在全部节点中随机切换。
• 所选订阅内自动选节点，另一份订阅由管理员手动切换，两份都按同样的角色核对节点名称。
• 健康检查有检测周期，恢复后也需等后续检查确认；图示表达顺序，不代表真实检测时间。
• 全部失效就报告没有可用节点，不擅自跳其他地区、其他订阅或直连。

检测目标可达，不代表模型账号一定可用。401、授权撤销、权限或额度问题应处理对应原因。换节点不能增加额度，也不能保证中断的回答或图片续传；重发前先查结果和用量，避免重复生成。

授权后 localhost 拒绝连接，怎样判断？

如果是在上游授权完成后，浏览器跳到 localhost 回调地址，可能只是这台电脑没有本地接收程序，不能直接认定 NAS 的上游代理断了。

1. 回到原来的账号添加窗口，看是否正在等待“回调 URL”或“授权码”。
2. 若明确支持手动回填，复制浏览器地址栏中的完整回调，粘回原表单，不要只复制 localhost。
3. 等待网关兑换并保存。如果状态不匹配、码过期或已使用，从原窗口重新发起授权，不循环提交旧链接。
4. 最后查看账号状态并做短调用，不能只凭后台显示正常就认定业务接通。

回调链接可能含一次性授权资料。不要放进公开指南、截图、群聊或诊断表单，本页也不接收它。

以后每天都要重新登录吗？

通常不需要：授权有效、可刷新且服务运行时，网关可以后台续期，关闭浏览器一般不影响它。持有人撤销授权、刷新凭据失效、安全验证、账号或上游规则变化，都可能要求重新授权。首次调用成功不证明长期刷新已通过；本站尚未长期观察自动续期。

故障排查：按现象定位，别反复换设置

记录时间、客户端名称、所选入口、模型名和去掉凭据的错误正文。选最接近的现象，按顺序检查。

我们怎样测试，验证到了哪一层？

测试工具分别检查 API 实际结果和浏览器操作。公开教程展示方法与边界；个人地址、凭据和上游身份按权限提供。