1. Solutions
PixVerse Platform Docs
  • Get Started
    • Billing and Usage
    • Quick Start
    • Contact Us
    • Privacy and Data Protection
    • Model Capability Map
    • What Is PixVerse AI?
  • API
    • Preparation
      • Start Here
      • Concurrency Rules
      • Query Task Status
      • Error Codes
      • Error Details
      • FAQ
      • Webhook Callbacks
      • Upload Image
      • Upload Media (Video and Audio)
      • Verify Uploaded Audio
      • Get Effect Template List
      • Get TTS Speaker List
      • Get Restyle Effect List
      • Query Task Status
      • Get Account Balance
      • Usage Deduction Query
      • Create Custom Voice
      • Delete Custom Voice
    • Core Capabilities
      • Text-to-Video
      • Image-to-Video and Video Templates
      • First and Last Frame Video
      • Reference-to-Video (Fusion)
      • Multi-Transition Video
      • Video Extend
      • Video Expand
      • Image Template Generation
      • Get Image Generation Result
    • Solutions
      • Video Upscale
        POST
      • Video Restyle
        POST
      • Lipsync
        POST
      • Image Avatar
        POST
      • Select Video Mask
        POST
      • Sound Effect
        POST
      • Subject Replacement (Swap)
        POST
      • Motion Control (Mimic)
        POST
      • One-click Real Estate Video
        POST
      • One-click VibeMV
        POST
  • Pricing
    • PixVerse API Pricing
  • Changelog
    • Changelog
  1. Solutions

One-click Real Estate Video

POST
/openapi/v2/video/agent/generate
A property marketing video Agent for real estate teams, property photographers, media companies, and property leasing/property management operators.
It offers two creation methods: enter a property listing URL to automatically download the images and generate the prompts, or manually upload property images and enter a property description prompt. Please confirm that you hold the legal rights to the page and its content at the URL you provide, and that using this URL does not infringe any third-party rights.
The Pro model currently supports two video styles: property tours and creative short-form videos. You can upload a model photo to create videos featuring a real person touring the property, and use an audio file to clone the voice.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Bodyapplication/json

Request Request Example
Shell
curl --location 'https://app-api.pixverse.ai/openapi/v2/video/agent/generate' \
--header 'Ai-Trace-Id: your-ai-trace-id' \
--header 'API-KEY: your-api-key' \
--header 'Content-Type: application/json' \
--data '{
  "agent_id": 419629433597950,
  "model": "pro",
  "mode": "property_tour",
  "prompt": "Property information such as price, location, and key selling points.",
  "img_references": [
    {
      "img_id": 883671823
    },
    {
      "img_id": 883671834
    },
    {
      "img_id": 883671837
    },
    {
      "img_id": 883671844
    },
    {
      "img_id": 883671873
    }
  ],
  "language_code": "en-US",
  "avatar_presence_level": "high",
  "avatar": "Auto",
  "lip_sync_switch": true,
  "lip_sync_tts_speaker_id": "api-user-tts-xxxxxxxx",
  "aspect_ratio": "9:16",
  "quality": "720p",
  "bgm_switch": true,
  "caption_switch": true
}'
Response Response Example
Successful Example
{
  "ErrCode": 0,
  "ErrMsg": "Success",
  "Resp": {
    "video_id": 1000000000000060,
    "credits": 160
  }
}
Previous
Motion Control (Mimic)
Next
One-click VibeMV