Photo IA (reconnaissance d'aliments)

Description

Photographier un repas (ou choisir une image dans la galerie) pour que l'IA identifie les aliments visibles, estime les portions, les valeurs nutritionnelles et les allergènes probables, puis importer chaque aliment reconnu dans la bibliothèque.

Objectif

Créer rapidement des fiches aliments pour un plat ou un produit sans avoir à les chercher ni à les saisir un par un.

Prérequis

Permissions : caméra pour « Appareil photo », photothèque pour « Galerie » (voir Permissions). Cet écran ne gère pas lui-même le refus : la demande est déléguée au système.
Connexion : requise (appel à OpenRouter).
Configuration : une clé OpenRouter et un modèle OpenRouter compatible vision sont obligatoires (voir Limites). Les fournisseurs Ollama, Anthropic et OpenAI ne peuvent pas être utilisés pour cette fonctionnalité.

Comment l'utiliser

Ouvrir « Photo » depuis les chips « Découvrir » de la recherche ou de la bibliothèque.
Choisir « Appareil photo » ou « Galerie » ; la photo est compressée à 80 % de qualité.
Toucher « Analyser avec l'IA » ; l'analyse affiche « Analyse en cours… ».
Le résultat contient : une description de la scène, d'éventuels avertissements globaux, une carte par aliment reconnu (nom, catégorie, poids estimé, kcal, protéines, glucides, lipides, allergènes probables, note FODMAP, niveau de confiance élevé/moyen/faible) et un total estimé en kcal.
« Importer » sur une carte ajoute cet aliment à la bibliothèque ; « Analyser une autre photo » repart de zéro.

Options

Aucune option réglable. Le niveau de confiance (élevé, moyen, faible) est indiqué pour chaque aliment par un badge coloré.

Paramètres associés

Dans Paramètres : la clé OpenRouter (openrouter.apiKey) et le modèle OpenRouter (openrouter.model). Voir aussi Référence — Paramètres.

Données utilisées

Donnée	Détail
Photo	Envoyée à OpenRouter (encodée en base64, format JPEG) avec chaque analyse — elle quitte donc l'appareil. Elle n'est pas conservée par Nutritor après l'analyse.
Réponse de l'IA	Utilisée pour créer les fiches ; seuls les aliments importés sont enregistrés
Aliment importé	Ajouté à `nutritor:foods` sous un identifiant `photo-<nom>-<horodatage>`, marque « Analyse photo IA », portion par défaut = poids estimé

Résultat

Des fiches aliments créées en quelques secondes, avec macros pour 100 g, allergènes probables (parmi 8 : gluten, lactose, œufs, arachides, fruits à coque, soja, poisson, crustacés) et badges de compatibilité simples.

Fonctionnement hors connexion

Aucun — l'analyse nécessite une connexion à OpenRouter. Voir Hors connexion.

Fonctionnement en ligne

Requis pour toute analyse.

Limites

OpenRouter uniquement. Même si Anthropic ou OpenAI est sélectionné comme fournisseur IA principal, l'analyse de photo utilise la clé et le modèle OpenRouter saisis dans Paramètres. Avec Ollama, les boutons sont désactivés et un bandeau explique pourquoi.
Le modèle doit être reconnu comme capable de lire des images. Cette reconnaissance se fait d'après le nom du modèle (par exemple « gpt-4o », « gemini », « claude-3 », « llava », « pixtral », « vision »…) ; un modèle compatible mais au nom non reconnu serait refusé.
Les estimations sont approximatives (l'application indique ±30 %) — vérifier les valeurs avant d'enregistrer.
Les fibres, sucres, graisses saturées et sel sont enregistrés à 0 sur la fiche importée : l'IA ne les estime pas ici.
Aucun contrôle de doublon : importer deux fois le même aliment crée deux fiches.
Contrairement à CIQUAL et Open Food Facts, l'import n'est pas suivi d'un enrichissement IA automatique.
Le bouton « retour » ramène toujours à l'écran de recherche.

Erreurs possibles

« La reconnaissance photo nécessite OpenRouter » — fournisseur Ollama sélectionné.
« Clé API OpenRouter manquante » / « Aucun modèle OpenRouter sélectionné » — à renseigner dans Paramètres.
« Le modèle … ne supporte pas l'analyse d'images » — choisir un modèle compatible vision.
« L'IA n'a retourné aucune réponse » — fréquent avec les modèles gratuits temporairement surchargés ; réessayer.
« L'IA n'a pas respecté le format JSON » — la réponse reçue est affichée partiellement ; relancer l'analyse.
Erreur « OpenRouter <code> » — erreur renvoyée par le service (clé invalide, quota…).

Dépannage

FAQ

Ma photo est-elle conservée ?

Nutritor ne l'enregistre pas, mais elle est transmise à OpenRouter pour l'analyse (voir Données et confidentialité).

Pourquoi les boutons sont-ils grisés ?

Le fournisseur IA sélectionné est Ollama, ou le modèle OpenRouter configuré n'est pas reconnu comme compatible vision. Le bandeau en haut de l'écran indique la raison.

J'utilise Claude (Anthropic) comme IA : puis-je analyser des photos ?

Pas directement : cette fonction passe obligatoirement par OpenRouter, avec sa propre clé et son propre modèle.