Video

Edit an existing video without re-rendering unchanged clips

Edits a video (by videoId) created with create_video. Clips whose source photo + effect (+ second photo for transitions) are unchanged reuse their already-rendered clip — no re-animation, no credits. Only new or changed AI frames re-animate at 5 credits each. Omit images to change only audio/text/branding (a free re-stitch). Omitted music/voice/branding/ending fields keep their stored values. Synchronous — blocks until the new video is rendered. If the video was created with a propertyId, that link is inherited automatically — no need to pass it again.

post/api/update_video

Request

  • Base URL: https://app.pedra.ai
  • URL: https://app.pedra.ai/api/update_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.

videoIdstring required

Id of the video to edit (the videoId returned by create_video).

isVerticalboolean

Render 9:16 vertical instead of horizontal (only applied when images is sent).

endingTitlestring

Headline shown on the final card.

endingSubtitlestring

Subtitle shown on the final card.

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 re-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.