ModelPort
ModelPort · 使用指南

AI API 中转站是什么？接入原理与选择指南｜ModelPort

ModelPort 编辑 · 更新于

AI API 中转站在客户端与上游模型服务之间处理鉴权、请求转发、渠道选择和计费。客户端连接的是中转站地址，而不是直接连接模型厂商。

与直接调用官方 API 有什么区别？

直接调用通常由对应厂商管理账户、权限和账单；通过中转站调用，则由中转站提供密钥和用量账单。模型名称相同不等于所有接口特性都相同，工具调用、上下文长度、图片、流式输出和连接方式需要逐项核对。

ModelPort 如何选择分组？

在密钥获准使用的范围内，模型请求可以按平台进入相应的分组路由：GPT 类请求使用适配的 GPT 分组，Claude 类请求使用适配的 Claude 分组。自动切换不会让一个未授权模型变成可用，也不保证所有渠道都支持相同功能。切换后的费用应查看实际分组，而不只看客户端选择的模型名。

选择服务时检查什么？

  1. 确认目标模型和所需接口在你的密钥权限内可用。
  2. 查看输入、输出、缓存及长上下文价格，了解并发与限额。
  3. 用小请求验证流式输出、工具调用等实际需求。
  4. 核对用量记录，确认请求模型、实际分组与扣费。
  5. 阅读隐私、退款、服务地区与可接受用途条款。

调用失败如何定位？

鉴权失败先检查密钥是否完整、过期或撤销；模型不可用先检查精确模型 ID 与授权分组；限流则降低并发并查看当前额度。不要把所有错误都当作网络问题，也不要在失败后无限重试。联系支持时提供时间、模型、错误码和可用的请求标识，不发送完整密钥或敏感提示词。

下一步：查看模型路由与授权，再读错误排查顺序；费用见计费说明，接入可看Codex与Claude Code。