OpenAI 兼容工具

任何支持 OpenAI API 格式 的工具或 SDK 都能接入 Mafdet AI。只要把三处配置改成 Mafdet AI 的即可。

三处关键配置

哪些字段必须匹配

• Base URL 必须以 /v1 结尾（很多工具只让你填到域名，要确认带上 /v1）
• Model 必须是 Mafdet AI 的模型 ID，不能用其它平台的模型名
• 认证用 Authorization: Bearer <key>（OpenAI 标准）

官方 OpenAI SDK 示例

from openai import OpenAI

client = OpenAI(
    base_url="https://api.mafdet.ai/v1",
    api_key="sk-mafdet-xxxxxxxxxxxxxxxx",
)
resp = client.chat.completions.create(
    model="gemini-3-flash-lite",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

常见配置错误

• Base URL 漏了 /v1 → 404 / 找不到接口
• Model 用了别的平台的名字 → model not found
• Key 放错位置（如放到 query 而非 header）→ 401

下一步

• Postman / Apifox
• 错误码与排障