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

🟢200成功

application/json

Bodyapplication/json

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
    }
  ],
  // "product_url": "https://demo01.houzez.co/property/modern-apartment-on-the-bay/",
  "language_code": "en-US",
  "avatar_presence_level": "high",
  "avatar": "Auto",
  "lip_sync_switch": true,
  "lip_sync_tts_speaker_id": "api-user-tts-xxxxxxxx",
  // "duration": 15,
  // "video_style": "cozy",
  "aspect_ratio": "9:16",
  "quality": "720p",
  "bgm_switch": true,
  "caption_switch": true
}'

Response Example

{
    "ErrCode": 0,
    "ErrMsg": "Success",
    "Resp": {
        "video_id": 0,
        "credit": 0
    }

Viral Recreation Agent

Image template generation