Skip to main content
Gradium exécute l’inférence à la fois dans l’Union européenne et aux États-Unis. Par défaut, vous appelez un endpoint unique, api.gradium.ai, et les requêtes sont acheminées vers le cluster le plus proche. Pour la plupart des clients, cela signifie déjà qu’en pratique, les sessions sont traitées à proximité. La résidence des données s’adresse aux cas où « en pratique » ne suffit pas. Une fois activée sur votre offre, le traitement dans une région choisie devient une garantie appliquée à chaque requête : vos sessions ne sont jamais réacheminées hors de cette région, et chaque réponse vous le confirme.

​
Endpoints

Les trois endpoints exposent la même API : même clé API, mêmes routes, mêmes formats de requête et de réponse. Seul l’hôte change.

​
Ce qui est garanti

Pour une organisation inscrite à la résidence des données dans une région :
  • L’inférence reste dans la région. Les sessions de synthèse vocale, de transcription et de Speech-to-Speech, en WebSocket ou via les endpoints REST POST, s’exécutent sur nos clusters de cette région.
  • Aucun basculement inter-régions. En cas de charge, une session peut être servie par un autre cluster de la même région, mais jamais par un cluster situé en dehors.
  • Refus par défaut. Si une requête ancrée atteint un jour un cluster d’une autre région, elle est refusée plutôt que traitée hors de sa région (voir Refus).
  • Les données de session sont écrites dans la région. Les données de session que nous conservons (voir Zéro rétention des données pour n’en conserver aucune) sont écrites par le cluster qui a servi la session.

​
Résidence des données UE

eu.api.gradium.ai est servi par nos clusters européens. Pour une organisation inscrite à la résidence UE, une session qui démarre sur l’un d’eux reste en Europe : elle n’est jamais confiée à un cluster américain, et une requête ancrée qui en atteindrait un est refusée. La résidence UE est la plus complète des deux, car notre plan de contrôle, qui gère les données de compte, est hébergé dans l’UE pour tous les clients, inscrits ou non. Ainsi, pour une organisation ancrée dans l’UE, l’audio traité pendant une session comme les métadonnées de compte associées restent dans l’Union européenne.

​
Résidence des données US

us.api.gradium.ai est servi par nos clusters américains, sur la côte Est et la côte Ouest. Pour une organisation inscrite à la résidence US, les sessions s’exécutent de façon garantie sur ces clusters et ne sont jamais réacheminées vers l’UE.
La résidence US couvre l’inférence : l’audio et le texte de vos sessions. Notre plan de contrôle est hébergé dans l’UE pour tous les clients : les données de compte, les voix personnalisées et les dictionnaires de prononciation restent donc stockés dans l’UE, et les appels de gestion y sont toujours servis. Si vous avez également besoin du plan de contrôle aux États-Unis, contactez-nous pour un déploiement auto-hébergé.

​
Comment l’activer

La résidence des données est disponible sur nos offres payantes. Elle est activée sur votre offre par notre équipe ; il n’existe pas encore d’option en libre-service.

​
1. Demandez-nous de l’activer

Contactez support@gradium.ai en indiquant le nom de votre organisation et la région souhaitée (eu ou us), puis choisissez l’un des deux modes :
  • Explicite (par défaut) : les sessions sont ancrées lorsque vous appelez l’endpoint régional. Les appels à api.gradium.ai conservent leur comportement actuel. Choisissez ce mode si seule une partie de votre trafic a besoin de la garantie.
  • Implicite : toute votre organisation est ancrée dans sa région, quel que soit l’endpoint appelé. Choisissez ce mode si l’ensemble de votre usage est concerné.
Une organisation dispose d’au plus une région de résidence. Si différentes parties de votre trafic nécessitent des régions différentes, utilisez le mode explicite et choisissez l’endpoint pour chaque intégration.

​
2. Pointez votre intégration vers l’endpoint régional

En mode implicite, cette étape est facultative, puisque chaque endpoint ancre vos sessions dans votre région, mais nous la recommandons tout de même.

​
3. Vérifiez

Chaque réponse indique la résidence effectivement appliquée à la requête : vous pouvez donc la vérifier au lieu de vous fier à un nom d’hôte.
  • REST : l’en-tête de réponse x-gradium-residency.
  • WebSocket : le champ residency du message ready.
TTS ready
Si vous dépendez de la garantie, vérifiez la présence de pinned dans votre client et traitez toute autre valeur comme une erreur de configuration. best-effort sur un endpoint régional signifie que la résidence n’a pas encore été activée sur votre offre.

​
Refus

Une requête ancrée qui atteint un cluster hors de sa région est refusée au lieu d’être traitée hors région :
  • REST : 403 Forbidden
  • WebSocket : code de fermeture 1008 (violation de politique)
Les deux indiquent le motif This request must be sent to the <region> region endpoint. En pratique, cela se produit lorsqu’une organisation en mode implicite appelle un endpoint qui n’est pas ancré dans sa région ; la solution consiste à utiliser eu.api.gradium.ai ou us.api.gradium.ai.

​
Résidence et zéro rétention des données

Les deux sont indépendantes et se combinent :
  • La résidence des données détermine où vos requêtes sont traitées.
  • La zéro rétention des données détermine si les payloads de requête et de réponse sont conservés ou non. Consultez la FAQ pour l’activer.
Pour les détails de la certification ISO 27001 et les ressources de sécurité, consultez Sécurité et conformité. Pour un accord de traitement des données (DPA), contactez support@gradium.ai.