Riferimento

Valutazione immagini e rimborso crediti

Invia valutazioni (pollice su/giù) sulle immagini generate e richiedi il rimborso dei crediti sulle generazioni non riuscite — lo stesso flusso dell'editor di Pedra.

Invia una valutazione (pollice su/giù) su un'immagine generata — lo stesso voto che puoi esprimere nell'editor di Pedra. Con un pollice giù puoi anche richiedere il rimborso dei crediti: Pedra esegue un controllo qualità automatico e, se la generazione è fallita, rimborsa i crediti consumati.

Endpoint

POSThttps://app.pedra.ai/api/feedback

Identifica l'immagine con l'imageUrl restituita al momento della generazione, oppure passa direttamente il suo imageId. Votare è gratis — non costa mai crediti.

curl -X POST https://app.pedra.ai/api/feedback \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://img.pedra.ai/IMAGE_ID",
    "vote": "down",
    "comment": "The furniture is still visible",
    "creditBack": true
  }'

Campi della richiesta

  • apiKey — la tua chiave API. Obbligatorio.
  • imageUrl o imageId — l'immagine da valutare. Usa l'URL restituito dall'endpoint di generazione, o l'id da solo. Uno è obbligatorio.
  • vote — "up" o "down". Invia una stringa vuota per annullare un voto precedente.
  • comment — nota di testo libero opzionale che spiega il voto. Aiuta il controllo del rimborso e il nostro monitoraggio qualità.
  • creditBack — imposta true su un voto down per richiedere il rimborso dei crediti consumati da questa immagine. Ignorato su un voto positivo.

Idoneità al rimborso

Quando viene richiesto creditBack, Pedra esegue un controllo qualità automatico sul risultato. I crediti vengono rimborsati solo quando valgono tutte le seguenti condizioni:

  • La generazione è di un tipo idoneo: svuotare stanza, rimuovere oggetto, modifica con prompt, rinnovazione o arredare/home staging.
  • La richiesta viene effettuata entro 2 ore dalla generazione dell'immagine.
  • Non è una rinnovazione ad alta creatività (sono progettate per alterare drasticamente la stanza, quindi non sono idonee).

Risposta

Restituisce 200. Un voto semplice riflette il voto registrato; una richiesta di rimborso restituisce anche un oggetto creditBack con l'esito:

JSON
{
  "ok": true,
  "vote": "positive"
}

Campi della risposta

  • vote — il voto registrato (positive, negative o null se annullato).
  • creditBack.status — approved, rejected o ineligible. creditBack.creditsRefunded è il numero di crediti restituiti (0 salvo approvazione) e creditBack.reason spiega la decisione.