Valoración de imágenes y devolución de créditos

Envía valoraciones (pulgar arriba/abajo) sobre las imágenes generadas y solicita la devolución de créditos en generaciones fallidas — el mismo flujo que el editor de Pedra.

Envía una valoración (pulgar arriba/abajo) sobre una imagen generada — el mismo voto que puedes emitir en el editor de Pedra. En un pulgar abajo también puedes solicitar la devolución de créditos: Pedra ejecuta una comprobación de calidad automática y, si la generación falló, reembolsa los créditos consumidos.

Endpoint

Identifica la imagen con la imageUrl devuelta al generarla, o pasa su imageId directamente. Votar es gratis — nunca cuesta créditos.

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

Campos de la petición

• apiKey — tu clave API. Obligatorio.
• imageUrl o imageId — la imagen a valorar. Usa la URL devuelta por el endpoint de generación, o el id directamente. Uno es obligatorio.
• vote — "up" o "down". Envía una cadena vacía para borrar un voto anterior.
• comment — nota de texto libre opcional que explica el voto. Ayuda a la comprobación de devolución y a nuestro control de calidad.
• creditBack — ponlo en true en un voto down para solicitar el reembolso de los créditos que consumió esta imagen. Se ignora en un voto positivo.

Elegibilidad para la devolución

Cuando se solicita creditBack, Pedra ejecuta una comprobación de calidad automática sobre el resultado. Los créditos se reembolsan solo cuando se cumple todo lo siguiente:

• La generación es de un tipo elegible: vaciar habitación, eliminar objeto, editar con prompt, renovación o amueblar/home staging.
• La solicitud se realiza dentro de las 2 horas siguientes a la generación de la imagen.
• No es una renovación de alta creatividad (están diseñadas para alterar la habitación drásticamente, por lo que no son elegibles).

Respuesta

Devuelve 200. Un voto simple refleja el voto registrado; una solicitud de devolución también devuelve un objeto creditBack con el resultado:

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

Campos de la respuesta

• vote — el voto registrado (positive, negative o null si se borró).
• creditBack.status — approved, rejected o ineligible. creditBack.creditsRefunded es el número de créditos devueltos (0 salvo que se apruebe) y creditBack.reason explica la decisión.