Drone Footage V2
Preset-driven drone footage generation with style-based camera movements, producing smooth, colour-consistent footage
POST
/v2/drone-footage/generate202Queue preset-driven drone footage generation. V2 uses style-based presets (e.g. front_left_zoom, front_right_approach) instead of V1's direction-based approach, producing smooth, colour-consistent footage.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Full Australian property address |
options.style | string | Yes | One of: "front_left_zoom", "front_right_approach" |
options.duration | integer (3-15) | No | Video duration in seconds (3-15). Defaults to style-dependent value |
options.front_direction | number (0-360) | No | Precise property frontage angle in degrees (0-359). Rotates camera for accurate framing |
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": {
"style": "front_left_zoom",
"duration": 3,
"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"
}
}