Video Clips

Generate video clips from property images

POST/v1/video-clips/generate202

Generate a short video clip by animating a property photo. Uses AI to create cinematic camera movement from a still image.

Request Body

ParameterTypeRequiredDescription
image_urlstring (URI)YesURL of the property image to animate
options.promptstringNoMotion prompt describing desired camera movement
options.durationinteger (3-15)NoVideo duration in seconds (3-15)
webhook_urlstring (URI)NoURL to receive progress and completion webhooks
callback_metadataobjectNoOpaque data returned in webhook payloads

Request Example

{
  "image_url":  "https://example.com/image.jpg",
  "options":  {
    "prompt":  "string",
    "duration":  3
  },
  "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"
  }
}