API 网关与厂商直连：接入前核对协议、模型与计费

选择 API 网关还是厂商直连，先核对协议、模型权限和计费口径，不要只看“兼容”或单次报价。统一入口可以减少多套配置的维护，但不代表厂商的所有原生能力都能原样使用。本文由 ModelsNexus 内容团队编写，给准备接入的开发者一份核对清单；不提供未经验证的价格排名，也不把目录可见当作调用成功。

先把入口、协议和模型分开看

入口是请求发往的域名与路径；协议是鉴权、字段、返回结构和流式事件的约定；模型则是具体可调用的标识及其能力。改了 Base URL，只改变请求目的地，不会自动把一种协议转换成另一种。接入说明写着 OpenAI 兼容，也需要确认兼容的是哪些接口，而不是推断所有客户端都可直接使用。

模型系列名同样不能代替准确的 model 值。两个名称相近的条目，可能具有不同的权限、任务类型或计费规则。请从当前账户可见目录和具体模型说明取值，不要直接搬用其他平台的型号后缀、质量档位或分辨率参数。

先查询目录，再验证具体任务

用本站密钥读取模型目录

ModelsNexus 的模型目录路由提供 GET /v1/models，需要本站 API 密钥鉴权。以下是只读查询示例，不提交生成任务。请先在服务端环境变量 MODELSNEXUS_API_KEY 中配置你自己的密钥；变量名不是密钥，不能把其他厂商的密钥当作本站密钥使用。不要把完整密钥写进前端、截图或公开工单。

curl --request GET \
  --url https://modelsnexus.org/v1/models \
  --header "Authorization: Bearer ${MODELSNEXUS_API_KEY}" \
  --connect-timeout 10 \
  --max-time 30

目录返回成功，只说明这次查询通过，不证明每个条目都适合你的输入，也不代表生成已经完成。若返回鉴权或权限错误，先检查所用站点、密钥状态与权限；不要通过反复提交付费任务来猜测原因。这个目录查询形式可与 OpenAI 官方模型目录文档对照，但官方文档不能替本站承诺模型可用性。

把“接通”拆成可验证的小步骤

1. 保存配置快照：站点、接口、模型标识、SDK 版本和所需能力，不记录完整密钥。
2. 用文档中的最小合法请求验证目标任务，先限制输出量与预算。文本、图片、视频分别验收，不混用字段。
3. 检查实际返回：状态、结构、文件格式和结果内容；流式请求还要检查结束事件，不能仅凭 HTTP 200 判定业务完成。
4. 再增加真实素材、输出规格和并发量，每次只改变少量条件，保留请求 ID 与时间记录。

比较价格时，先统一计量口径

同一个数字可能表示每百万 token、每张、每次或每秒。只有单位、版本、输入输出规格和适用分组一致，比较才有意义。如果价目表分别列出输入和输出单价，就应分别计算；如果视频按秒报价，就不能与按条报价只比标价大小。

例如，报价若按每百万 token 计费，基础估算为“输入 token 数 ÷ 一百万 × 输入单价，加上输出 token 数 ÷ 一百万 × 输出单价”；按秒报价则先看“时长 × 对应规格的每秒单价”。这只是计算口径，缓存、额外工具、最低计费单位及其他项目是否适用，仍以对应服务说明为准，不应擅自假定没有附加成本。

预算还需要区分首次提交和重复提交。若网络断开后原请求仍被处理，再发一次可能形成另一笔任务；不能预设所有超时都退款，也不能预设所有请求都支持幂等去重。对预扣、结算、退款及重试收费没有明确说明的部分，应在正式批量使用前问清。

按项目需求决定，而不是先押注一种入口

需要紧跟某家厂商的新功能、原生事件结构或专用工具时，优先核对厂商直连与网关各自的支持范围。需要管理多种模型入口时，可以评估统一配置能否减少维护工作，但也要检查故障定位、数据处理说明和账单可解释性。这里没有一个适合所有项目的统一赢家。

对于需要上传业务资料的应用，还应核对服务说明中的数据处理范围、保存规则和访问边界。不要把“能调用”当成已经满足你的隐私或合规要求，也不要为省去验证步骤而关闭 TLS 校验。

下一步：带着清单核对本站模型

正式接入前，至少明确“用什么协议、调用哪个标识、需要哪些能力、按什么单位结算、遇到异常保留哪些证据”。现在可以前往 ModelsNexus 模型广场查看模型与价格；如页面要求登录，请按你的账户和分组核对实际说明，再使用对应接入文档。本文没有执行付费调用，不代表任何型号、优惠或输出规格的全量验收。