Mobile divisões vazias, esvazie divisões mobiladas, renove espaços e edite interiores com prompts ou máscaras — todas as operações sobre o conteúdo da divisão num só lugar.
Os endpoints de home staging virtual cobrem tudo o que muda o conteúdo de uma divisão: adicionar mobiliário, removê-lo, renovar o espaço, edições precisas via prompt e remoção de objetos por máscara. Para limpeza de fotos (enhance, sky, blur), ver Melhoria de imagens.
Mobiliar uma divisão vazia
POST/api/furnish
Adiciona mobiliário realista a uma divisão vazia. A Pedra preserva a arquitetura da divisão (paredes, janelas, portas, pisos) e apenas adiciona mobiliário e decoração.
URL da foto da divisão vazia, ou um data URI base64 (data:image/png;base64,...).
roomTypestringobrigatório
Tipo de espaço a mobiliar. Os oito valores abaixo são os tipos de espaço predefinidos. Também podes passar qualquer outro espaço como string personalizada (ex.: "Kid's room", "Garden", "Home gym").
Values:Living roomDining + Living roomBedroomDining roomTerraceEntranceOfficeBathroom
stylestringobrigatório
Estilo do mobiliário. Passa um dos estilos nomeados abaixo, ou um URL público para uma imagem de referência (ex.: foto do Pinterest ou de produto) — a Pedra reproduz o look da referência.
Quanta liberdade a IA toma com o design. Medium é o valor recomendado por defeito; High usa um modelo mais leve e rápido. Medium custa 2 créditos por imagem, High custa 1 — ver Preços.
Values:MediumHigh
Default:Medium
propertyIdstring
Id opcional da propriedade (de list_properties ou create_property) a que esta foto pertence. Quando definido, o resultado é guardado na galeria dessa propriedade — visível e editável a partir da app — em vez de ser apenas devolvido como URL.
Remove mobiliário e objetos de uma divisão, deixando a arquitetura intacta. Útil quando as fotos do anúncio são tiradas com os pertences do proprietário anterior ainda no local.
URL da foto da divisão mobilada, ou um data URI base64.
propertyIdstring
Id opcional da propriedade (de list_properties ou create_property) a que esta foto pertence. Quando definido, o resultado é guardado na galeria dessa propriedade — visível e editável a partir da app — em vez de ser apenas devolvido como URL.
Mostra o aspeto que uma divisão pode ter após renovação: novos acabamentos, cozinhas atualizadas, casas de banho renovadas. Opcionalmente mantém as janelas no sítio e mobila de novo na mesma chamada.
Estilo da renovação. Passa um dos estilos nomeados abaixo, ou um URL público para uma imagem de referência — a Pedra reproduz acabamentos, paleta e look geral da referência.
Mantém as janelas na posição original. Recomendado para anúncios fiéis.
Default:false
furnishboolean
Adiciona mobiliário à divisão renovada na mesma chamada. Quando true, roomType é obrigatório.
Default:false
roomTypestring
Usado quando furnish é true. Por defeito "Auto" (a Pedra deteta o espaço a partir da imagem). Aceita os mesmos tipos de espaço predefinidos que o endpoint furnish, além de qualquer espaço personalizado que escrevas como string (ex.: "Kid's room", "Garden", "Home gym").
Values:Living roomDining + Living roomBedroomDining roomTerraceEntranceOfficeBathroomAuto
Default:Auto
creativitystring
O quão agressiva é a renovação. Medium é o valor recomendado por defeito; High usa um modelo mais leve e rápido. Medium custa 2 créditos por imagem, High custa 1 — ver Preços.
Values:MediumHigh
Default:Medium
propertyIdstring
Id opcional da propriedade (de list_properties ou create_property) a que esta foto pertence. Quando definido, o resultado é guardado na galeria dessa propriedade — visível e editável a partir da app — em vez de ser apenas devolvido como URL.
Faz edições precisas descritas em linguagem natural: "Add a modern chandelier", "Repaint the walls white", "Remove the rug". Ideal para correções pontuais que não cabem nos outros endpoints.
Parâmetros
apiKeystringobrigatório
A tua chave API.
imageUrlstringobrigatório
URL da foto a editar, ou um data URI base64.
promptstringobrigatório
Instrução de edição em linguagem natural. Sê específico — "add a beige sofa against the back wall" funciona melhor que "add furniture".
propertyIdstring
Id opcional da propriedade (de list_properties ou create_property) a que esta foto pertence. Quando definido, o resultado é guardado na galeria dessa propriedade — visível e editável a partir da app — em vez de ser apenas devolvido como URL.
Pedido de exemplo
curl -X POST https://app.pedra.ai/api/edit_via_prompt \
-H "Content-Type: application/json" \
-d '{
"apiKey": "YOUR_API_KEY",
"imageUrl": "https://example.com/living-room.jpg",
"prompt": "Add a modern chandelier to the ceiling"
}'
Tempo de resposta: ~15 segundos por imagem. Custo: 2 créditos por chamada. output é um objeto único.
Remover objeto
POST/api/remove_object
Remove objetos específicos de uma imagem usando uma máscara. A máscara é uma imagem separada onde pixels brancos marcam o que remover e pretos marcam o que manter. Usa-o quando precisas de controlo cirúrgico vs. edit_via_prompt.
URL da imagem máscara. Áreas brancas são removidas; áreas pretas são mantidas.
propertyIdstring
Id opcional da propriedade (de list_properties ou create_property) a que esta foto pertence. Quando definido, o resultado é guardado na galeria dessa propriedade — visível e editável a partir da app — em vez de ser apenas devolvido como URL.
