常见问题

最后更新 2026-11-11

接入

base URL 该填什么？ OpenAI 兼容工具填 https://modelportal.ai/v1；Anthropic 兼容工具（如 Claude Code）填 https://modelportal.ai，不带 /v1；Gemini 见 Gemini 接口。各工具的填法见接入指南。

模型列表是空的？ GET /v1/models 只返回这把密钥能调用、且有可用报价的模型。检查密钥的「可用模型」设置，或直接手动填模型 ID。

能在浏览器或 App 里直接用密钥吗？ 不能。密钥放在前端，任何人都能取出来用你的余额。请经你自己的后端转发。

计费

失败的调用收费吗？ 不收。失败、被取消、结果未知的调用都不收费，见尝试与结算。

为什么余额够却返回 402？ 调用前平台按「输入估算 + 允许的最大输出」预留费用。把 max_tokens 调小，或充值后重试。

路由

平台会把我的请求换成别的模型吗？ 不会。你请求的模型就是实际调用的模型，平台只在同一个模型的报价之间选择。

怎么指定供应商？ 在请求里加 provider 对象，例如 {"order": ["PROVIDER_ID"]}，见供应商选择。

怎么让多轮对话用同一个报价？ 每次请求带同一个 X-ModelPortal-Session 请求头，见默认路由规则。

首选报价失败时会自动换一家吗？ 默认不会，allow_fallbacks 默认为 false。开启后，遇到连接失败、超时、429、5xx 这类错误会换同一模型的下一个报价，最多试 3 个，见失败切换。