Drone Stills V2
POST
/v2/drone-stills/capture202Generate an enhanced 4K aerial drone still from a freeform camera pose (azimuth around the property, tilt from nadir, distance in metres). The continuous generalisation of the angle/distance presets on /v1/drone-stills/generate.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Full Australian property address |
camera.azimuth | number (0-360) | Yes | Camera position around the property, degrees clockwise. 0 places the camera directly in front when front_direction is provided; otherwise 0 is due north of the property. |
camera.tilt | number (0-75) | Yes | Camera tilt from nadir in degrees. 0 looks straight down (top-down); higher values lower the camera toward the horizon. |
camera.distance | number (50-1200) | Yes | Camera distance from the property in metres. |
camera.pitch | number (0-30) | No | Degrees the camera angles UP from the property, bringing the horizon into frame. 0 (default) aims square at the property. Ignored for near-nadir tilts (< 5°), and clamped so tilt + pitch stays below the horizon. |
options.front_direction | number (0-360) | No | Property frontage angle in degrees (0-359). When provided, camera.azimuth is interpreted relative to the property front (0 = in front of the property). |
options.lat | number | No | Pre-resolved latitude — skips geocoding when provided with lng |
options.lng | number | No | Pre-resolved longitude — skips geocoding when provided with lat |
options.shot_type | string | No | Enhancement treatment. Defaults by pose: near-nadir tilts get the establishing treatment, angled poses get the hero treatment. |
webhook_url | string (URI) | No | URL to receive progress and completion webhooks |
callback_metadata | object | No | Opaque data returned in webhook payloads |
Request Example
{
"address": "example",
"camera": {
"azimuth": 0,
"tilt": 0,
"distance": 50,
"pitch": 0
},
"options": {
"front_direction": 0,
"lat": 0,
"lng": 0,
"shot_type": "establishing"
},
"webhook_url": "https://example.com/image.jpg"
}Response
{
"data": {
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued"
},
"meta": {
"request_id": "req_abc123",
"timestamp": "2026-03-12T10:00:00.000Z",
"mode": "live"
}
}