Mafdet AI 帮助中心English

第一次 API 调用

拿到 API Key 后,用 curl 发出第一条请求。

请求

curl https://api.mafdet.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-mafdet-xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-flash-lite",
    "messages": [{ "role": "user", "content": "用一句话介绍 Mafdet AI" }]
  }'

sk-mafdet-xxxxxxxxxxxxxxxx 换成你自己的 Key。

成功响应

{
  "id": "chatcmpl-...",
  "model": "gemini-3-flash-lite",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Mafdet AI 是一个统一的 AI 模型网关。" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 12, "completion_tokens": 18, "total_tokens": 30 }
}

回复正文在 choices[0].message.content

常见失败

现象含义处理
401 认证失败Key 错误或格式不对确认 Authorization: Bearer sk-mafdet-...
insufficient_credit余额不足查看 余额与用量
MODEL_NOT_ALLOWED当前账号/Key 无该模型权限权限与模型范围

完整错误码见 错误码与排障

下一步