Referência da API

API Pedra

Acesso programático a home staging virtual, melhoria de imagens e geração de vídeos imobiliários. JSON via HTTPS. Para portais, CRMs e plataformas imobiliárias.

URL base

Todos os pedidos à API são feitos para:

https://app.pedra.ai/api

Início rápido

Cada endpoint aceita um POST JSON com a tua apiKey e um imageUrl. Aqui está uma chamada de home staging virtual que mobila uma divisão vazia:

curl -X POST https://app.pedra.ai/api/furnish \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/empty-room.jpg",
    "roomType": "Living room",
    "style": "Minimalist"
  }'

Respostas bem-sucedidas devolvem HTTP 200 com { "message": "...", "output": ... }. output é um array para /api/enhance, /api/enhance_and_correct_perspective, /api/empty_room, /api/furnish e /api/renovation, e um objeto único para /api/sky_blue, /api/edit_via_prompt, /api/remove_object e /api/blur. Ver Erros e limites para formatos de falha.

Endpoints

Vê cada endpoint em ação
Explora galerias antes/depois de staging, renovação, melhoria, substituição de céu e vídeo.
Ver exemplos →

Home staging virtual →

POST/api/furnishAdiciona mobiliário a uma divisão vazia
POST/api/empty_roomRemove todo o mobiliário de uma divisão
POST/api/renovationRenova uma divisão num novo estilo
POST/api/edit_via_promptEdita uma imagem com um prompt
POST/api/remove_objectRemove objetos específicos via máscara

Melhoria de imagens →

POST/api/enhanceMelhoria automática de luz, cor e nitidez
POST/api/enhance_and_correct_perspectiveMelhora + endireita linhas verticais
POST/api/sky_blueSubstitui um céu cinzento por azul
POST/api/blurDesfoca objetos (rostos, matrículas, logos)

Vídeo →

POST/api/create_videoGera um vídeo de anúncio a partir de fotos

Conta →

POST/api/creditsConsulta o saldo de créditos restante

Autenticação

Todos os pedidos requerem uma apiKey no corpo JSON. Obtém uma chave registando-te em app.pedra.ai e abrindo Definições → API. Ver Autenticação para detalhes.

Formato de pedido e resposta

Cada endpoint aceita JSON via HTTPS através de POST. As imagens podem ser passadas como URL publicamente acessível ou como data URI base64 (data:image/png;base64,...). A Pedra faz timeout aos 20s ao descarregar a imageUrl — para URLs autenticadas ou pré-assinadas (S3, R2, Cloudinary), prefere o formato base64.

Todos os endpoints são síncronos. Os endpoints de imagem respondem em ~10–30 segundos; o endpoint de vídeo bloqueia até 10 minutos — configura o timeout do cliente HTTP em conformidade.

Preços

O uso da API é faturado por pedido, com descontos por volume. Ver Preços.

Suporte

Envia email para felix@pedra.ai para aumentar quotas, obter ajuda com integração ou condições enterprise. Respondemos no prazo de um dia útil.