---
title: "Rendu réaliste d'un projet sur la vue aérienne"
method: POST
path: "/urbanisme/rendus"
---

# Rendu réaliste d'un projet sur la vue aérienne

`POST /urbanisme/rendus`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/urbanisme/rendus`
- Auth: HTTP bearer

Une image réaliste du projet posé à l'échelle sur la photo aérienne de l'IGN : la photo est lue en direct, le dessin exact du projet y est composé, puis un modèle d'image rend le seul projet réaliste, sans rien ajouter ni déplacer. L'image est une illustration indicative : elle ne remplace pas le document graphique d'insertion du dossier. En REST, la réponse est l'image PNG ; en MCP, ses métadonnées, et l'image en ressource. Les rendus sont bornés par heure et par organisation, comme dans le Hub. Coût : 100 crédits par appel réussi.

## Request body

- object
  - `emprise` unknown[], required: Emprise de la vue [ouest, sud, est, nord] en degrés, 1500 m de côté au plus (vues.aerienne du plan de situation de croquis_projet).
    - unknown
  - `projets` object[], required
    - `nature` 'extension' | 'annexe' | 'abri' | 'garage' | 'carport' | 'piscine' | 'terrasse' | 'veranda' | 'autre', required
    - `contour` array[], required: Les quatre coins [lon, lat] du projet (contour_wgs84 de croquis_projet).
      - unknown[]
        - unknown
    - `largeur_m` number, required
    - `profondeur_m` number, required
    - `hauteur_m` number

## Response `200`

Le fichier, débité (sauf réponse identique déjà servie dans les 24 h). Les métadonnées sont dans x-pillr-metadonnees (structuredContent côté MCP).

## Other responses

- `400`: Paramètres invalides
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)