什么情况该用 AI 网关，什么情况不该用
Mafdet AI 是一个托管的、OpenAI 兼容的 AI 网关：一把 API Key、一个 base URL， 即可调用多家提供方的模型，按量计费。这一页讲的是「你到底该不该用它」—— 包括答案是「不该」的那些情况。
三种做法怎么选
从应用里调模型有三种做法，没有一种在所有场景都最好。
| 直连各家 SDK | 自建网关 | 托管网关（Mafdet AI） | |
|---|---|---|---|
| 接入成本 | 每家一个 SDK、一个账号 | 自己部署并运维一个服务 | 改 base URL 和 Key |
| 新增一家提供方 | 新 SDK、新的付费关系 | 改配置，但每家的 Key 仍由你保管 | 目录里已经有 |
| 账单 | 每家一份 | 每家一份，另加自己的服务器 | 一份预付余额 |
| 按 Key 设支出上限 | 看各家是否支持 | 要自己实现 | 内置 |
| 谁保管提供方密钥 | 你 | 你 | Mafdet |
| 运维负担 | 除应用外没有 | 你的：可用性、升级、密钥管理 | 没有 |
| 数据路径 | 你 → 提供方 | 你 → 你的服务器 → 提供方 | 你 → Mafdet → 提供方 |
什么情况不该用托管网关
符合下面任意一条就别用，选错了双方都浪费时间。
- 你需要 OpenAI 或 Anthropic 的模型。 Mafdet AI 没有这两家。 目录是 Google（Gemini）、Kimi（月之暗面）、Qwen、DeepSeek， 见模型总览。想用一把 Key 调 GPT 或 Claude， 应该选别的网关。
- 你需要合规认证。 没有 SOC 2、ISO 27001、HIPAA 认证。 采购流程要求这些的，看到这里就可以停了。
- 你的数据不允许经过第三方。 请求会先到 Mafdet AI 再转给提供方。 不允许的话，请自建网关或直连提供方，见数据处理。
- 你只用一家提供方而且用得挺好。 网关多加一跳，解决的是你没有的问题。
什么情况适合用
- 想用一把 Key、一份余额调用多家模型，不必逐家开户和建立付费关系。
- 需要按 Key 设支出上限 —— 比如每个环境一把 Key、或每个客户一把，各自封顶。
- 手上的工具本来就支持 OpenAI 格式，只是要换个地址。 Claude Code、Cline、Continue、Codex CLI、opencode 都能填 base URL， 见 OpenAI 兼容工具。
- 想在同一把 Key 下做多模态：图片生成、图片与视频向量、语音合成都在同一个账户里。
切换过来要改代码吗
不用，只要你的代码本来就用 OpenAI API 格式。改三个设置：
from openai import OpenAI
client = OpenAI(
base_url="https://api.mafdet.ai/v1", # 原来是提供方的地址
api_key="sk-mafdet-xxxxxxxxxxxxxxxx", # 原来是提供方的 Key
)
resp = client.chat.completions.create(
model="gemini-3-flash-lite", # 原来是提供方的模型 ID
messages=[{"role": "user", "content": "你好"}],
)
模型 ID 不能沿用其他平台的。填 gpt-4o 或别家网关特有的 ID 会报模型不存在，
请从模型总览里挑一个。
国内能直接用吗
可以，api.mafdet.ai 是公网可直接访问的域名，不需要额外网络配置。
调用走的是标准 HTTPS，任何支持 OpenAI 格式的客户端都能连。
试一下要花多少钱
注册后有 Playground 额度，且可以调用免费档模型，所以第一次调用不花钱。
付费模型按各自的计费维度计价——文本按每 100 万 tokens、图片向量按张、
视频向量按秒。全部模型的现价见价格表，
机器可读版在 models.json。
有一条限制建议在做规划前先知道：Starter 套餐的 API Key 只能调免费模型，
用 API Key 调付费模型从 Pro 起。Playground 与 API Key 是两套模型准入，
见你的套餐能用什么。