# 常见问题

https://modelportal.ai/docs/faq?lang=zh

## 接入

**base URL 该填什么？**
OpenAI 兼容工具填 `https://modelportal.ai/v1`；Anthropic 兼容工具（如 Claude Code）填 `https://modelportal.ai`，不带 `/v1`；Gemini 见 [Gemini 接口](/docs/gemini-api)。各工具的填法见[接入指南](/docs/integrations)。

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

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

## 计费

**失败的调用收费吗？**
不收。失败、被取消、结果未知的调用都不收费，见[尝试与结算](/docs/attempts)。

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

## 路由

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

**怎么指定供应商？**
在请求里加 `provider` 对象，例如 `{"order": ["PROVIDER_ID"]}`，见[供应商选择](/docs/provider-routing)。

**怎么让多轮对话用同一个报价？**
每次请求带同一个 `X-ModelPortal-Session` 请求头，见[默认路由规则](/docs/default-routing)。

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