Questions fréquentes
Les questions qui reviennent le plus souvent quand une équipe décide si Saphere lui convient, et où se trouve la réponse complète.
Que mesure Saphere, et à partir de quoi ?
Le visage d’une personne, filmé une trentaine de secondes. À partir de la lumière que sa peau renvoie, Saphere reconstitue un signal de pouls et en déduit jusqu’à dix variables : fréquence cardiaque, fréquence respiratoire, variabilité, stress, pression artérielle, âge apparent, indice de masse corporelle et un score cardiovasculaire d’ensemble. La liste complète, avec ce dont chacune dépend, est sur ce qui est mesuré.
Quelles sont les façons de prendre une mesure ?
Trois. Saphere Scan conduit une mesure guidée en direct, dans un navigateur ou une WebView, et vous rend un résultat. L’API prend un fichier que vous avez déjà enregistré, une vidéo ou une suite d’images, et rend le même type de résultat sans aucun widget. Le temps réel, en alpha, mesure une source vidéo qui vous appartient pendant qu’elle se déroule, et rend ses valeurs au fil de l’eau plutôt qu’un résultat conservé. Les deux premières partagent le même serveur ; les équipes qui ont besoin de plusieurs utilisent plusieurs.
Quelle doit être la durée d’une vidéo ?
Trente secondes, la durée d’une capture par le widget. Un fichier de moins de 10 secondes est refusé, et seules les 30 premières secondes environ sont lues, quelle que soit la longueur du fichier. Les conditions d’une bonne mesure énumèrent les autres exigences.
Ai-je besoin d’un serveur à moi ?
Pour tout ce qui atteint la production, oui — un petit point d’accès qui frappe un jeton d’accès pour chaque mesure. La raison n’est pas la commodité du widget mais la vôtre : votre clé d’API ouvre toutes les routes de votre compte et n’expire pas, sauf si vous lui donnez un dernier jour, elle ne doit donc jamais atteindre un navigateur. Le widget demande à votre point d’accès un jeton court et à usage unique à la place. Les jetons d’accès couvrent les trois façons de le câbler, y compris celle qui est réservée aux essais.
Comment obtenir une clé d’API ?
Vous la créez vous-même, dans la console, sur la page API Keys de chaque environnement : un compte n’a aucune clé tant qu’on n’en a pas créé une. La clé n’est montrée qu’une seule fois, juste après sa création, copiez-la donc dans les secrets de votre serveur à ce moment-là ; une clé perdue se remplace par une nouvelle, et l’ancienne se révoque. L’authentification dit le reste. Une clé de Test et une clé de Production sont deux clés différentes et ne sont pas interchangeables — voir les environnements.
Puis-je changer les couleurs et les écrans du widget ?
Oui, les deux. Vous les préparez dans la console ops, avec l’atelier de personnalisation, et vous attachez le résultat au widget par son identifiant. Rien n’est recopié dans votre code, et un changement ne demande aucun déploiement de votre côté. La personnalisation explique comment.
Quelles langues parle-t-il ?
Dix : arabe, allemand, anglais, espagnol, français, italien, polonais, portugais, portugais du Brésil et turc. La mise en page se reflète pour l’arabe, de la barre d’outils aux chevrons.
Fonctionne-t-il dans une application mobile ?
Oui, dans une WebView — React Native, Ionic/Capacitor, ou une coque native. L’autorisation caméra doit être accordée par l’application hôte, et c’est l’étape que la plupart des intégrations manquent en premier. L’intégration en WebView en donne le détail par plateforme.
Pourquoi une mesure est-elle revenue sans aucune variable ?
Presque toujours un droit plutôt qu’un échec : les variables qu’un compte peut recevoir se configurent sur le compte. Un résultat avec un score de qualité et un returnedVariables vide veut dire que le compte n’a pas reçu les variables que vous avez demandées ; demandez à i-Virtual d’activer celles dont vous avez besoin.
Pourquoi une variable a-t-elle échoué alors que les autres ont réussi ?
Parce qu’elle avait besoin de quelque chose dont elle ne disposait pas — la taille et le poids pour l’indice de masse corporelle, les champs démographiques pour le risque tensionnel et le score cardiovasculaire, un externalId et une calibration pour la pression artérielle. Cette variable revient porteuse d’un code d’erreur qui nomme ce qui manquait ; le reste de la mesure n’en est pas affecté. Ce qui est mesuré dit ce dont chacune a besoin.
Quelles conditions une bonne mesure demande-t-elle ?
De la lumière sur le visage, une personne immobile, un visage découvert, et un cadrage correct à 40-60 cm avec le haut du buste visible. Les conditions d’une bonne mesure expliquent pourquoi chacune n’est pas négociable et comment le widget guide vers la bonne position.
Que se passe-t-il après l’envoi d’une vidéo ?
Le serveur la traite et rend les variables auxquelles votre compte a droit, chacune avec sa valeur ou le code qui dit pourquoi elle n’a pas pu être produite. Deux voies existent : un appel unique qui porte le fichier et les options ensemble, ou un enchaînement en deux temps qui crée d’abord la mesure et téléverse le fichier ensuite. Les deux sont sur la page des mesures.
Quels formats vidéo sont acceptés ?
.mp4, .avi, .mov et .webm, jusqu’à 100 Mio, de 13 à 35 images par seconde. Seules les 30 premières secondes environ sont lues.
Comment fonctionne le système de crédits ?
Chaque variable qu’une mesure calcule avec succès consomme des crédits — le coût de cette variable, tel qu’il est configuré sur votre compte. Une mesure qui rend quatre variables coûte donc la somme de ces quatre-là, et une variable qui n’a pas pu être calculée ne coûte rien. Les crédits se comptent par mois calendaire : une dotation neuve chaque mois, et ce qui n’a pas été dépensé n’est pas reporté.
Une mesure temps réel est décomptée au temps plutôt qu’à la variable : son coût, posé lui aussi sur votre compte, est débité pour chaque tranche de 60 secondes, payée d’avance — la première à l’ouverture de la session, puis une au début de chaque minute de plus qu’elle reste ouverte, qu’elle reçoive des données ou non. La session la plus courte coûte donc une tranche, et rien n’est décompté à la fermeture. Une session dont le crédit restant ne couvre pas la première tranche est refusée à l’ouverture, et un coût temps réel laissé vide veut dire que la mesure temps réel n’est pas disponible sur le compte.
Que se passe-t-il quand les crédits sont épuisés ?
Une mesure se déroule encore, mais elle n’est pas décomptée et ne rend aucune valeur : chacune de ses variables revient avec le code CREDIT_EXCEEDED, et le widget affiche un message le disant plutôt que d’échouer en silence. Cela dure jusqu’à la dotation du mois suivant, ou jusqu’au relèvement de la dotation. Si vous attendez un pic, demandez ce relèvement avant plutôt qu’après.
Une session temps réel est refusée ou coupée à la place : celle dont la dotation restante ne peut pas payer une première tranche ne s’ouvre pas, et la première tranche suivante qu’elle ne couvre pas la ferme, avec le code de fermeture 5 et la raison credit exceeded (voir le protocole temps réel).
Pourquoi ma mesure a-t-elle échoué ?
L’endroit où elle a échoué en dit le plus.
À l’ouverture de la mesure — la session n’a pas pu s’ouvrir. Soit votre point d’accès n’a pas rendu de jeton exploitable, ce que token:error signale en quelques secondes ; soit le serveur a refusé le jeton — déjà utilisé, expiré, frappé pour l’autre chaîne ou pour un compte inactif. Un jeton refusé ne fait pas attendre le widget : il retente la connexion quelques fois, ce que transport:reconnecting signale tentative par tentative, puis renonce en quelques secondes — la mesure se termine sur measure:failed, code WS_CONNECTION_ERROR, bien avant la fin de la capture.
Pendant la capture — la session a été interrompue :
- la caméra est devenue indisponible — une autre application l’a prise, ou l’autorisation a été retirée ;
- le réseau n’a pas laissé passer les images ;
- la personne a annulé.
Après la capture — la mesure s’est terminée, mais les conditions n’étaient pas réunies. Elle arrive tout de même comme un résultat, et chaque variable qu’elle n’a pas pu calculer porte un code qui en nomme la raison :
- aucun visage trouvé, ou le visage a quitté le cadre ;
- lumière trop faible, trop dure, ou à contre-jour ;
- trop de mouvement pendant la capture.
Les conditions d’une bonne mesure couvrent celles qui dépendent de l’environnement, code par code.
Comment diagnostiquer une mesure en échec ?
Écoutez le flux d’événements. measure:aborted porte la raison pour laquelle la mesure a été arrêtée volontairement, measure:failed celle pour laquelle le système n’a pas pu l’achever, et chacun porte un code plutôt qu’un message — un code ne change pas avec la langue d’affichage. Une mesure terminée dans de mauvaises conditions n’en fait pas partie : elle arrive comme measure:result, avec un code sur chaque variable qu’elle n’a pas pu calculer. La liste complète est dans les événements.
Comment Saphere protège-t-il les données personnelles ?
Le traitement se limite à produire les indicateurs de signes vitaux pour lesquels la mesure existe. Sauf si votre compte est réglé pour les garder, les images capturées ne sont conservées que le temps que le calcul en a besoin, et une mesure peut être supprimée par l’API — ce qui retire les objets stockés en plus de l’enregistrement, dans cet ordre, de sorte qu’aucune capture ne survive à l’enregistrement qui l’adresse.
Où les données sont-elles hébergées ?
En France, chez OVHcloud. Tout ce qui circule entre l’appareil et la plateforme est chiffré, et la connexion à la base est authentifiée en plus d’être chiffrée.
Comment envoyer un retour ou signaler un problème ?
Par courriel, à issue@i-virtual.ai. Joignez l’identifiant de la mesure s’il y en a un — c’est ce qui permet de remonter au problème.
Peut-on essayer avant d’intégrer ?
Oui — le widget peut viser directement l’API avec votre clé, sans point d’accès à vous, précisément pour cela. Cette stratégie s’appelle unsafe-api-key parce que c’est ce qu’elle est : elle place dans une page une clé qui ouvre tout votre compte. À réserver aux essais, jamais à la production.