ModelPort
ModelPort · 使用指南

Codex 接入 ModelPort 指南｜API 地址、密钥与模型检查

ModelPort 编辑 · 更新于

接入前准备好 ModelPort 密钥、对应 API 地址和一个已授权的模型 ID。不要只根据客户端下拉列表判断模型是否可以使用。

接入步骤

  1. 从官方渠道安装或更新 Codex，并先备份现有配置。
  2. 登录 ModelPort，在密钥与接入指南页面选取适用的配置；确认所选模型属于当前密钥可用范围。
  3. 配置客户端的自定义服务商、API 地址和认证信息。地址与协议应采用站点提供的值，不要自行重复追加路径。
  4. 若通过 CC Switch 导入，导入后检查实际启用的服务商和模型，而不是只检查列表是否出现。
  5. 先发送一个不含敏感数据的小请求，然后在站内核对模型、实际分组与用量，再开始较长的编程任务。

模型可见不代表可调用

客户端可能包含自己的模型目录。某个模型出现在选择框中，并不表示中转渠道已经启用它。遇到模型不存在、无权限或上下文压缩阶段报错，应记录实际请求的模型 ID，检查当前客户端配置、站点支持范围与错误信息，不要通过反复充值解决配置问题。

配置与安全

Codex 的高级配置支持自定义模型服务商。具体字段及优先级请参阅Codex 官方高级配置文档；站点生成的配置应与实际客户端版本一起核对。密钥只保存在受保护的本地配置或环境中，不提交到 Git，也不粘贴到公开工单。

费用与功能边界

使用 ModelPort 密钥产生的是站内 API 用量，不代表购买了 ChatGPT 官方订阅。长任务会产生多次调用；工具和传输方式的兼容性取决于当前渠道。请先阅读计费说明，拼团密钥另须遵守拼团使用限制。

可复制的用户级配置（TOML）

下面是自定义 provider 的最小示例，保存位置是用户级 ~/.codex/config.toml（Windows 可在 %USERPROFILE%\.codex\config.toml 使用对应路径）。当前仓库公开教程约定的 API 基础地址是 https://api.modelport.top/v1；若登录后的“使用密钥”弹窗显示不同地址，请以弹窗和站点当时的接入指南为准，不要自行重复追加 /v1。

# ~/.codex/config.toml（用户级）
model_provider = "modelport"
model = "<MODELPORT_MODEL_ID>"

[model_providers.modelport]
name = "ModelPort"
base_url = "https://api.modelport.top/v1"
env_key = "MODELPORT_API_KEY"
wire_api = "responses"

<MODELPORT_MODEL_ID> 只是占位符：请从“使用密钥”弹窗或当前密钥可见的模型目录复制精确 ID 后再替换，本文不把未经核对的模型名写进配置。env_key 只引用环境变量名称，不把密钥值写入 TOML、仓库、截图、工单或 Git 历史。

备份后合并，不覆盖原配置

已有配置时先备份，再把上述键合并进原文件；不要用整段示例覆盖原有 profiles、权限或其他 provider。确认没有重复的 [model_providers.modelport] 表后再保存。

mkdir -p ~/.codex
if [ -f ~/.codex/config.toml ]; then
  cp ~/.codex/config.toml ~/.codex/config.toml.bak.$(date +%Y%m%d%H%M%S)
fi
read -r -s MODELPORT_API_KEY
export MODELPORT_API_KEY

密钥值应由当前终端、系统密钥管理器或 CI Secret 注入；不要把上面的 export 行连同真实值提交 Git，也不要将真实值放入项目级 .codex/config.toml。Windows PowerShell 可在启动 Codex 的同一窗口设置 $env:MODELPORT_API_KEY = '<你的密钥>'。

先看目录，再做兼容性验证

用同一密钥请求 GET /v1/models（这里即 https://api.modelport.top/v1/models）只能帮助确认当前目录中的模型 ID；目录响应不保证 Responses 协议、工具调用、上下文压缩、额度或具体分组一定兼容。看到模型后仍需用小请求验证，并以实际错误与站内用量记录为准。

curl -fsS --max-time 20 https://api.modelport.top/v1/models \
  -H "Authorization: Bearer $MODELPORT_API_KEY"

上下文压缩的边界

长会话的上下文压缩可能产生独立请求。若压缩阶段失败，请记录实际请求模型、时间、状态码和请求标识，核对当前客户端版本、Responses 能力与站内分组说明；不要把目录中的任意模型名当成压缩模型，也不要臆造未经当前 Codex 官方文档或站内指南确认的压缩配置项。调整配置前先恢复到已知可用的精确模型和 provider，避免用反复充值掩盖兼容性问题。

这段只展示 provider、API 地址、认证变量和主模型等最小键，不包含模型目录文件、review/辅助模型或其他按客户端版本变化的选项；需要这些能力时请使用站内“使用密钥”生成的完整文件，再对照Codex 官方高级配置文档核对，不能从本文示例推断未列出的参数。