---
title: "Api V1 Cao Visite Plan"
method: POST
path: "/api/v1/cao/visite/plan"
tags: ["api-ia", "api-ia"]
---

# Api V1 Cao Visite Plan

`POST /api/v1/cao/visite/plan`

## Request

- Base URL: `https://synergieloc.fr`
- URL: `https://synergieloc.fr/api/v1/cao/visite/plan`
- Auth: API key in header `X-API-Key`

PLAN DE TOURNAGE de la visite 4K : objectif + chemin de caméra.

Body = scène CAO (GET /cao/schema) + réglages de mise en scène :
  - duree_s (8–900 s, défaut 60 ; 480–600 pour une visite d'agence), fps (24|30|60), resolution ('4k'|'1440p'|'1080p')
  - mode : 'deco' (bien meublé) | 'nu' (coque plâtre)
  - objectif : {focale_interieur_mm, focale_exterieur_mm, focale_entree_mm,
                focale_escalier_mm, focale_cloture_mm, focale_min_mm,
                focale_max_mm, adaptatif}
  - cadence  : {hauteur_oeil_mm, vitesse_int_mm_s, vitesse_ext_mm_s,
                vitesse_transition_mm_s, pose_piece_s}
    `pose_piece_s` (défaut 9 s) = durée du BEAT D'INSPECTION joué au centre de
    chaque pièce : tour complet à 360° sur place, regard vers le sol, regard
    vers le plafond, puis recul avec ouverture de l'objectif jusqu'à
    `focale_min_mm` pour la vue d'ensemble. Sous 6 s ces mouvements ne se
    lisent plus (alerte `pose_trop_courte`).
  - chemin   : OPTIONNEL — vos propres points [{position:{x,y,z}, vise:{x,y,z},
               focale_mm, pose_s, plan}] ; ils remplacent le chemin calculé et
               sont vérifiés (hors emprise, dans un mur, focale extrême…).

Retourne le plan JSON à donner tel quel au moteur 4K :
`CAD_startCinematicTour({plan})` dans l'éditeur CAO (ou collé dans le champ
« Plan de caméra piloté » du dialogue Visite 4K). Le rendu vidéo lui-même est
fait par le GPU du navigateur — il n'y a plus de rendu vidéo côté serveur.

Une OPÉRATION de plusieurs bâtiments : la visite de chacun, calculée sur
sa propre scène, puis enchaînées (cao_visite_operation).

## Headers

- `x-api-key` string

## Request body

- object

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/synergieloc/apis/synergieloc-api-immobiliere-pour-les-ia.md) · [All operations](https://skmtc.dev/synergieloc/apis/synergieloc-api-immobiliere-pour-les-ia/llms.txt) · [OpenAPI document](https://skmtc.dev/synergieloc/apis/synergieloc-api-immobiliere-pour-les-ia/revisions/6af072bd388f?raw)