--- title: "API Kreo : FAQ et dépannage" description: "Réponses aux questions les plus fréquemment posées sur l'utilisation de l'API Kreo. Vous découvrez l'API ? Commencez par Prise en main de l'API Kreo." url: https://help-takeoff.kreo.net/fr/articles/11688713-api-kreo-faq-et-depannage collection: "API" updated: 2026-10-20 language: fr alternates: [en] --- # API Kreo : FAQ et dépannage Réponses aux questions les plus fréquemment posées sur l'utilisation de l'API Kreo. Vous découvrez l'API ? Commencez par Prise en main de l'API Kreo. ## Général **Quels formats de fichier puis-je télécharger ?** - PDF - 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](https://takeoff.kreo.net/2d/projects). **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. ## Projets et statuts **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. ## Échelle et mesures **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. ## Résultats de la recherche IA **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. ## Toujours bloqué ? Contactez notre équipe à [**info@kreo.net**](mailto:info@kreo.net) 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](https://kreo-software.readme.io).