Video

Generate a voiceover script from photos

Writes a short, natural voiceover script from listing photos and optional property facts, using vision so the script reflects what's in the images. Returns the script text — pass it to /api/generate_voice. Free.

post/api/generate_voice_script

Request

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

imagesstring[]

Photos to base the script on: URL strings or { imageUrl } objects.

languagestring

Script language. See /api/music_library for accepted values.

Example request

{
  "propertyCharacteristics": [
    {
      "label": "Price",
      "value": "€450,000"
    }
  ]
}

Response

Script generated.

messagestring
scriptstring

The generated voiceover script.

Example response

{
  "message": "Script generated successfully"
}

Changes

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