Quels formats de fichier puis-je télécharger ?
Fichiers CAO : DWG, DXF, DWF, DGN
Fichiers image : PNG, TIFF, JPG, JPEG, BMP, EMF, GIF
Le fichier doit avoir une extension valide dans son nom — un fichier sans extension (ou avec une extension incorrecte) ne sera pas traité.
Quelle est la différence entre l'API AI Search et l'API Core Platform ?
L'API AI Search (/api/ai-search/v1/takeoff2D) détecte automatiquement les éléments — murs, portes, fenêtres, pièces — sur un dessin que vous téléchargez. L'API Core Platform (/api/general/v1/takeoff2D) fonctionne avec les projets Kreo Takeoff ordinaires : elle lit les mesures et les groupes créés dans l'application et exporte les PDF. Elles ont des URL de base distinctes mais utilisent la même clé API.
Comment m'authentifier ?
Transmettez votre clé API dans l'en-tête X-API-KEY avec chaque requête. Les clés sont créées sur la page Key Management dans Kreo Takeoff.
J'ai perdu ma clé API. Puis-je la consulter à nouveau ?
Non — pour des raisons de sécurité, la clé n'est affichée qu'une seule fois, lors de sa création. Si vous l'avez perdue, créez une nouvelle clé et mettez à jour votre intégration.
Que signifient les statuts Ready, Calculating, et Failed ?
Calculating — Kreo est toujours en cours de traitement. Pour les projets, cela se produit souvent lorsqu'un fichier CAO doit être converti ; pour les tâches de recherche, cela signifie que l'IA analyse toujours le dessin. Interrogez le point de terminaison de statut jusqu'à ce qu'il change.
Ready — le traitement s'est terminé avec succès. Les opérations de projet (comme la définition de l'échelle) et la récupération des résultats sont maintenant disponibles.
Failed — le traitement n'a pas pu être complété. Vérifiez que le fichier est valide et lisible ; si le problème persiste, contactez le support.
Mon projet est bloqué dans Calculating. Que dois-je faire ?
Les fichiers volumineux ou complexes (en particulier les fichiers CAO) peuvent prendre du temps à convertir. Continuez à interroger GET /projects/{projectId}/status à un intervalle raisonnable. Si un projet reste dans l'état Calculating pendant une durée inhabituellement longue, contactez le support avec votre projectId.
Puis-je analyser un PDF multi-pages avec l'API AI Search ?
Chaque projet AI Search traite exactement une page. Utilisez pageIndex (basé sur zéro) lors de la création du projet pour sélectionner la page, et créez un projet distinct pour chaque page que vous souhaitez analyser. Le fichier ne doit être téléchargé qu'une seule fois — vous pouvez réutiliser la même fileKey.
Combien de temps une fileKey reste-t-elle valide ?
La fileKey renvoyée par le point de terminaison de téléchargement est un identifiant temporaire et reste valide pendant la durée de la session de téléchargement. Téléchargez le fichier et créez votre ou vos projet(s) dans le même flux de travail plutôt que de stocker les clés de fichier pour une utilisation ultérieure.
Mes mesures ne correspondent pas aux dimensions réelles. Pourquoi ?
La cause la plus courante est une échelle manquante ou incorrecte. L'échelle convertit les mesures en pixels en unités du monde réel. Pour un dessin à l'échelle 1:100, définissez drawingCalibrationLineLength à 1 et originalCalibrationLineLength à 100. Vous pouvez définir l'échelle lors de la création d'un projet ou la mettre à jour ultérieurement avec PUT /projects/{projectId}/scale (uniquement lorsque le statut du projet est Ready).
Quelles sont les unités des résultats ?
Les coordonnées (p1, p2, points) sont en pixels par rapport au fichier source. Les longueurs, épaisseurs et périmètres sont en mètres ; les surfaces sont en mètres carrés — calculés à partir de votre échelle calibrée.
L'IA a manqué certains éléments ou a trouvé des faux positifs. Que puis-je faire ?
Augmentez la résolution (DPI). Essayez 450 ou 600 au lieu de la valeur par défaut 300 — une résolution plus élevée aide pour les dessins denses ou détaillés.
Filtrez par confiance. Ajoutez le paramètre de requête confidence (0 à 1) lors de la récupération des résultats pour filtrer les détections de faible confiance.
Réduisez la zone de recherche. Utilisez cropBox pour limiter la recherche à la partie pertinente de la feuille et éviter le bruit provenant des cartouches, légendes et annotations.
Comment rechercher une zone nommée spécifique comme GIA ou GEA ?
Utilisez type: "polygon" avec le paramètre text — par exemple "text": "GEA" trouve le polygone étiqueté comme surface brute. Le paramètre text est obligatoire pour les recherches de polygones et doit être omis pour tous les autres types.
Que fait includeWalls ?
Il est disponible uniquement pour les recherches type: "space" et étend les limites de l'espace détecté aux lignes centrales des murs — utile lorsque votre convention de mesure inclut la moitié de l'épaisseur du mur environnant.
Contactez notre équipe à [email protected] ou via le chat intégré — incluez votre projectId et, pour les problèmes de recherche, l'jobId, et nous vous aiderons. Documentation complète de l'API : kreo-software.readme.io.
