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.

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.