Pedra

Build a hosted 360° virtual tour: the rooms are named and linked with navigation points by AI, and you get a shareable link and embed code. Pass the 360° photos as scenes (URLs, or imageIds of 360° photos already in the property) in the order someone would walk through the home, or just a propertyId to use all its 360° photos. Linking: "sequential" (default) lets AI work out which rooms connect, using the walk order as a hint, links every spot shot in the same room, and puts each navigation point on the floor where the next photo was taken; it costs 1 credit per 2 rooms, at least 3. "smart" is the same, kept for compatibility. "none" is free. Returns a tourId immediately — the build takes about 6 seconds per room, so poll pedra_get_virtual_tour until status is "ready". One tour per property.

pedra_create_virtual_tour

Edit an image from a natural-language instruction (e.g. "paint the walls sage green"). Returns the edited image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.

pedra_edit_via_prompt

Edit an existing video (by videoId) without re-rendering unchanged clips: only new or changed photos re-animate and cost credits. Omit `images` to change only audio, text, or branding. Returns immediately while the video re-renders; check it with pedra_get_video.

pedra_update_video

Change a finished virtual tour in place: rename it or its rooms, reorder rooms (the first one is where the tour opens), remove rooms, replace its navigation links, or change how the navigation points look. Free and instant. The tour's public link shows the change right away. Get sceneIds from pedra_get_virtual_tour.

pedra_update_virtual_tour

Remove all furniture and objects from a room, leaving an empty space. Returns the emptied image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.

pedra_empty_room

Enhance a real-estate photo: improve lighting, color, and sharpness. Returns the enhanced image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.

pedra_enhance

Enhance a photo and correct vertical/horizontal perspective (straighten walls and lines). Returns the corrected image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.

pedra_enhance_and_correct_perspective

Render a voiceover from a script via text-to-speech. Returns an audioId — pass it to pedra_create_video / pedra_update_video as voice.audioId to attach the narration (with synced subtitles).

pedra_generate_voice

List the social networks connected to the user's Pedra account (Instagram, Facebook Page, TikTok, YouTube) and whether each still works. Call this before pedra_social_post. Networks are connected in the Pedra app under Settings › Socials, not through this API. Pedra Pro only.

pedra_social_accounts

List the background-music catalog: valid `music.track` values (genre keys) and the voice languages. Read-only.

pedra_music_library

List the user's Pedra properties (id, name, photo count, and an appUrl to open each in Pedra). Use this to find photos that already live in the account — e.g. to build a video from a listing's photos.

pedra_list_properties

List the photos in a Pedra property as img.pedra.ai URLs, ready to pass straight to pedra_create_video or the image-editing tools. Get the propertyId from pedra_list_properties. Pass type "360" to list its 360° photos instead (their imageIds are the scenes of a virtual tour).

pedra_list_property_images

List posts made or scheduled through the social API, newest scheduled time first, with status pending, processing, posted, failed or cancelled, and the error when one failed. Use it to check a post went out or to see which days already have one. Pedra Pro only.

pedra_social_list_posts

List the account's virtual tours (newest first) with status, share link and room count. Optionally only one property's. Read-only.

pedra_list_virtual_tours

Post a video to the user's connected socials now, or schedule it. Pass a public https videoUrl (Pedra copies it to its own storage) and one entry per network with its caption; each network can appear once. Without scheduledAt it posts within a minute. Returns one postId per network; check them with pedra_social_list_posts. Pedra Pro only, up to 25 posts per network per day. Confirm the captions and time with the user before calling: this publishes publicly.

pedra_social_post

Submit thumbs up/down feedback on a generated image, with an optional credit-back on a thumbs-down (subject to the API's eligibility rules).

pedra_feedback

Remove an object from an image using a mask. Returns the cleaned image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.

pedra_remove_object

Renovate a space (walls, floors, finishes), optionally furnished. Returns the renovated image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.

pedra_renovation

Replace a dull or overcast sky with a clear blue one. Returns the image URL with the new sky. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.

pedra_sky_blue

Virtually stage (furnish) a room with AI-generated furniture. Returns the staged image URL. Pass `propertyId` to save the result into that property's gallery instead of only returning a URL.

pedra_furnish

Write a short voiceover script from property photos (and optional facts). Uses vision so the script reflects what's shown. Returns the script text — pass it to pedra_generate_voice.

pedra_generate_voice_script