Drone Stills

Generate enhanced 4K aerial drone still images for any Australian property address. Returns a finished, high-resolution aerial photograph.

Overview

The drone stills endpoint generates a single enhanced 4K aerial image from a property address. Unlike drone footage which produces a video, drone stills produce a high-quality still photograph ideal for listings, brochures, and marketing materials.

You can optionally specify a camera direction, front-facing direction, and precise coordinates to control the capture angle.

Quick Example

Submit a property address to generate an enhanced aerial still:

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"
    }
  }' \
  https://api.dometech.com.au/v1/drone-stills/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 /v1/drone-stills/generate with the property address. Optionally include a camera direction.

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 Image

When the job completes, the output field contains the enhanced image URL and metadata.

{
  "data":  {
    "id":  "550e8400-e29b-41d4-a716-446655440000",
    "job_type":  "drone_stills",
    "status":  "completed",
    "mode":  "live",
    "input":  { "address":  "123 Collins Street, Melbourne VIC 3000" },
    "output":  {
      "image_url":  "https://storage.example.com/drone-still-4k.jpg",
      "generation_time_seconds":  25.3
    },
    "created_at":  "2026-02-09T10:00:00.000Z",
    "updated_at":  "2026-02-09T10:00:25.300Z",
    "completed_at":  "2026-02-09T10:00:25.300Z"
  },
  "meta":  {
    "request_id":  "req_abc123",
    "timestamp":  "2026-02-09T10:00:25.300Z",
    "mode":  "live"
  }
}

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

Output

When the job completes, the output object contains:

FieldTypeDescription
image_urlstringURL of the enhanced 4K aerial still image (JPEG)
generation_time_secondsnumberTime taken to generate the image in seconds

Next Steps