Drone Stills
Generate enhanced 4K aerial drone still images from a property address
POST
/v1/drone-stills/generate202Generate an enhanced 4K aerial drone still image for an Australian property address. Returns a finished, high-resolution aerial photograph ready to publish.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Full Australian property address |
options.angle | string | No | Camera angle preset for the aerial still |
options.distance | string | No | Distance tier for compass angles: close=100m, medium=200m, far=300m, extra_far=400m. Default: far |
options.front_direction | number (0-360) | No | Property frontage angle in degrees (0-359). Rotates all angle presets so front faces this direction |
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 |
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",
"options": {
"angle": "front",
"distance": "close",
"front_direction": 0,
"lat": 0,
"lng": 0
},
"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"
}
}