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.

SDKs & MCP

Preferes um cliente tipado em vez de HTTP direto? Os SDKs oficiais de Python e Node.js envolvem todos os endpoints — pip install pedra ou npm i @pedra-ai/sdk. Ou usa a Pedra diretamente a partir do Claude, ChatGPT e Cursor através do servidor MCP. Precisas de um contrato legível por máquinas? Descarrega a especificação OpenAPI 3.1.

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
POST/api/feedbackAvalia uma imagem e solicita a devolução de créditos

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.

Perguntas frequentes

A Pedra tem API?

Sim. A Pedra oferece uma API REST sobre JSON-over-HTTPS para home staging virtual, melhoria de imagens, remoção de objetos e geração de vídeos de anúncios. Foi feita para plataformas imobiliárias, CRMs e portais. Obtém uma chave de API em app.pedra.ai em Definições → API.

O que a API da Pedra consegue fazer?

Expõe todas as transformações da Pedra de forma programática: mobilar quartos vazios, esvaziar quartos mobilados, renovar espaços, editar fotos com uma instrução de texto, remover objetos, melhorar luz e cor, corrigir a perspetiva, substituir o céu, desfocar conteúdo sensível e gerar vídeos de anúncios.

Existe uma API de home staging virtual?

Sim. POST /api/furnish adiciona mobília a quartos vazios, /api/empty_room remove-a, /api/renovation muda o estilo de um espaço e /api/edit_via_prompt edita uma foto a partir de uma instrução em linguagem natural — tudo numa só API JSON.

Como integro a Pedra?

Cria uma chave de API e depois instala um SDK oficial (pip install pedra ou npm install @pedra-ai/sdk) ou chama os endpoints REST diretamente. Passa a tua chave e o URL de uma imagem a um endpoint; cada chamada espera até o resultado estar pronto e devolve o URL final — sem IDs de tarefa para consultar.

Quanto custa a API da Pedra?

O preço é por geração bem-sucedida com descontos por volume, e só pagas pelos resultados bem-sucedidos. Há uma avaliação gratuita disponível. Consulta a página de preços da API para mais detalhes.

Como funciona a autenticação da API da Pedra?

Passas a tua chave de API no corpo do pedido, no campo apiKey. As chaves são de longa duração, por isso chama a API a partir do teu backend e nunca incluas uma chave em código do lado do cliente.