Video

Generate a listing video from photos

Renders a listing video from an ordered list of frames, with per-frame effects, subtitles, music, voiceover, property characteristics, and branding. Costs 5 credits per AI frame (0 for static and lite-zoom-in / lite-zoom-out frames). Synchronous — blocks until the video is rendered (~2–10 min), so set a generous client timeout.

post/api/create_video

Request

  • Base URL: https://app.pedra.ai
  • URL: https://app.pedra.ai/api/create_video
  • Auth: none required

Request body

apiKeystring required

Account API key, sent in the request body. Get one at https://app.pedra.ai under Settings → API.

isVerticalboolean

Render 9:16 vertical (Reels/TikTok) instead of horizontal.

endingTitlestring

Headline shown on the final card.

endingSubtitlestring

Subtitle shown on the final card, e.g. a CTA or contact details.

propertyIdstring

Optional id of the property (from /api/list_properties or /api/create_property) this photo/video belongs to. When set, the result is saved into that property's gallery (or, for create_video, its Videos tab) — visible and editable from the app — instead of only being returned as a URL.

Example request

{
  "images": [
    {
      "imageUrl": "https://example.com/photo.jpg",
      "secondImageUrl": "https://example.com/photo.jpg"
    }
  ],
  "propertyCharacteristics": [
    {
      "label": "Price",
      "value": "€450,000"
    }
  ],
  "branding": {
    "primaryColor": "#007BFF"
  }
}

Response

Video rendered.

messagestring
videoIdstring

Identifier of the rendered video.

videoUrlstring

URL of the rendered video.

Example response

{
  "message": "Video created successfully"
}

Changes

No recorded changes to this operation across all 1 revision of this API.