模型调用总览
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 | wss://api.mafdet.ai/v1/realtime | 实时语音、实时转录 | Beta |
在 同一个 Surface 内，换模型只需改 model 字段；跨 Surface 不行——把 embeddings
模型发给 /v1/chat/completions 会在调用 provider 前被 model_api_surface_mismatch 拒绝。
Realtime 是唯一一个不走普通 HTTP 请求的 Surface：先用 Key 换一张一次性票，再拿票开 WebSocket。见实时语音 (WebSocket)。
各 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-k3（1M）、kimi-k2.6与kimi-k2.7-code系列（256K）
可用模型
对话 (Chat)
POST /v1/chat/completions
Google (Gemini)
| 模型 | 模型 ID | 上下文长度 | 价格 |
|---|---|---|---|
| Gemini 3.8 Flash | gemini-3.8-flash | 1,048,576 | text in $1.80 / 1M text out $9.00 / 1M |
| Gemini 3.7 Flash | gemini-3.7-flash | 1,048,576 | text in $1.80 / 1M text out $9.00 / 1M |
| Gemini 3.5 Transcribe (Preview) (Preview) | gemini-3.5-transcribe | 90,000 | text in $3.00 / 1M text out $14.40 / 1M |
| Gemini 3 Pro (Preview) (Preview) | gemini-3-pro | 1,048,576 | text in $4.80 / 1M text out $21.60 / 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 $3.00 / 1M text out $18.00 / 1M |
| Gemini 2.5 Flash | gemini-2.5-flash | 1,048,576 | text in $1.20 / 1M text out $3.00 / 1M |
| Gemini 2.5 Flash-Lite | gemini-2.5-flash-lite | 1,048,576 | text in $0.36 / 1M text out $0.48 / 1M |
| Gemini 3 Flash (Preview) (Preview) | gemini-3-flash-preview | 1,048,576 | text in $1.20 / 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.1 Flash | deepseek-v4-flash | 128,000 | text in $0.36 / 1M text out $1.44 / 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.975 / 1M text out $4.05 / 1M |
| Kimi K2.7 Code Highspeed | kimi-k2.7-code-highspeed | 256,000 | text in $1.95 / 1M text out $8.10 / 1M |
| Kimi K2.6 | kimi-k2.6 | 256,000 | text in $0.975 / 1M text out $4.05 / 1M |
Qwen
| 模型 | 模型 ID | 上下文长度 | 价格 |
|---|---|---|---|
| Qwen Max | qwen-max | 32,768 | text in $0.36 / 1M text out $1.44 / 1M |
| Qwen Plus | qwen-plus | 131,072 | text in $0.72 / 1M text out $9.60 / 1M |
| Qwen Flash | qwen-flash | 1,000,000 | text in $0.18 / 1M text out $1.80 / 1M |
| Qwen Long | qwen-long | 1,000,000 | text in $0.075 / 1M text out $0.30 / 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.18 / 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) (Preview) | gemini-2.5-flash-tts | 8,192 | text in $0.60 / 1M audio out $12.00 / 1M |
| Gemini 2.5 Pro TTS (Preview) (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) (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 |
| Gemini 3.5 Transcribe Live (Preview) (Preview) | gemini-3.5-transcribe-live | 32,000 | text in $4.20 / 1M text out $25.20 / 1M audio in $4.20 / 1M audio out $25.20 / 1M |
权限说明
每个模型都要求一个访问档（FREE / PAID / TRUSTED / ENTERPRISE），而你的订阅套餐
分别为 Playground 和 API Key 授予档位——Starter 的 Playground 能用全部公开模型，
但 API Key 只能调免费模型。返回 MODEL_NOT_ALLOWED 即是这道门，详见
订阅套餐与权限与模型范围。
Preview 与 Beta 模型
部分模型名称带 (Preview) 或 (Beta)，表示上游厂商尚未将其列为正式版（GA）： 行为可能变化，厂商也可能将其下线。计费与访问方式与其它模型完全一致，页面所列价格 即为向你收取的价格。
控制台 Playground 的 Live 界面在 Beta 期间单独按白名单开放；该白名单不影响 API。
价格
页面所列为 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.8-flash、gemini-3.7-flash 和 kimi-k3 /
kimi-k2.6 / kimi-k2.7-code
系列会先思考再作答，思考 token 与普通输出同价——一句话的回复也可能消耗上百个输出 token。
它们同样占用 max_tokens：设得太小，预算会被思考全部吃掉，只剩一个空回复，而这个空回复
照样收费。实测 kimi-k2.6 回答「ok」用掉 27 个输出 token；把 max_tokens 设成 16 则
finish_reason 返回 length、内容为空。建议不传 max_tokens，或留足空间。
kimi-k3 只接受 temperature: 1。 传其它值（包括 0）上游会直接拒绝，返回
400 invalid temperature: only 1 is allowed for this model，这一笔不计费。不传即可。
各厂商官方价是我们的校准来源，不是你的实际扣费依据：
- Google（Gemini）：https://cloud.google.com/vertex-ai/generative-ai/pricing ——我们经 Vertex AI 采购，其价格与 AI Studio 页面并不相同
- DeepSeek：https://api-docs.deepseek.com/quick_start/pricing
- Kimi（Moonshot）：https://platform.kimi.com/docs/pricing/chat
- Qwen（阿里百炼 Model Studio）：https://help.aliyun.com/zh/model-studio/model-pricing