Virtual Staging
Virtually stage empty rooms with realistic furniture and decor
POST
/v1/virtual-staging/generate202Virtually stage an empty room photo with realistic furniture and decor. Supports different room types and furniture styles.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
image_url | string (URI) | Yes | URL of the empty room photo to stage |
room_type | string | Yes | Type of room (e.g. living room, bedroom, kitchen) |
options.style_prompt | string | No | Optional furniture style description (e.g. modern minimalist, Scandinavian) |
webhook_url | string (URI) | No | URL to receive progress and completion webhooks |
callback_metadata | object | No | Opaque data returned in webhook payloads |
Request Example
{
"image_url": "https://example.com/image.jpg",
"room_type": "example",
"options": {
"style_prompt": "string"
},
"webhook_url": "https://example.com/image.jpg"
}Response
{
"data": {
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued"
},
"meta": {
"request_id": "req_abc123",
"timestamp": "2026-03-12T10:00:00.000Z",
"mode": "live"
}
}