API Documentation

Upload a room photo, describe the desired style or provide furniture references, and receive a photorealistic result. Each call costs 10 credits (auto-refunded on failure).

API access requires an Enterprise subscription (Growth plan or higher). After you are subscribed, you can generate your API key in account settings.

Input room

Reference furniture

Modular Sofa

Upholstered Bed

Dining Table

Oak Chair

↓

API result

Take the result and restyle it with a single prompt:

"Design this room as Italian contemporary"

"Design this room as Japanese"

Tutorial

Before you start

You need an Enterprise subscription (Growth plan or higher) to use the API. Once subscribed, go to your account settings and click API Key under Profile:

Then click Generate API Key. The key is shown only once, copy it immediately.

• Auth: Send Authorization: Bearer mf_sk_... in every request header.
• Content-Type: application/json
• Credits: Each generation costs 10 credits, deducted before processing. Failed generations are refunded automatically.
• Timeout: Requests have a 2-minute timeout. Large images may take 30–90 seconds to process.

Basic usage: Restyle a room

The simplest call takes a room image and a text prompt. The API returns a base64-encoded PNG of the transformed room.

export MELTFLEX_API_KEY="mf_sk_..."

curl -X POST "https://www.meltflexai.com/api/v1/generate" \
  -H "Authorization: Bearer $MELTFLEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "https://your-cdn.com/empty-room.jpg",
    "prompt": "Transform this empty room during sunset with warm golden light"
  }'

The response contains a data:image/png;base64,... string. Decode it and save to a file, display in your UI, or upload to your CDN.

Furniture placement

To place specific furniture in a room, send reference images alongside the main room photo. The AI will match each item's appearance (colors, materials, textures) and position them naturally.

• referenceImageUrls array of public URLs pointing to furniture/decor photos (up to 10)
• referenceProducts optional metadata for each image: name for accurate placement

import requests

API_KEY = "mf_sk_..."
URL = "https://www.meltflexai.com/api/v1/generate"

response = requests.post(URL, json={
    "imageUrl": "https://your-cdn.com/empty-room.jpg",
    "prompt": "Place these furniture items naturally in this room during sunset",
    "referenceImageUrls": [
        "https://your-cdn.com/modular-sofa.jpg",
        "https://your-cdn.com/upholstered-bed.jpg",
        "https://your-cdn.com/dining-table.jpg",
        "https://your-cdn.com/oak-chair.jpg"
    ]
}, headers={
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
})

data = response.json()
if data.get("success"):
    print(f"Room furnished with 4 items during sunset")

Production tips

• Use image URLs over base64 when possible. It avoids hitting the 15 MB body limit and is faster.
• Retry on 429: Implement exponential backoff (e.g. 1s, 2s, 4s, up to 30s).
• Timeouts: Set a client-side timeout of ~2 minutes. If the request times out, credits are refunded server-side.
• Image quality: Input images of at least 1024px on the longest side produce the best results.
• Prompt specificity: Be specific. "Scandinavian style with warm oak flooring and linen curtains" works better than "make it nice".
• Security: Never expose your API key in client-side code. Make API calls from your backend.

API Reference

Generate Image

Transform a room photo into a photorealistic interior design image. Optionally attach reference images of furniture to place in the room.

Request Headers

Request Body

Response Body

A successful request returns HTTP 200 with a JSON body:

{
  "success": true,
  "image": "data:image/png;base64,iVBORw0KGgo...",
  "creditsUsed": 10
}

Resources

Limits

Error codes

Error responses include a JSON body with an error field:

{
  "error": "Insufficient credits",
  "message": "You need 10 credits. Check your balance at meltflexai.com/settings",
  "required": 10
}