Support & Troubleshooting

---

Contact

Deux canaux selon votre besoin :

Souscription et mise en service (accès applicatif — Intégration, Production, Critique) — BRM de la DTNUM : dtnum-brm-contacts@interieur.gouv.fr

Accompagnement (question technique, incident) : innovation-numerique-relations@interieur.gouv.fr

Accès applicatif : préciser au BRM les services souhaités et l'usage applicatif. L'équipe MirAI crée le compte et transmet le token. Voir Authentification.

Accès utilisateur individuel : le niveau Découverte est accessible par défaut, en libre-service, sur le portail d'accès. Le niveau Développeur nécessite une demande préalable via l'email d'accompagnement ci-dessus, puis se crée aussi en libre-service sur le portail. Voir Premiers pas sur le portail pour un guide pas à pas.

---

Erreurs fréquentes

401 Unauthorized

Cause : Token absent, expiré ou malformé.

Vérifier :

• Que le header Authorization: Bearer <TOKEN> est bien présent
• Que le token n'a pas expiré — voir la durée de validité par niveau dans Authentification, et contacter l'équipe MirAI (voir Contact) pour renouvellement
• Que vous n'envoyez pas le mot Bearer deux fois

# Correct
-H "Authorization: Bearer eyJhbGci..."

# Incorrect
-H "Authorization: eyJhbGci..."
-H "Authorization: Bearer Bearer eyJhbGci..."

---

403 Forbidden

Cause : Token valide mais l'accès au service demandé est refusé.

Vérifier :

• Que votre compte dispose bien des droits sur ce service
• Pour les applications : que le token a bien été créé avec les services nécessaires

---

429 Too Many Requests

Cause : Quota dépassé.

Réponse :

HTTP/1.1 429 Too Many Requests
Retry-After: 42

{"error": "rate limit exceeded"}

Action : Attendre Retry-After secondes avant de réessayer. Implémenter un backoff exponentiel pour les appels en boucle. Voir Quotas et niveaux d'accès.

---

413 Content Too Large

Cause : Fichier audio dépassant la taille maximale autorisée.

Limite : 1 Go par fichier, tous niveaux confondus.

Compresser le fichier ou utiliser un format plus compact (.ogg, .flac) avant envoi.

---

504 Gateway Timeout (mode synchrone audio)

Cause : Le traitement d'un fichier audio long a dépassé le timeout de connexion côté client.

Solution : Utiliser le mode asynchrone (POST /jobs/audio) pour les fichiers longs. Le timeout de connexion ne s'applique pas aux jobs async. Voir Modes d'appel.

---

Job async bloqué en pending

Vérifier :

• La position dans la file (queue_position) : si élevée, le système traite d'autres jobs en priorité
• Que le job n'a pas expiré (rétention 72 h)
• Que le fichier soumis était lisible et dans un format supporté

Si le job reste bloqué plus de 15 min, contacter l'équipe MirAI (voir Contact) avec le job_id.

---

Vérifier l'état du service

curl https://api.mirai.interieur.gouv.fr/health
# → {"status": "ok"}

---

Tester rapidement l'authentification

curl https://api.mirai.interieur.gouv.fr/v1/models \
  -H "Authorization: Bearer <TOKEN>"

Une réponse 200 avec la liste des modèles confirme que le token est valide et l'accès opérationnel.