Image Enhance

Enhance property photos with professional studio-quality lighting and color grading using AI. Improve lighting, contrast, and color while preserving the original composition.

Overview

The image enhance endpoint takes a property photo URL and produces a professionally enhanced version with improved studio lighting, white balance correction, contrast optimization, and shadow detail recovery. The AI preserves the exact composition, perspective, furniture, and architectural elements — no objects are added or removed.

Two output versions are generated: a 4K final image for export and a 2K display version optimized for web use.

Quick Example

Submit an image URL to enhance a property photo:

curl -X POST \
  -H "X-API-Key: dome_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photos/living-room.jpg"
  }' \
  https://api.dometech.com.au/v1/image-enhance/generate

Response (202):

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

Step-by-Step

1. Prepare Your Image

Ensure your source photo is hosted at a publicly accessible HTTPS URL. The API needs to download the image to process it, so the URL must be reachable from the internet.

2. Submit the Enhancement Request

Send a POST request to /v1/image-enhance/generate with the image URL. You can optionally provide a custom prompt to guide the enhancement style.

curl -X POST \
  -H "X-API-Key: dome_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photos/living-room.jpg",
    "options": {
      "prompt": "Warm golden hour lighting with enhanced shadow detail"
    }
  }' \
  https://api.dometech.com.au/v1/image-enhance/generate

The API returns a 202 Accepted response with a job_id. The enhancement is processed asynchronously.

Tip: If no custom prompt is provided, the default enhancement focuses on professional studio lighting, white balance correction, and contrast optimization.

3. Poll for Completion

Poll the job status endpoint until the status changes to completed. Image enhancement typically takes 10 to 30 seconds.

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

4. Retrieve the Enhanced Images

When the job completes, the output field contains URLs for both the full-resolution and display versions.

{
  "data":  {
    "id":  "550e8400-e29b-41d4-a716-446655440000",
    "job_type":  "image_enhance",
    "status":  "completed",
    "mode":  "live",
    "input":  {
      "image_url":  "https://example.com/photos/living-room.jpg"
    },
    "output":  {
      "image_url":  "https://storage.example.com/enhanced.jpg",
      "generation_time_seconds":  12.5
    },
    "created_at":  "2026-02-21T10:00:00.000Z",
    "updated_at":  "2026-02-21T10:00:12.000Z",
    "completed_at":  "2026-02-21T10:00:12.000Z"
  },
  "meta":  {
    "request_id":  "req_abc123",
    "timestamp":  "2026-02-21T10:00:12.000Z",
    "mode":  "live"
  }
}

Options

ParameterTypeRequiredDescription
image_urlstring (URI)YesPublic URL of the property photo to enhance
options.promptstringNoAdditional enhancement instructions. Default: professional studio lighting
webhook_urlstring (URI)NoURL to receive progress and completion webhooks
callback_metadataobjectNoOpaque data returned in webhook payloads

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

Output

When the job completes, the output object contains:

FieldTypeDescription
image_urlstringURL of the enhanced image at 4K resolution (JPEG, ~90% quality)
generation_time_secondsnumberTime taken to generate the enhanced image in seconds

Next Steps