模型调用总览
Mafdet AI 通过统一的 base URL https://api.mafdet.ai/v1 提供多家 provider 的模型。
调用哪个端点取决于模型做什么——每个模型只在自己所属的 API Surface 上可用。
API Surface
| Surface | 端点 | 用途 | 状态 |
|---|---|---|---|
| Chat | POST /v1/chat/completions | 文本、多模态输入、图片生成 | GA |
| Embeddings | POST /v1/embeddings | 文本 / 图片 / 视频 → 向量 | GA |
| Speech | POST /v1/audio/speech | 文本 → 音频 | Preview |
| Realtime | 控制台的 Playground Live | 实时语音对话 | Beta，邀请制 |
在 同一个 Surface 内，换模型只需改 model 字段；跨 Surface 不行——把 embeddings
模型发给 /v1/chat/completions 会在调用 provider 前被 model_api_surface_mismatch 拒绝。
Realtime 不是公开 API，它只在控制台 Playground 中对白名单组织开放。
各 Surface 的认证与计费差异
认证方式完全相同：所有 HTTP Surface 都用 Authorization: Bearer sk-mafdet-…。
一把 Key 可用于 Chat、Embeddings 和 Speech，前提是该 Key 有权调用对应模型。
计费单位不同，这也是各 Surface 不可互换的地方：
| Surface | 计费依据 |
|---|---|
| Chat（含图片生成） | 输入 + 输出 token |
| Embeddings — 文本 | 输入 token |
| Embeddings — 图片 | 按张 |
| Embeddings — 视频 | 按视频秒数 |
| Speech | 文本输入 token + 音频输出 token |
你的套餐实际能用哪些 Surface，见套餐能力对照。
如何选择模型
- 免费体验：
gemini-3-flash-lite（计费 $0） - 多模态对话（图片 / PDF / 音频 / 视频输入）：Gemini 2.5 与 3 系列
- 图片生成：
gemini-3-image、gemini-3-pro-image、gemini-3-flash-lite-image - 向量嵌入：
gemini-embedding-2（文本）、multimodal-embedding-1（图片 / 视频） - 语音合成：
gemini-2.5-flash-tts、gemini-2.5-pro-tts - 中文 / 代码 / 低成本：DeepSeek、Qwen 系列
- 长文本：Kimi（Moonshot）大上下文型号
可用模型
对话 (Chat)
POST /v1/chat/completions
Google (Gemini)
| 模型 | 模型 ID | 上下文长度 | 价格 |
|---|---|---|---|
| Gemini 3.7 Flash | gemini-3.7-flash | 1,048,576 | text in $1.80 / 1M text out $9.00 / 1M |
| Gemini 3 Pro | gemini-3-pro | 1,048,576 | text in $2.40 / 1M text out $14.40 / 1M |
| Gemini 3 Flash | gemini-3-flash | 1,048,576 | text in $1.80 / 1M text out $10.80 / 1M |
| Gemini 3 Flash-Lite (Trial) | gemini-3-flash-lite | 1,048,576 | 免费试用（不计费） |
| Gemini 2.5 Pro | gemini-2.5-pro | 1,048,576 | text in $1.50 / 1M text out $12.00 / 1M |
| Gemini 2.5 Flash | gemini-2.5-flash | 1,048,576 | text in $0.36 / 1M text out $3.00 / 1M |
| Gemini 2.5 Flash-Lite | gemini-2.5-flash-lite | 1,048,576 | text in $0.12 / 1M text out $0.48 / 1M |
| Gemini 3 Flash (Preview) (Preview) | gemini-3-flash-preview | 1,048,576 | text in $0.60 / 1M text out $3.60 / 1M |
DeepSeek
| 模型 | 模型 ID | 上下文长度 | 价格 |
|---|---|---|---|
| DeepSeek V4 Pro | deepseek-v4-pro | 128,000 | text in $1.584 / 1M text out $4.752 / 1M |
| DeepSeek V4 Flash | deepseek-v4-flash | 128,000 | text in $0.528 / 1M text out $1.584 / 1M |
Kimi / Moonshot
| 模型 | 模型 ID | 上下文长度 | 价格 |
|---|---|---|---|
| Kimi K3 | kimi-k3 | 1,048,576 | text in $3.00 / 1M text out $15.00 / 1M |
| Kimi K2.7 Code | kimi-k2.7-code | 256,000 | text in $0.60 / 1M text out $2.30 / 1M |
| Kimi K2.7 Code Highspeed | kimi-k2.7-code-highspeed | 256,000 | text in $0.60 / 1M text out $2.30 / 1M |
| Kimi K2.6 | kimi-k2.6 | 256,000 | text in $0.60 / 1M text out $2.30 / 1M |
| Kimi K2.5 | kimi-k2.5 | 256,000 | text in $0.60 / 1M text out $2.30 / 1M |
| Kimi v1 128K | kimi-128k | 131,072 | text in $8.50 / 1M text out $8.50 / 1M |
| Kimi v1 32K | kimi-32k | 32,768 | text in $3.40 / 1M text out $3.40 / 1M |
| Kimi v1 Auto | kimi-auto | 131,072 | text in $1.70 / 1M text out $1.70 / 1M |
| Kimi v1 8K | kimi-8k | 8,192 | text in $1.70 / 1M text out $1.70 / 1M |
Qwen
| 模型 | 模型 ID | 上下文长度 | 价格 |
|---|---|---|---|
| Qwen Max | qwen-max | 32,768 | text in $0.34 / 1M text out $1.34 / 1M |
| Qwen Plus | qwen-plus | 131,072 | text in $0.11 / 1M text out $0.28 / 1M |
| Qwen Flash | qwen-flash | 1,000,000 | text in $0.08 / 1M text out $0.20 / 1M |
| Qwen Long | qwen-long | 1,000,000 | text in $0.07 / 1M text out $0.14 / 1M |
图片生成
POST /v1/chat/completions
| 模型 | 模型 ID | 上下文长度 | 价格 |
|---|---|---|---|
| Gemini 3 Flash Image | gemini-3-image | 1,048,576 | text in $0.60 / 1M text out $72.00 / 1M |
| Gemini 3 Pro Image | gemini-3-pro-image | 1,048,576 | text in $2.40 / 1M text out $144.00 / 1M |
| Gemini 3 Flash-Lite Image | gemini-3-flash-lite-image | 1,048,576 | text in $0.30 / 1M text out $36.00 / 1M |
向量嵌入 (Embeddings)
POST /v1/embeddings
| 模型 | 模型 ID | 上下文长度 | 价格 |
|---|---|---|---|
| Gemini Embedding 2 | gemini-embedding-2 | 2,048 | text in $0.24 / 1M |
| Multimodal Embedding 1 | multimodal-embedding-1 | 2,048 | per image $0.00012 / image per second $0.00060 / second |
语音合成 (TTS)
POST /v1/audio/speech
| 模型 | 模型 ID | 上下文长度 | 价格 |
|---|---|---|---|
| Gemini 2.5 Flash TTS (Preview) | gemini-2.5-flash-tts | 8,192 | text in $0.60 / 1M audio out $12.00 / 1M |
| Gemini 2.5 Pro TTS (Preview) | gemini-2.5-pro-tts | 8,192 | text in $1.20 / 1M audio out $24.00 / 1M |
实时语音 (Live)
Playground Live (console, invite only)
| 模型 | 模型 ID | 上下文长度 | 价格 |
|---|---|---|---|
| Gemini Live (Native Audio) (Beta) | gemini-live-native-audio | 32,000 | text in $0.60 / 1M text out $2.40 / 1M audio in $3.60 / 1M audio out $14.40 / 1M |
权限说明
每个模型都要求一个访问档（FREE / PAID / TRUSTED / ENTERPRISE），而你的订阅套餐
分别为 Playground 和 API Key 授予档位——Starter 的 Playground 能用全部公开模型，
但 API Key 只能调免费模型。返回 MODEL_NOT_ALLOWED 即是这道门，详见
订阅套餐与权限与模型范围。
价格
页面所列为 Mafdet 向你收取的价格，单位以各模型标注为准——文本按每 100 万 token、 图片嵌入按张、视频嵌入按秒。价格可能调整，以调用时生效的价格和你的用量记录为准。
单一价格，全天不变。 每个模型只有一个输入价和一个输出价。所有输入 token 均按该 输入价计费——不设单独的缓存命中价——且价格不随时段变化，即使上游厂商自身按小时浮动。
一张图不是一百万 token。 图片模型同样按每 100 万输出 token 计价，但它的输出是
图片 token，一张图固定约 1,120 个——所以 gemini-3-image 的 $72 / 100 万折算下来
约 $0.08 一张，gemini-3-pro-image 的 $144 / 100 万约 $0.16 一张。
详细换算见图片生成。
思考按输出计费。 gemini-3.7-flash 会先思考再作答，思考 token 与普通输出同价——
一句话的回复也可能消耗上百个输出 token。它们同样占用 max_tokens：设得太小，预算会被
思考全部吃掉，只剩一个空回复，而这个空回复照样收费。建议不传 max_tokens，或留足空间。
各厂商官方价是我们的校准来源，不是你的实际扣费依据：
- Google（Gemini）：https://ai.google.dev/gemini-api/docs/pricing
- DeepSeek：https://api-docs.deepseek.com/quick_start/pricing
- Kimi（Moonshot）：https://platform.moonshot.cn/docs/price/chat
- Qwen（阿里百炼 Model Studio）：https://help.aliyun.com/zh/model-studio/models