Drone Footage

Generate AI-powered aerial drone footage for any Australian property address. Returns a finished, cinematic flyover video.

Overview

The drone footage endpoint generates a short aerial video from a property address. You can optionally specify a camera direction to control the perspective of the flyover. Send a request and get a finished flyover video back.

Available camera directions:

Direction	Description
`original`	Default camera angle (auto-selected based on property orientation)
`north`	Camera faces north
`south`	Camera faces south
`east`	Camera faces east
`west`	Camera faces west
`topdown_zoomout`	Top-down view zooming out from the property
`topdown_zoomin`	Top-down view zooming in toward the property

Quick Example

Submit a property address to generate drone footage:

curl -X POST \
  -H "X-API-Key: dome_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "123 Collins Street, Melbourne VIC 3000",
    "options": {
      "direction": "north",
      "duration": 5
    }
  }' \
  https://api.dometech.com.au/v2/drone-footage/generate

Response (202):

{
  "data":  {
    "job_id":  "550e8400-e29b-41d4-a716-446655440000",
    "status":  "queued"
  },
  "meta":  {
    "request_id":  "req_abc123",
    "timestamp":  "2026-02-09T10:00:00.000Z",
    "mode":  "live"
  }
}

Step-by-Step

1. Submit the Generation Request

Send a POST request to /v2/drone-footage/generate with the property address. Optionally include a camera direction.

curl -X POST \
  -H "X-API-Key: dome_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "42 Harbour Road, Sydney NSW 2000"
  }' \
  https://api.dometech.com.au/v2/drone-footage/generate

The API returns a 202 Accepted response with a job_id. The video is generated asynchronously.

2. Poll for Completion

Poll the job status endpoint until the status changes to completed. We recommend polling every 5 seconds for the first minute, then every 15 seconds after that.

curl -H "X-API-Key: dome_live_your_key_here" \
  https://api.dometech.com.au/v1/jobs/550e8400-e29b-41d4-a716-446655440000

3. Retrieve the Video

When the job completes, the output field contains the video URL, thumbnail, and duration.

{
  "data":  {
    "id":  "550e8400-e29b-41d4-a716-446655440000",
    "job_type":  "drone_footage",
    "status":  "completed",
    "mode":  "live",
    "input":  { "address":  "42 Harbour Road, Sydney NSW 2000" },
    "output":  {
      "video_url":  "https://storage.example.com/drone-footage.mp4",
      "thumbnail_url":  "https://storage.example.com/drone-thumb.jpg",
      "duration":  12.5
    },
    "created_at":  "2026-02-09T10:00:00.000Z",
    "updated_at":  "2026-02-09T10:02:30.000Z",
    "completed_at":  "2026-02-09T10:02:30.000Z"
  },
  "meta":  {
    "request_id":  "req_abc123",
    "timestamp":  "2026-02-09T10:02:30.000Z",
    "mode":  "live"
  }
}

Tip: Instead of polling, you can use webhooks to receive a notification when the job completes.

Options

Parameter	Type	Required	Description
`address`	string	Yes	Full property address
`options.direction`	string	No	Camera direction: original, north, south, east, west, topdown_zoomout, topdown_zoomin
`options.duration`	integer (3-15)	No	Video duration in seconds. Default: 5

See the API Reference for full parameter details and response schemas.

Output

When the job completes, the output object contains:

Field	Type	Description
`video_url`	string	URL of the generated drone footage video (MP4)
`thumbnail_url`	string	URL of a thumbnail image from the video
`duration`	number	Video duration in seconds

Next Steps

API Reference — Drone Footage — Full parameter details and schemas
Property Frontage Detection — Detect the front-facing direction to choose the best camera angle
Jobs & Webhooks — Polling best practices and real-time notifications