curl -X POST https://api.vibepeak.ai/v1/real-estate/living-property \
  -H "Authorization: Bearer vpk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      { "url": "https://example.com/property/living-room.jpg", "room_type": "living_room" },
      { "url": "https://example.com/property/kitchen.jpg", "room_type": "kitchen" },
      { "url": "https://example.com/property/bedroom.jpg", "room_type": "bedroom" },
      { "url": "https://example.com/property/bathroom.jpg", "room_type": "bathroom" },
      { "url": "https://example.com/property/exterior.jpg", "room_type": "exterior" }
    ],
    "voice": {
      "voice_id": "EXAVITQu4vr4xnSDxMaL",
      "language": "en"
    },
    "modification_mode": "no_modify",
    "script": "Welcome to this stunning modern home where comfort meets contemporary design. The spacious living room is filled with natural light and elegant finishes. The kitchen offers sleek cabinetry and generous counter space. Each bedroom feels calm and inviting, while the bright bathroom adds a touch of luxury. Step outside to enjoy a beautiful private garden.",
    "webhook_url": "https://yourserver.com/webhooks/vibepeak",
    "subtitle": {
      "subtitle_style_preset": "classic"
    },
    "elements_config": {
      "enabled": true,
      "watermark": {
        "url": "https://example.com/logo.png",
        "position": "bottom-right",
        "size": 20,
        "opacity": 100
      },
      "text": {
        "content": "Powered by Vibepeak",
        "color": "#FFFFFF",
        "font": "Inter",
        "size": 20,
        "position": "center"
      }
    }
  }'

const response = await fetch('https://api.vibepeak.ai/v1/real-estate/living-property', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer vpk_live_xxxxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    images: [
      { url: 'https://example.com/property/living-room.jpg', room_type: 'living_room' },
      { url: 'https://example.com/property/kitchen.jpg', room_type: 'kitchen' },
      { url: 'https://example.com/property/bedroom.jpg', room_type: 'bedroom' },
      { url: 'https://example.com/property/bathroom.jpg', room_type: 'bathroom' },
      { url: 'https://example.com/property/exterior.jpg', room_type: 'exterior' }
    ],
    voice: {
      voice_id: 'EXAVITQu4vr4xnSDxMaL',
      language: 'en'
    },
    modification_mode: 'no_modify',
    script: 'Welcome to this stunning modern home where comfort meets contemporary design. The spacious living room is filled with natural light and elegant finishes. The kitchen offers sleek cabinetry and generous counter space. Each bedroom feels calm and inviting, while the bright bathroom adds a touch of luxury. Step outside to enjoy a beautiful private garden.',
    webhook_url: 'https://yourserver.com/webhooks/vibepeak',
    subtitle: {
      subtitle_style_preset: 'classic'
    },
    elements_config: {
      enabled: true,
      watermark: {
        url: 'https://example.com/logo.png',
        position: 'bottom-right',
        size: 20,
        opacity: 100
      },
      text: {
        content: 'Powered by Vibepeak',
        color: '#FFFFFF',
        font: 'Inter',
        size: 20,
        position: 'center'
      }
    }
  })
});

const task = await response.json();
console.log(`Task created: ${task.task_id}`);
console.log(`Poll at: ${response.headers.get('Location')}`);

import requests

response = requests.post(
    'https://api.vibepeak.ai/v1/real-estate/living-property',
    headers={
        'Authorization': 'Bearer vpk_live_xxxxx',
        'Content-Type': 'application/json'
    },
    json={
        'images': [
            {'url': 'https://example.com/property/living-room.jpg', 'room_type': 'living_room'},
            {'url': 'https://example.com/property/kitchen.jpg', 'room_type': 'kitchen'},
            {'url': 'https://example.com/property/bedroom.jpg', 'room_type': 'bedroom'},
            {'url': 'https://example.com/property/bathroom.jpg', 'room_type': 'bathroom'},
            {'url': 'https://example.com/property/exterior.jpg', 'room_type': 'exterior'}
        ],
        'voice': {
            'voice_id': 'EXAVITQu4vr4xnSDxMaL',
            'language': 'en'
        },
        # change_decoration + include_humans_and_pets (default true) → two-step scenes,
        # so the script uses the wider 110-140 chars/scene budget (550-700 for 5 images).
        'modification_mode': 'change_decoration',
        'include_humans_and_pets': True,
        'script': 'Welcome to this beautifully renovated apartment where modern comfort meets timeless elegance throughout every room. The bright living room invites you to relax, with large windows that fill the space with warm natural light. The kitchen features sleek cabinetry, premium finishes, and generous counter space for cooking and gathering. Each bedroom offers a calm and restful retreat, while the elegant bathroom adds a genuine touch of luxury. Step outside to discover a private garden, perfect for morning coffee or relaxing evenings under the open sky. The home has been finished to a high standard and is ready for you to move in and enjoy from the very first day.',
        'background_music': True,
        'subtitle': {
            'subtitle_style_preset': 'classic'
        },
        'elements_config': {
            'enabled': True,
            'watermark': {
                'url': 'https://example.com/logo.png',
                'position': 'bottom-right',
                'size': 20,
                'opacity': 100
            },
            'text': {
                'content': 'Powered by Vibepeak',
                'color': '#FFFFFF',
                'font': 'Inter',
                'size': 20,
                'position': 'center'
            }
        }
    }
)

task = response.json()
print(f"Task created: {task['task_id']}")
print(f"Credits charged: {task['credits_charged']}")

{
  "task_id": "task_abc123xyz",
  "status": "queued",
  "message": "Real estate video generation request accepted",
  "created_at": "2026-01-19T12:00:00Z",
  "credits_charged": 15,
  "livemode": true,
  "request_id": "req_xyz123",
  "_links": {
    "self": "/v1/tasks/task_abc123xyz",
    "poll_interval_seconds": 30
  }
}

{
  "task_id": "task_abc123xyz",
  "status": "queued",
  "message": "Real estate video generation request accepted",
  "created_at": "2026-01-19T12:00:00Z",
  "credits_charged": 0,
  "livemode": false,
  "request_id": "req_xyz123",
  "_links": {
    "self": "/v1/tasks/task_abc123xyz",
    "poll_interval_seconds": 30
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "script is required",
    "request_id": "req_xyz123",
    "details": {
      "field": "script",
      "issues": [
        {
          "path": "script",
          "message": "Required"
        }
      ]
    }
  }
}

{
  "error": {
    "code": "SCRIPT_INVALID_CHARACTERS",
    "message": "Script contains characters not supported by text-to-speech: \"🏠\". Emojis and other non-speech symbols are not allowed.",
    "request_id": "req_xyz123",
    "details": {
      "invalid_characters": ["3", "$"]
    }
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Provide either 'subtitle_style_preset' or 'styles', but not both.",
    "request_id": "req_xyz123"
  }
}

{
  "error": {
    "code": "SCRIPT_TOO_SHORT",
    "message": "Script is too short for 5 image(s). Minimum 325 characters required (65 per scene), but got 200. Either lengthen the script or send fewer images.",
    "request_id": "req_xyz123",
    "details": {
      "script_length": 200,
      "min_length": 325,
      "max_length": 425,
      "image_count": 5,
      "chars_per_scene_min": 65,
      "chars_per_scene_max": 85
    }
  }
}

{
  "error": {
    "code": "SCRIPT_TOO_LONG",
    "message": "Script is too long for 5 image(s). Maximum 700 characters allowed (140 per scene), but got 800. Either shorten the script or send more images.",
    "request_id": "req_xyz123",
    "details": {
      "script_length": 800,
      "min_length": 550,
      "max_length": 700,
      "image_count": 5,
      "chars_per_scene_min": 110,
      "chars_per_scene_max": 140
    }
  }
}

{
  "error": {
    "code": "IMAGE_RESOLUTION_TOO_LOW",
    "message": "1 image(s) below the minimum resolution. Required: long side ≥ 1280px and short side ≥ 720px.",
    "request_id": "req_xyz123",
    "details": {
      "invalid_images": ["https://example.com/thumbnail.jpg"]
    }
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "If elements_config is enabled, you must provide at least a 'watermark' or 'text' configuration.",
    "request_id": "req_xyz123",
    "details": {
      "path": ["elements_config", "enabled"]
    }
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid hex color",
    "request_id": "req_xyz123",
    "details": {
      "path": ["elements_config", "text", "color"]
    }
  }
}

{
  "error": {
    "code": "VOICE_NOT_FOUND",
    "message": "Voice ID not found",
    "request_id": "req_xyz123"
  }
}

{
  "error": {
    "code": "VOICE_ACCESS_DENIED",
    "message": "Voice not accessible",
    "request_id": "req_xyz123"
  }
}

{
  "error": {
    "code": "CONCURRENCY_LIMIT_EXCEEDED",
    "message": "You have reached your concurrent task limit of 1. Please wait for existing tasks to complete.",
    "request_id": "req_xyz123",
    "details": {
      "limit": 1,
      "in_flight": 1,
      "plan": "Plus"
    }
  }
}

{
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "Video generation service is temporarily unavailable. Please try again later.",
    "request_id": "req_xyz123"
  }
}