Évaluation d'images et remboursement de crédits

Envoyez une évaluation (pouce haut/bas) sur les images générées et demandez un remboursement de crédits sur les générations ratées — le même flux que l'éditeur Pedra.

Envoyez une évaluation (pouce haut/bas) sur une image générée — le même vote que dans l'éditeur Pedra. Sur un pouce bas, vous pouvez aussi demander un remboursement de crédits : Pedra exécute un contrôle qualité automatique et, si la génération a échoué, rembourse les crédits consommés.

Endpoint

Identifiez l'image avec l'imageUrl renvoyée lors de la génération, ou passez son imageId directement. Voter est gratuit — cela ne coûte jamais de crédits.

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

Champs de la requête

• apiKey — votre clé API. Obligatoire.
• imageUrl ou imageId — l'image à évaluer. Utilisez l'URL renvoyée par l'endpoint de génération, ou l'id seul. L'un des deux est requis.
• vote — "up" ou "down". Envoyez une chaîne vide pour annuler un vote précédent.
• comment — note en texte libre optionnelle expliquant le vote. Aide le contrôle de remboursement et notre suivi qualité.
• creditBack — mettez true sur un vote down pour demander le remboursement des crédits consommés par cette image. Ignoré sur un vote positif.

Éligibilité au remboursement

Lorsque creditBack est demandé, Pedra exécute un contrôle qualité automatique sur le résultat. Les crédits ne sont remboursés que si toutes les conditions suivantes sont réunies :

• La génération est d'un type éligible : vider une pièce, supprimer un objet, éditer par prompt, rénovation ou meubler/home staging.
• La demande est faite dans les 2 heures suivant la génération de l'image.
• Ce n'est pas une rénovation à haute créativité (elles sont conçues pour transformer la pièce radicalement et ne sont donc pas éligibles).

Réponse

Renvoie 200. Un simple vote renvoie le vote enregistré ; une demande de remboursement renvoie aussi un objet creditBack avec le résultat :

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

Champs de la réponse

• vote — le vote enregistré (positive, negative ou null s'il a été annulé).
• creditBack.status — approved, rejected ou ineligible. creditBack.creditsRefunded est le nombre de crédits rendus (0 sauf si approuvé) et creditBack.reason explique la décision.