---
title: "Prise en main de l'API Kreo"
description: "Kreo fournit une API REST qui vous permet de connecter le moteur de déploiement de Kreo à vos propres outils et flux de travail — pas besoin d'ouvrir l'application Kreo pour extraire des données de vos dessins."
url: https://help-takeoff.kreo.net/fr/articles/11688710-prise-en-main-de-l-api-kreo
collection: "API"
updated: 2026-11-13
language: fr
alternates: [en]
---

# Prise en main de l'API Kreo

Kreo fournit une API REST qui vous permet de connecter le moteur de déploiement de Kreo à vos propres outils et flux de travail — pas besoin d'ouvrir l'application Kreo pour extraire des données de vos dessins.

## Que pouvez-vous faire avec l'API Kreo ?

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.

## Étape 1 : Créer une clé API

Chaque requête à l'API doit être authentifiée avec une clé API.

1.  Accédez à la page **Key Management** dans [Kreo Takeoff](https://takeoff.kreo.net/2d/projects).
    
2.  Cliquez sur **\+ Create New Key**.
    
3.  Entrez un nom descriptif (par exemple, _Production_ ou _Staging_) afin de pouvoir identifier la clé ultérieurement.
    
4.  Cliquez sur **Create Secret Key**.
    
5.  Copiez et stockez la clé de manière sécurisée — **elle n'est affichée qu'une seule fois**.
    
6.  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.

## Étape 2 : Effectuez votre première 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 à :

```javascript
https://takeoff.kreo.net/api/ai-search/v1/takeoff2D
```

**1\. Télécharger un fichier**

bash

```bash
curl -X POST "https://takeoff.kreo.net/api/ai-search/v1/takeoff2D/upload" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -F "file=@floor-plan.pdf"
```

La réponse est une clé de fichier, par exemple `temp/6c47cb338a7346d88ab843b1e6d8acf2`.

**2\. Créer un projet**

bash

```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

```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.

## Formats de fichier pris en charge

-   **PDF**
    
-   **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.

## Référence API complète

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](https://kreo-software.readme.io).

## Besoin d'aide ?

Si vous avez des questions ou rencontrez des problèmes, contactez-nous à [**info@kreo.net**](mailto:info@kreo.net) ou via le chat intégré à l'application.

## Related

- [Utilisation de l'API AI Search : Détection des murs, portes, fenêtres et pièces](https://help-takeoff.kreo.net/fr/articles/11688711-utilisation-de-l-api-ai-search-detection-des-murs-portes-fenetres-et-pieces.md)
- [Utilisation de l'API Core Platform : Projets, Mesures et Export PDF](https://help-takeoff.kreo.net/fr/articles/11688712-utilisation-de-l-api-core-platform-projets-mesures-et-export-pdf.md)
- [API Kreo : FAQ et dépannage](https://help-takeoff.kreo.net/fr/articles/11688713-api-kreo-faq-et-depannage.md)
- [Kreo Software & Contractor Foreman Intégration](https://help-takeoff.kreo.net/fr/articles/6600742-kreo-software-and-contractor-foreman-integration.md)
