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.

SDK & MCP

Preferisci un client tipizzato all'HTTP grezzo? Gli SDK ufficiali Python e Node.js avvolgono ogni endpoint — pip install pedra o npm i @pedra-ai/sdk. Oppure usa Pedra direttamente da Claude, ChatGPT e Cursor tramite il server MCP. Ti serve un contratto leggibile dalle macchine? Scarica la specifica OpenAPI 3.1.

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

Account →

POST/api/creditsControlla il saldo crediti rimanente
POST/api/feedbackValuta un'immagine e richiedi il rimborso dei crediti

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.

Domande frequenti

Pedra ha un'API?

Sì. Pedra offre un'API REST su JSON-over-HTTPS per home staging virtuale, miglioramento delle immagini, rimozione di oggetti e generazione di video per annunci. È pensata per piattaforme immobiliari, CRM e portali. Ottieni una chiave API su app.pedra.ai in Impostazioni → API.

Cosa può fare l'API di Pedra?

Espone tutte le trasformazioni di Pedra in modo programmatico: arredare stanze vuote, svuotare stanze arredate, rinnovare spazi, modificare foto con un'istruzione testuale, rimuovere oggetti, migliorare luce e colore, correggere la prospettiva, sostituire il cielo, sfocare contenuti sensibili e generare video per annunci.

Esiste un'API di home staging virtuale?

Sì. POST /api/furnish aggiunge mobili alle stanze vuote, /api/empty_room li rimuove, /api/renovation cambia lo stile di uno spazio e /api/edit_via_prompt modifica una foto a partire da un'istruzione in linguaggio naturale — tutto in un'unica API JSON.

Come integro Pedra?

Crea una chiave API, poi installa un SDK ufficiale (pip install pedra o npm install @pedra-ai/sdk) oppure chiama direttamente gli endpoint REST. Passa la tua chiave e l'URL di un'immagine a un endpoint; ogni chiamata attende finché il risultato è pronto e restituisce l'URL finale, senza ID di lavoro da interrogare.

Quanto costa l'API di Pedra?

Il prezzo è per generazione riuscita con sconti sul volume, e paghi solo per i risultati riusciti. È disponibile una prova gratuita. Consulta la pagina dei prezzi dell'API per i dettagli.

Come funziona l'autenticazione dell'API di Pedra?

Passi la tua chiave API nel corpo della richiesta, nel campo apiKey. Le chiavi sono a lunga durata, quindi chiama l'API dal tuo backend e non inserire mai una chiave nel codice lato client.