Mafdet AI 帮助中心
English

API 基础信息

Mafdet AI 提供 OpenAI 兼容 的 Chat Completions 接口。任何支持 OpenAI API 格式的工具或 SDK，只要把 Base URL 和 API Key 换成 Mafdet AI 的，就能直接调用。

Base URL

所有模型调用都走这个网关地址（数据面，由 LiteLLM 提供）：

https://api.mafdet.ai/v1

说明：Mafdet AI 的 Business API（平台后端）不直接对普通模型调用用户开放，模型调用统一走上面的 /v1 网关。

认证方式

在请求头中携带你的 API Key（前缀 sk-mafdet-）：

Authorization: Bearer sk-mafdet-xxxxxxxxxxxxxxxx
Content-Type: application/json

API Key 在平台创建，只显示一次，请妥善保存。详见 创建第一个 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 兼容 OpenAI：把任意 OpenAI SDK 或客户端的 base URL 指向 https://api.mafdet.ai/v1，使用你的 Mafdet Key 即可。

端点对应 OpenAI 接口说明
POST /v1/chat/completionsChat Completions支持流式（"stream": true）
POST /v1/embeddingsEmbeddings文本、图片、视频模型
POST /v1/audio/speechAudio SpeechPreview；Gemini 音色，返回音频字节
GET /v1/modelsModels你可访问的模型列表

每个模型只在自己所属的端点可用，见模型调用总览。

  • 可用于 Continue、Cline、以及任何 OpenAI 兼容客户端
  • 支持流式（"stream": true），见 流式调用

下一步