Real Estate Aerial Video Generator
Create cinematic aerial property videos from a street address and return a downloadable MP4 when the footage is ready.
Actions
generate_aerial_video
Request an aerial video for a location.
Required fields:
address(string): Full street address.
Optional fields:
- None.
Example:
{
"action": "generate_aerial_video",
"address": "230 Wellington St, Traverse City, MI 49686"
}
Typical statuses:
completed: Video is ready now. Return thesigned_urlto the user.queued: A new request was submitted. Save the returnedvideo_idfor later checks.processing: A prior request is still being prepared.unavailable: No aerial coverage is available for that location.
fetch_existing_aerial_video
Retrieve a completed video or check the status of an earlier request.
Required fields:
- At least one of
addressorvideo_id.
Optional fields:
address(string): Street address used for the request.video_id(string): Video identifier from a prior response.
Example using an address:
{
"action": "fetch_existing_aerial_video",
"address": "230 Wellington St, Traverse City, MI 49686"
}
Example using a video ID:
{
"action": "fetch_existing_aerial_video",
"video_id": "ZsqpL5f2WAQxXrtbqWq8AP"
}
Typical statuses:
completed: Response includessigned_url,file_id,size_bytes, and metadata such asvideoId,captureDate, andduration.processing: Video is still being prepared.not_found: No prior video exists for that address or ID.failed: The prior request did not complete successfully.
Recommended Flow
- Call
generate_aerial_videowhen the user asks for a new video. - If the response is
completed, present thesigned_urldirectly. - If the response is
queued, keep the returnedvideo_id. - Use
fetch_existing_aerial_videolater with thevideo_idor original address.
Example Chat Conversation
User: "Can you make an aerial video for 230 Wellington St, Traverse City, MI 49686?"
Assistant: "I’ll check whether one is already available for that address and return the download link if it is ready."
Assistant tool call:
{
"action": "fetch_existing_aerial_video",
"address": "230 Wellington St, Traverse City, MI 49686"
}
Assistant if completed: "The aerial video is ready. Here is the download link: <signed_url>"
Assistant if processing: "The video is not ready yet. I can check again later using the saved video ID."
Notes
- Completed download links expire after 7 days.
- New requests can take 24 to 48 hours before they are ready.
- Some addresses do not have aerial coverage.






