L'API est divisée en deux parties :
API de recherche IA — téléchargez un fichier de conception 2D (PDF, dessin CAO ou image) et laissez l'IA de Kreo détecter et mesurer automatiquement les éléments : murs, portes, fenêtres, pièces et zones personnalisées. Vous obtenez des données structurées — coordonnées, longueurs, épaisseurs, surfaces et périmètres — prêtes à être utilisées dans votre logiciel d'estimation, vos feuilles de calcul ou vos systèmes internes.
API de plateforme principale — travaillez par programmation avec vos projets Kreo Takeoff existants : téléchargez des fichiers, créez des projets, lisez les mesures et les groupes que vous avez créés dans l'application, et exportez les dessins annotés en PDF.
Les cas d'usage typiques incluent l'automatisation des relevés de quantités, l'alimentation des mesures dans les pipelines d'estimation des coûts, la validation des mesures et l'intégration de Kreo avec vos outils ERP ou de gestion de projet.
Chaque requête à l'API doit être authentifiée avec une clé API.
Accédez à la page Key Management dans Kreo Takeoff.
Cliquez sur + Create New Key.
Entrez un nom descriptif (par exemple, Production ou Staging) afin de pouvoir identifier la clé ultérieurement.
Cliquez sur Create Secret Key.
Copiez et stockez la clé de manière sécurisée — elle n'est affichée qu'une seule fois.
Cliquez sur Copy and Close. La clé est maintenant active.
Transmettez la clé dans l'en-tête X-API-KEY avec chaque requête.
Voici le chemin le plus court d'un dessin aux données détectées par l'IA. L'API AI Search se trouve à :
https://takeoff.kreo.net/api/ai-search/v1/takeoff2D1. Télécharger un fichier
bash
curl -X POST "https://takeoff.kreo.net/api/ai-search/v1/takeoff2D/upload" \
-H "X-API-KEY: YOUR_API_KEY" \
-F "[email protected]"La réponse est une clé de fichier, par exemple temp/6c47cb338a7346d88ab843b1e6d8acf2.
2. Créer un projet
bash
curl -X POST "https://takeoff.kreo.net/api/ai-search/v1/takeoff2D/project" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"fileKey": "temp/6c47cb338a7346d88ab843b1e6d8acf2",
"pageIndex": 0,
"scale": { "drawingCalibrationLineLength": 1, "originalCalibrationLineLength": 100 }
}'La réponse contient un projectId et un status. Si le statut est Calculating (par exemple, lors de la conversion d'un fichier CAO), interrogez GET /projects/{projectId}/status jusqu'à ce qu'il devienne Ready.
3. Exécuter une recherche IA
bash
curl -X POST "https://takeoff.kreo.net/api/ai-search/v1/takeoff2D/projects/{projectId}/search" \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "dpi": 300, "type": "wall" }'Vous recevez un jobId. La recherche s'exécute de manière asynchrone — interrogez GET /projects/{projectId}/search/{jobId} jusqu'à ce que le statut soit Ready, et la réponse contiendra les éléments détectés avec les mesures réelles.
Fichiers CAO : DWG, DXF, DWF, DGN
Fichiers image : PNG, TIFF, JPG, JPEG, BMP, EMF, GIF
Les fichiers doivent avoir une extension valide dans le nom du fichier.
La documentation complète des points de terminaison, les schémas et un explorateur API interactif sont disponibles sur notre portail développeur : kreo-software.readme.io.
Si vous avez des questions ou rencontrez des problèmes, contactez-nous à [email protected] ou via le chat intégré à l'application.