Video Clips

Generate short AI-powered video clips from property images. Bring still photos to life with cinematic motion effects.

Overview

The video clips endpoint takes a property image URL and generates a short video clip using AI video generation. You can provide an optional text prompt to guide the motion style, control the creativity level, and choose whether the source image appears as the first or last frame of the video. Clips can be 3 to 15 seconds in duration.

Quick Example

Submit an image URL to generate a video clip:

curl -X POST \
  -H "X-API-Key: dome_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/property-photo.jpg",
    "options": {
      "prompt": "Smooth cinematic pan across the property",
      "creativity_level": "medium",
      "duration": 5
    }
  }' \
  https://api.dometech.com.au/v1/video-clips/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. Prepare Your Image

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

2. Submit the Generation Request

Send a POST request to /v1/video-clips/generate with the image URL and optional parameters. You can include a text prompt to describe the desired camera motion.

curl -X POST \
  -H "X-API-Key: dome_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/living-room.jpg",
    "options": {
      "prompt": "Gentle zoom into the fireplace with warm lighting",
      "creativity_level": "high",
      "frame_mode": "first",
      "duration": 10
    }
  }' \
  https://api.dometech.com.au/v1/video-clips/generate

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

3. Poll for Completion

Poll the job status endpoint until the status changes to completed. Video generation typically takes 30 seconds to 2 minutes depending on the duration setting.

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 Video

When the job completes, the output field contains the video URL.

{
  "data":  {
    "id":  "550e8400-e29b-41d4-a716-446655440000",
    "job_type":  "video_clip",
    "status":  "completed",
    "mode":  "live",
    "input":  {
      "image_url":  "https://example.com/living-room.jpg"
    },
    "output":  {
      "video_url":  "https://storage.example.com/video-clip.mp4"
    },
    "created_at":  "2026-02-09T10:00:00.000Z",
    "updated_at":  "2026-02-09T10:01:45.000Z",
    "completed_at":  "2026-02-09T10:01:45.000Z"
  },
  "meta":  {
    "request_id":  "req_abc123",
    "timestamp":  "2026-02-09T10:01:45.000Z",
    "mode":  "live"
  }
}

Tip: Use frame_mode: "last" when you want the video to end on a specific shot — for example, settling on a hero image of the property.

Options

ParameterTypeRequiredDescription
image_urlstring (URI)YesURL of the source image
options.promptstringNoCustom prompt to guide the video generation
options.creativity_levelstringNoCreativity level: "low", "medium", "high". Default: "medium"
options.frame_modestringNoWhether the image is the first or last frame: "first", "last". Default: "first"
options.durationinteger (3-15)NoVideo duration in seconds. Default: 5
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
video_urlstringURL of the generated video clip (MP4)

Next Steps