Referência

Avaliação de imagens e devolução de créditos

Envia avaliações (polegar para cima/baixo) sobre as imagens geradas e solicita a devolução de créditos em gerações falhadas — o mesmo fluxo do editor da Pedra.

Envia uma avaliação (polegar para cima/baixo) sobre uma imagem gerada — o mesmo voto que podes dar no editor da Pedra. Num polegar para baixo também podes solicitar a devolução de créditos: a Pedra executa uma verificação de qualidade automática e, se a geração falhou, reembolsa os créditos consumidos.

Endpoint

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

Identifica a imagem com a imageUrl devolvida no momento da geração, ou passa o seu imageId diretamente. Votar é grátis — nunca custa 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 do pedido

  • apiKey — a tua chave API. Obrigatório.
  • imageUrl ou imageId — a imagem a avaliar. Usa o URL devolvido pelo endpoint de geração, ou o id diretamente. Um é obrigatório.
  • vote — "up" ou "down". Envia uma string vazia para limpar um voto anterior.
  • comment — nota de texto livre opcional que explica o voto. Ajuda a verificação de devolução e a nossa monitorização de qualidade.
  • creditBack — define como true num voto down para solicitar o reembolso dos créditos que esta imagem consumiu. Ignorado num voto positivo.

Elegibilidade para devolução

Quando creditBack é solicitado, a Pedra executa uma verificação de qualidade automática sobre o resultado. Os créditos só são reembolsados quando todas as seguintes condições se verificam:

  • A geração é de um tipo elegível: esvaziar divisão, remover objeto, editar via prompt, renovação ou mobiliar/home staging.
  • O pedido é feito dentro de 2 horas após a geração da imagem.
  • Não é uma renovação de alta criatividade (são concebidas para alterar a divisão drasticamente, por isso não são elegíveis).

Resposta

Devolve 200. Um voto simples reflete o voto registado; um pedido de devolução também devolve um objeto creditBack com o resultado:

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

Campos da resposta

  • vote — o voto registado (positive, negative ou null se limpo).
  • creditBack.status — approved, rejected ou ineligible. creditBack.creditsRefunded é o número de créditos devolvidos (0 exceto se aprovado) e creditBack.reason explica a decisão.