Wer Gelände oder Nachbarbebauung für ein Projekt braucht, landet sonst bei 16 Landesportalen mit eigenen Formaten, Kachelschnitten und Koordinatensystemen. Die DEUKOS API bündelt das: eine Schnittstelle, ein Bereich, fertige Dateien in IFC, DXF, GLB, OBJ oder als Geländedaten – für ganz Deutschland, die Schweiz und Liechtenstein.

Was das ist: Eine REST-Schnittstelle zu denselben Exporten wie in der DEUKOS-Karte. Sie liefert Gebäude (LoD2), Gelände (DGM1) und Flurstücke, soweit diese frei abgegeben werden. Die Geometrie besteht aus Flächen und Körpern, nicht aus parametrischen Bauteilen. Abgerechnet wird nach Fläche: 15 € je km² inkl. USt, vom Guthaben, ohne Abo.

Kurz gesagt
  • Bereich per Adresse, Mittelpunkt oder Koordinaten angeben, Format wählen, Dateien abholen.
  • 15 € je km² (0,15 € je Hektar), Guthaben ab 100 €, getrennt von den Abos der App.
  • Beschrieben als OpenAPI und als Anleitung für KI-Assistenten, damit ein Assistent die API ohne Handarbeit bedienen kann.
  • Ausprobieren ohne Konto: ein Bereich bis 50 × 50 m ist kostenlos, ganz ohne Schlüssel.

Wofür Büros die API nutzen

Projektstart ohne Handarbeit

Neues Projekt im Büro angelegt, ein Skript holt das Umgebungsmodell als IFC und legt es in den Projektordner. Niemand muss die Karte öffnen, den Bereich ziehen und die Datei verschieben.

Der KI-Assistent holt das Modell

„Hol mir das Umgebungsmodell für die Musterstraße 5 in Köln, 400 Meter, als IFC.“ Ein Assistent, der Schnittstellen aufrufen kann, findet in unserer Beschreibung alles Nötige: welches Format zu welchem Programm passt, wie er den Bereich angibt und was er bei einem Fehler tun soll.

Eigene Werkzeuge im Büro

Grasshopper-Definition, Dynamo-Skript oder eigenes Auswertungsprogramm: Gelände und Gebäude kommen direkt aus der API, statt dass jemand Kacheln von Hand zusammensucht.

So funktioniert es

  1. Bereich prüfen – Adresse und Größe angeben, die API löst den Ort auf, nennt Fläche, Gebäudezahl und Preis. Das kostet nichts.
  2. Export bestellen – Format wählen und abschicken. Der Preis wird vom Guthaben abgebucht; schlägt der Auftrag fehl, wird er erstattet.
  3. Status abfragen – nach wenigen Minuten ist der Auftrag fertig.
  4. Dateien abholen – jede Datei hat eine eigene Adresse.
curl -X POST https://deukos.de/api/v1/exports \
  -H "Authorization: Bearer $DEUKOS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: projekt-4711-ifc" \
  -d '{"profile": "ifc", "address": "Marienplatz 1, München", "size_m": 500}'

Den Bereich kannst Du auf drei Arten angeben: als Adresse mit Größe in Metern, als Mittelpunkt in Längen- und Breitengrad oder als Rechteck (west, süd, ost, nord). Alle Beispiele in curl und Python stehen in der vollständigen Anleitung.

Formate

ProfilInhaltTypisch für
ifcGebäude und Gelände als IFC, dazu GeländepunkteArchicad, Revit, Vectorworks, Allplan
dxfGebäude, Flurstücke, Höhenkoten, HöhenlinienAutoCAD, BricsCAD, Umgebungsplan
glb3D-Modell Gelände und GebäudeBlender, Cinema 4D, SketchUp, Twinmotion
obj3D-Modell Gelände und Gebäude3ds Max, andere 3D-Programme
rhinoRhino-Paket: natives 3DM mit Layern, Gelände-Mesh und NURBS-GeländeRhino 7 oder neuer, Grasshopper
gelaendePunktraster (5, 2 oder 1 m) und HöhenlinienGeländeauswertung, eigene Programme

Rhino und Grasshopper

Für Rhino holst Du das Profil rhino: dasselbe Rhino-Paket wie in der DEUKOS-Karte, also eine native 3DM-Datei mit Layern, Gelände-Mesh je Nutzungsfläche und NURBS-Gelände auf einem ausgeblendeten Layer – kein OBJ, keine Umwandlung. In Grasshopper rufst Du die API mit einem Python-Baustein auf; die Anleitung enthält dafür ein fertiges Beispiel, das ohne Zusatzpakete auskommt.

So sagst Du es Deinem KI-Assistenten

Ein Assistent, der Webschnittstellen aufrufen oder Code ausführen kann – etwa Claude oder ChatGPT mit Werkzeugen, Claude Code oder Cursor –, braucht nur zwei Dinge: Deinen Schlüssel als Umgebungsvariable DEUKOS_API_KEY (nie in den Chat kopieren) und einen Satz:

Nutze die DEUKOS API. Die Anleitung steht unter
https://deukos.de/api/v1/docs.md

Danach genügt ein Auftrag wie: „Hol mir das Umgebungsmodell für die Musterstraße 5 in Köln, 400 × 400 Meter, als IFC für Archicad.“ Der Assistent löst die Adresse auf, nennt Dir Ort und Preis – hier 2,40 € –, bestellt erst nach Deiner Bestätigung und legt die Datei ab.

Für Entwickler

Die Schnittstelle ist so beschrieben, dass ein Assistent sie selbst richtig bedienen kann. Die Beschreibung legt fest, welches Profil zu welchem Programm gehört. Sie nimmt Adressen statt Koordinaten an, nennt Ort und Preis vor der Bestellung zur Bestätigung und regelt für jeden Fehlercode, ob ein Assistent es erneut versuchen soll. So bestellt er nicht doppelt und gibt kein Guthaben ohne Rückfrage aus.

Sofort ausprobieren – ohne Konto

Bevor Du Dich anmeldest, kannst Du oder Dein KI-Assistent einen kleinen Bereich kostenlos abrufen. So siehst Du, was ankommt, bevor Du irgendetwas bezahlst.

echo '{"profile": "ifc", "address": "Prinzipalmarkt 10, Münster"}' > auftrag.json
curl -s -X POST https://deukos.de/api/v1/trial \
  -H "Content-Type: application/json" -d @auftrag.json

Zugang und Kosten

15 € je km² 0,15 € je Hektar, inkl. USt – Guthaben ab 100 €, kein Abo. Guthaben kaufen und Schlüssel anlegen

Ein kostenloses Konto genügt: anmelden, unter Einstellungen Guthaben kaufen und einen Schlüssel anlegen. Die Tarife der App stehen auf der Seite Preise.

Was die API nicht ist

  • Kein Datenbestand zum Mitnehmen: Ergebnisse darfst Du in Deinen Projekten nutzen und je Projekt an Deine Kunden weitergeben. Eigene Datenbestände aus den Abrufen aufzubauen oder sie als Datendienst weiterzuverkaufen, ist nicht erlaubt.
  • Kein Massenabruf: Große Gebiete durch viele aneinandergesetzte Aufträge abzurastern, widerspricht den Nutzungsbedingungen.
  • Kein Trainingsmaterial: Die Daten dürfen nicht zum Training von KI-Modellen verwendet werden.
  • Keine parametrischen Bauteile: Gebäude kommen als Flächen und Körper, nicht als Wände und Decken.

Häufige Fragen

Kann ich die API ohne Konto testen?

Ja. Ohne Konto und ohne Schlüssel ist je Internetanschluss eine Probe bis 50 × 50 m kostenlos, in 30 Tagen einmal (derselbe Bereich in weiteren Formaten zählt nicht extra). Mit kostenlosem Konto und Schlüssel gibt es 3 Proben je Monat bis 50 × 50 m, und mit dem Gutscheincode KI-TEST 3 € Startguthaben, das sofort nutzbar ist – ohne Kauf.

Kann mein KI-Assistent die API selbst bedienen?

Ja, sofern er Schnittstellen aufrufen kann. Gib ihm die Adresse der OpenAPI-Beschreibung oder der Anleitung und Deinen Schlüssel als Umgebungsvariable. Den Rest liest er dort nach. Vor jeder Bestellung nennt er Dir den Preis.

Brauche ich dafür ein Abo?

Nein. Die API läuft über Guthaben, ein kostenloses Konto genügt; nicht verbrauchtes Guthaben bekommst Du beim Widerruf binnen 14 Tagen zurück (AGB Ziffer 9). Hast Du ein Abo der App, bleibt dessen Kontingent unberührt – API und App werden getrennt abgerechnet.

Welche Länder deckt die API ab?

Gebäude und Gelände für alle 16 deutschen Bundesländer, die Schweiz und Liechtenstein. Flurstücke überall dort, wo sie frei abgegeben werden: in allen deutschen Ländern außer Bayern und in 20 Schweizer Kantonen. Woher die Daten stammen, steht unter Datenquellen.

Brauche ich Programmierkenntnisse?

Für ein eigenes Skript reichen Grundkenntnisse; die Anleitung enthält fertige Beispiele für curl und Python. Mit einem KI-Assistenten genügt oft ein Satz.

Was passiert, wenn mein Guthaben aufgebraucht ist?

Die API lehnt den Auftrag mit einer klaren Meldung ab und nennt Preis und Kauflink; es wird nichts berechnet. Nachladen kannst Du jederzeit unter Einstellungen.

Jetzt loslegen

Konto anlegen, Guthaben kaufen, Schlüssel erzeugen – in wenigen Minuten bestellt Dein Programm oder Dein KI-Assistent das erste Umgebungsmodell.

Guthaben kaufen
Anleitung lesen