Riferimento API

API Pedra

Accesso programmatico a home staging virtuale, miglioramento immagini e generazione video immobiliari. JSON su HTTPS. Per portali, CRM e piattaforme immobiliari.

URL base

Tutte le richieste API sono inviate a:

https://app.pedra.ai/api

Avvio rapido

Ogni endpoint accetta un POST JSON con la tua apiKey e un imageUrl. Ecco una chiamata di home staging virtuale che arreda una stanza vuota:

curl -X POST https://app.pedra.ai/api/furnish \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/empty-room.jpg",
    "roomType": "Living room",
    "style": "Minimalist"
  }'

Le risposte riuscite restituiscono HTTP 200 con { "message": "...", "output": ... }. output è un array per /api/enhance, /api/enhance_and_correct_perspective, /api/empty_room, /api/furnish e /api/renovation, e un singolo oggetto per /api/sky_blue, /api/edit_via_prompt, /api/remove_object e /api/blur. Vedi Errori e limiti per i formati di errore.

Endpoint

Vedi ogni endpoint in azione
Sfoglia gallerie prima/dopo di staging, rinnovazione, miglioramento, sostituzione del cielo e video.
Vedi esempi →

Home staging virtuale →

POST/api/furnishAggiungi mobili a una stanza vuota
POST/api/empty_roomRimuove tutti i mobili da una stanza
POST/api/renovationRinnova una stanza in uno stile nuovo
POST/api/edit_via_promptModifica un'immagine con un prompt
POST/api/remove_objectRimuove oggetti specifici tramite maschera

Miglioramento immagini →

POST/api/enhanceMiglioramento automatico di luce, colore, nitidezza
POST/api/enhance_and_correct_perspectiveMigliora + raddrizza linee verticali
POST/api/sky_blueSostituisce un cielo grigio con uno blu
POST/api/blurSfoca oggetti (volti, targhe, loghi)

Video →

POST/api/create_videoGenera un video di annuncio da foto

Autenticazione

Tutte le richieste richiedono un apiKey nel corpo JSON. Ottieni una chiave registrandoti su app.pedra.ai e aprendo Impostazioni → API. Vedi Autenticazione per i dettagli.

Formato di richiesta e risposta

Ogni endpoint accetta JSON su HTTPS tramite POST. Le immagini possono essere passate come URL pubblicamente accessibile o come data URI base64 (data:image/png;base64,...). Pedra va in timeout dopo 20s scaricando imageUrl — per URL con autenticazione o prefirmate (S3, R2, Cloudinary), preferisci il formato base64.

Tutti gli endpoint sono sincroni. Gli endpoint di immagini rispondono in ~10–30 secondi; l'endpoint video si blocca fino a 10 minuti — imposta il timeout del client HTTP di conseguenza.

Prezzi

L'uso dell'API è fatturato per richiesta, con sconti sui volumi. Vedi Prezzi.

Supporto

Scrivi a felix@pedra.ai per aumentare le quote, ricevere aiuto con l'integrazione o per condizioni enterprise. Rispondiamo entro un giorno lavorativo.