Models overview

Mafdet AI serves models from several providers behind one base URL, https://api.mafdet.ai/v1. Which endpoint you call depends on what the model does — a model only works on its own API surface.

API surfaces

Within the Chat surface you can swap models by changing the model field. Across surfaces you cannot: sending an embeddings model to /v1/chat/completions is rejected with model_api_surface_mismatch before the provider is called.

Realtime is not a public API — it runs in the console Playground for whitelisted organizations only.

Authentication and billing across surfaces

Authentication is identical on every HTTP surface: Authorization: Bearer sk-mafdet-…. One key works for Chat, Embeddings and Speech, subject to the models it is allowed to call.

Billing units differ, and this is where surfaces are not interchangeable:

Which surfaces your plan can actually reach is on What your plan can use.

Choosing a model

• Free trial: gemini-3-flash-lite (billed at $0)
• Multimodal chat (image / PDF / audio / video in): the Gemini 2.5 and 3 families
• Image generation: gemini-3-image, gemini-3-pro-image, gemini-3-flash-lite-image
• Embeddings: gemini-embedding-2 (text), multimodal-embedding-1 (image / video)
• Text to speech: gemini-2.5-flash-tts, gemini-2.5-pro-tts
• Chinese / code / low cost: DeepSeek and Qwen families
• Long context: Kimi (Moonshot) large-context variants

Available models

Access notes

Each model requires an access tier (FREE / PAID / TRUSTED / ENTERPRISE), and your subscription plan grants tiers separately for the Playground and for API keys — on Starter the Playground can use every public model while an API key can only call the free model. A MODEL_NOT_ALLOWED response means that gate; see Subscription plans and Permissions & model scope.

Pricing

Listed prices are the prices Mafdet charges you, in the unit shown for each model — per 1M tokens for text, per image for image embedding, per second for video embedding. Prices may change; the price in effect at call time and your usage records are authoritative.

One price, all the time. Each model has a single input price and a single output price. Every prompt token is billed at that input price — there is no separate cache-hit rate — and the price does not vary by time of day, even where the upstream provider varies its own rates by the hour.

An image is not a million tokens. The image models are priced per 1M output tokens like everything else, but their output is image tokens and one picture is a fixed ~1,120 of them — so gemini-3-image at $72 / 1M works out to about $0.08 per image, and gemini-3-pro-image at $144 / 1M to about $0.16. Worked through in Image generation.

Thinking counts as output. gemini-3.7-flash reasons before it answers, and those tokens are billed at the output price like any other — a one-word reply can still cost a hundred output tokens. They also come out of max_tokens: set it too low and the whole budget goes to reasoning, leaving an empty reply you still pay for. Leave max_tokens unset, or give it room.

Provider list prices are the source we calibrate against, not what you are billed:

• 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 (Alibaba Model Studio): https://help.aliyun.com/zh/model-studio/models