Passer au contenu principal
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 pour votre organisation, 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.
La résidence se choisit par région, l’UE ou les États-Unis, et non par pays. Au sein d’une région, une session peut s’exécuter sur n’importe lequel de nos clusters ; le traitement n’est pas ancré dans un pays en particulier.

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 toutes nos offres payantes, et un admin de l’organisation la configure dans Studio. Avec le forfait gratuit, les paramètres sont grisés. Survolez-les pour savoir pourquoi, et utilisez Changer de forfait en haut de la section Contrôles des données.
Pour vérifier la configuration actuelle de votre organisation, ouvrez Gradium Studio et allez dans Organisation > Contrôles des données > Résidence des données. La carte indique si la résidence est Activé ou Désactivé et, lorsqu’elle est activée, la Région (Union européenne ou États-Unis) et le Mode d’application. Tous les membres de l’organisation peuvent la voir. Studio nomme les modes d’application d’après ce qu’ils garantissent. L’API et notre équipe support utilisent les noms techniques :

1. Configurez-la dans Studio

En tant qu’admin d’une organisation avec un forfait payant, ouvrez Organisation > Contrôles des données > Résidence des données, puis :
  1. Activez l’interrupteur Résidence des données. Il démarre sur l’Union européenne, en mode Strict.
  2. Si besoin, changez la Région (Union européenne ou États-Unis) ou le Mode d’application (Flexible, Par endpoint ou Strict).
  3. Cliquez sur Enregistrer, en haut de la section Contrôles des données. Le bouton enregistre tous les contrôles des données modifiés : vous pouvez changer l’aucune conservation des données dans la même étape.
La section Contrôles des données, avec l'interrupteur Résidence des données, Région et Mode d'application, et Enregistrer numérotés de 1 à 3
Les nouvelles sessions appliquent le paramètre dès son enregistrement. Studio vous demande de confirmer toute modification qui assouplit une garantie : une autre région, un mode moins strict, ou la désactivation de la résidence. Le paramètre est conservé avec un autre forfait payant ; le passage au forfait gratuit le désactive. Les membres voient les paramètres sans pouvoir les modifier. Sous hébergement de données de santé (HDS), la résidence reste en mode Strict dans l’UE : voir Hébergement de données de santé. Vous utilisez l’API sans Studio ? Contactez support@gradium.ai en indiquant le nom de votre organisation et la région (eu ou us). Par endpoint (explicite) ancre les sessions uniquement lorsque vous appelez l’endpoint de votre région : choisissez-le si seule une partie de votre trafic a besoin de la garantie. Strict (implicite) ancre toute votre organisation, quel que soit l’endpoint appelé. Une organisation a au plus une région de résidence : pour répartir votre trafic entre régions, utilisez Par endpoint 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 pour votre organisation.

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. Pour les détails de la certification ISO 27001 et les ressources de sécurité, consultez Sécurité et conformité et notre Trust Center. Pour un accord de traitement des données (DPA), contactez support@gradium.ai.