Referenz

Bildbewertung & Credit-Rückerstattung

Senden Sie Daumen-hoch/runter-Bewertungen zu generierten Bildern und fordern Sie eine Credit-Rückerstattung für fehlgeschlagene Generierungen an — derselbe Ablauf wie im Pedra-Editor.

Senden Sie eine Daumen-hoch/runter-Bewertung zu einem generierten Bild — dieselbe Bewertung wie im Pedra-Editor. Bei einem Daumen-runter können Sie auch eine Credit-Rückerstattung anfordern: Pedra führt eine automatische Qualitätsprüfung durch und erstattet bei einer fehlgeschlagenen Generierung die verbrauchten Credits.

Endpunkt

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

Identifizieren Sie das Bild mit der bei der Generierung zurückgegebenen imageUrl oder übergeben Sie direkt die imageId. Das Bewerten ist kostenlos — es kostet nie Credits.

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
  }'

Anfragefelder

  • apiKey — Ihr API-Schlüssel. Erforderlich.
  • imageUrl oder imageId — das zu bewertende Bild. Verwenden Sie die vom Generierungs-Endpunkt zurückgegebene URL oder die reine id. Eines ist erforderlich.
  • vote — "up" oder "down". Senden Sie einen leeren String, um eine frühere Bewertung zu löschen.
  • comment — optionale Freitext-Notiz, die die Bewertung erklärt. Hilft der Rückerstattungsprüfung und unserer Qualitätsüberwachung.
  • creditBack — bei einem down-Vote auf true setzen, um eine Erstattung der von diesem Bild verbrauchten Credits anzufordern. Bei einem Daumen-hoch wird es ignoriert.

Anspruch auf Rückerstattung

Wenn creditBack angefordert wird, führt Pedra eine automatische Qualitätsprüfung des Ergebnisses durch. Credits werden nur erstattet, wenn alle folgenden Bedingungen erfüllt sind:

  • Die Generierung ist ein berechtigter Typ: Raum leeren, Objekt entfernen, per Prompt bearbeiten, Renovierung oder Möblieren/Home Staging.
  • Die Anfrage erfolgt innerhalb von 2 Stunden nach der Generierung des Bildes.
  • Es handelt sich nicht um eine Renovierung mit hoher Kreativität (diese sollen den Raum drastisch verändern und sind daher nicht berechtigt).

Antwort

Gibt 200 zurück. Ein einfacher Vote spiegelt die gespeicherte Bewertung wider; eine Rückerstattungsanfrage gibt zusätzlich ein creditBack-Objekt mit dem Ergebnis zurück:

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

Antwortfelder

  • vote — die gespeicherte Bewertung (positive, negative oder null, wenn gelöscht).
  • creditBack.status — approved, rejected oder ineligible. creditBack.creditsRefunded ist die Anzahl der zurückgegebenen Credits (0, außer bei Genehmigung) und creditBack.reason erklärt die Entscheidung.