MirAI API's
MirAI API's est la plateforme d'inférence IA du ministère. Elle expose une API unifiée et standardisée pour consommer des modèles d'intelligence artificielle — audio, texte, recherche sémantique — sans se préoccuper de l'infrastructure sous-jacente.
Endpoint de production : https://api.mirai.interieur.gouv.fr
Documentation interactive (Swagger) : https://api.mirai.interieur.gouv.fr/docs
Infrastructure interne (Diffusion Restreinte) : https://api.mirai.interieur.rie.gouv.fr — catalogue et conditions d'accès propres, voir Infrastructures.
Changement d'endpoints. Les anciens endpoints
gateway.api.ai.numerique-interieur.com(API) etacces.api.ai.numerique-interieur.com(portail d'accès) sont dépréciés et seront retirés le 7 novembre 2026. Mettez à jour vos intégrations versapi.mirai.interieur.gouv.fretacces.api.mirai.interieur.gouv.fravant cette date — passé le 7 novembre 2026, les appels vers les anciens endpoints ne fonctionneront plus.
À qui s'adresse cette offre
- Équipes de développement souhaitant intégrer l'IA dans leurs applications métier
- Data scientists et équipes data construisant des pipelines de traitement audio ou texte
- Intégrateurs cherchant une compatibilité OpenAI sans dépendance à un fournisseur externe
Pourquoi MirAI API's
Compatibilité OpenAI
Tous les endpoints LLM, audio et embeddings sont compatibles avec le SDK OpenAI. Si votre application utilise déjà openai.ChatCompletion ou openai.Audio.transcribe, il suffit de changer le base_url — aucune réécriture de code.
Infrastructure souveraine
Les modèles tournent sur des serveurs GPU hébergés en France chez Scaleway, opérateur cloud français. Les données restent sur le territoire national et ne transitent pas vers des fournisseurs de cloud extra-européens. Une seconde infrastructure, interne au ministère, est également disponible pour les besoins allant jusqu'au niveau Diffusion Restreinte — voir Infrastructures.
Async natif
Les traitements longs (audio 1 h, batches de documents) passent par une file asynchrone Redis : soumettez votre job, récupérez le résultat quand il est prêt — par polling ou webhook — sans maintenir la connexion ouverte.
Modèles mesurés
Les performances sont issues de benchmarks réels, pas de promesses marketing. Les chiffres présentés dans cette documentation sont mesurés en conditions de production.
Gateway
Toutes les requêtes transitent par une gateway centralisée accessible à l'adresse https://api.mirai.interieur.gouv.fr. Elle est responsable de :
- Routage — chaque requête est dirigée vers le bon service selon le modèle et le type d'opération
- Rate limiting — application des quotas par consommateur en fenêtre fixe
- Détection PII — les données personnelles identifiables (e-mail, téléphone, IBAN, carte bancaire, SIREN/SIRET) peuvent être détectées et bloquées avant transmission au modèle
- Cache — les requêtes identiques sont mises en cache (TTL configurable) pour réduire la latence et la consommation
- Traitement asynchrone — les jobs longs (audio, batches) passent par une file avec scaling automatique
- Observabilité — métriques et traces exposées par consommateur
Services disponibles
| Service | Statut | Modèle | Endpoint |
|---|---|---|---|
| Transcription audio | Beta | faster-whisper-large-v3-turbo | POST /v1/audio/transcriptions |
| Diarisation audio | Beta | pyannote-diarization | POST /v1/audio/diarizations |
| Chat LLM | Stable | 8 modèles disponibles | POST /v1/chat/completions |
| Vision | Beta | Qwen3-VL-8B-Instruct | POST /v1/chat/completions |
| Génération d'images | Bientôt | Z-Image-Turbo | POST /v1/images/generations |
| Embeddings | Beta | bge-m3 | POST /v1/embeddings |
| Reranking | Beta | bge-reranker-v2-m3 | POST /v1/rerank |
Accès
| Niveau | Profil | Obtention |
|---|---|---|
| Découverte | Individuel — tests, scripts | Libre-service, par défaut — portail d'accès |
| Développeur | Individuel — prototypage, assistants de code | Sur demande, puis libre-service — portail d'accès |
| Intégration | Application en développement / pilote | Via l'équipe MirAI |
| Production | Application métier en production | Via l'équipe MirAI |
| Critique | Service haute disponibilité | Via l'équipe MirAI — sur demande |
Voir Quotas et niveaux d'accès pour le détail des limites par niveau.
