Service de recherche · 4 novembre 2026
Notre moteur privé d’analyse des cultures.
Le moteur privé transforme une image en un relevé versionné de scores et d’incertitude. Cette référence présente notre outil d’évaluation interne. Une API d’analyse pour les clients reste une possibilité future. Notre offre actuelle est une évaluation privée accompagnée d’un rapport. Les exemples reflètent le code examiné le 4 novembre 2026.
Explorer le contrat APIIntégration de recherche auto-hébergée
Un responsable exécute le modèle enregistré avec PyTorch ou ONNX en local et fournit l’adresse du service et la clé serveur. Définissez CROP_VISION_URL avec cette adresse. Gardez la clé sur votre serveur. Des points d’accès et des clés pour les clients relèveraient d’une future API d’analyse distincte.
Envoyer une photo
POST /score accepte les champs multipart image et photo_key. La référence doit contenir de 1 à 200 caractères imprimables. L’envoi doit déclarer Content-Length. Les types JPEG, PNG, WebP, HEIC et HEIF sont acceptés; le décodage dépend des codecs installés.
Limites de l’image : 15 Mio et 25 mégapixels. L’option JSON accepte photo_key et image_url, avec une limite de 16 Kio. Les images distantes exigent un hôte HTTPS autorisé par le responsable et une adresse réseau publique; les redirections sont refusées.
curl "$CROP_VISION_URL/score" \
-H "Authorization: Bearer $CROP_VISION_API_KEY" \
-F "photo_key=your-photo-reference" \
-F "image=@planter.jpg;type=image/jpeg"Utilisez ces exemples dans votre propre environnement serveur.
Conserver la provenance et l’incertitude
| Champ | Signification |
|---|---|
| photo_key | Votre référence de photo, renvoyée telle quelle. |
| model_id | Identifiant du modèle chargé. |
| probs | Probabilités par catégorie de la taxonomie. |
| problem_prob | Probabilité globale d’un problème. |
| predicted_kind | Catégorie prédite ou null en cas d’abstention. |
| abstain / abstain_reason | below_threshold ou ambiguous; motif null lorsqu’une prédiction est renvoyée. |
| threshold / img_size | Seuil et taille d’entrée utilisés par le moteur. |
| scored_at | Horodatage UTC de l’analyse. |
L’abstention n’est pas un diagnostic. Le résultat below_threshold indique que le seuil d’alerte configuré n’est pas atteint. Le résultat ambiguous indique que les deux meilleurs scores sont trop proches. Soumettez les cas incertains à une personne experte.
Gérer les erreurs
- 400
- Référence, données JSON ou champs d’envoi invalides.
- 401
- Jeton d’accès absent ou incorrect.
- 411 / 413
- Taille d’envoi absente ou requête trop volumineuse.
- 415 / 422
- Type de contenu non accepté ou image refusée.
- 502 / 504
- Échec ou délai dépassé lors du téléchargement de l’image.
- 503
- Authentification ou moteur facultatif non configuré.
Ce qui reste prévu
La gravité, les actions recommandées, les clés clients, la facturation à l’usage et un point d’accès public /v1/score font partie de la feuille de route. Le moteur HTTP ne fournit pas ces champs ni ces fonctions. La bibliothèque permet des vecteurs d’image facultatifs, mais cette route HTTP ne les demande pas. Nous définissons séparément les évaluations des clients. Les relevés bruts demeurent chez MicroHabitat.
Sources examinées : crop_vision/serve/server.py et crop_vision/serve/score.py. Examen du code seulement; aucune inférence en ligne n’a été exécutée pour cette page.