API para Desenvolvedores — Disponível

A API de Imagens Imobiliárias

Home staging virtual, reforma, melhoria de fotos, day-to-dusk, remoção de objetos, plantas baixas e todas as outras ferramentas da Roomagen: cada uma documentada, atrás de um único endpoint de jobs e uma única chave de API. Jobs assíncronos com webhooks, resultados normalmente em 20–60 segundos e sem marca da Roomagen na saída depois que sua conta compra um pacote.

Obtenha sua chave de API
terminal — roomagen api
$ curl -X POST https://api.roomagen.com/api/v1/jobs \
  -H "X-Api-Key: rmg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "virtual-staging",
    "image_url": "https://example.com/empty-living-room.jpg",
    "options": { "style": "scandinavian", "roomType": "living-room" },
    "webhook_url": "https://yourapp.com/hooks/roomagen"
  }'
 
# → { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }

Resultados reais das ferramentas por trás da API

Este par antes/depois vem da remoção de objetos, a mesma ferramenta que a API executa.

Object removal input
input.jpg
Object removal result
✓ result.jpg · 26s

Exemplo de demonstração: a imagem de entrada foi criada com IA para este site; não é uma foto de cliente.

Explore a API por recurso

Veja todas as ferramentas na documentação da API →

Por que as equipes escolhem a Roomagen

Todas as ferramentas, um endpoint

Staging, reforma, melhoria, day-to-dusk, remoção, áreas externas e plantas baixas passam todos por POST /v1/jobs, e as opções de cada ferramenta estão documentadas com um exemplo. Você troca de ferramenta com um único parâmetro.

Plantas baixas, 2D e 3D

Envie uma planta 2D, uma digitalização ou uma foto de celular de um desenho à mão e receba um render 3D mobiliado ou vazio, uma planta redesenhada e limpa, uma planta colorida ou uma imagem de marketing vista de cima.

Sem marca após comprar um pacote

As 50 imagens gratuitas são geradas com marca d'água da Roomagen: servem para construir e testar. Assim que sua conta compra um pacote, cada novo render volta sem a marca da Roomagen, incluindo as imagens gratuitas que restarem.

Retries seguros

Envie um cabeçalho Idempotency-Key e uma requisição repetida devolve o job original: sem segunda cobrança, sem segundo render.

Jobs com falha são reembolsados

Um job que falha durante a geração é reembolsado automaticamente. Os webhooks são assinados com HMAC, com até cinco tentativas de entrega em cerca de 36 minutos.

Self-service, documentação de verdade

Crie uma chave no portal do desenvolvedor, sem reunião de vendas. Documentação pública com exemplos em cURL, Node.js e Python; receba os resultados por webhook ou por polling.

Projetada para parecer familiar

Envie um job, receba um id de job, receba um webhook quando ele concluir. Uma imagem por job: rode jobs em paralelo, até 60 jobs novos por minuto por chave.

POST /api/v1/jobs
$ curl -X POST https://api.roomagen.com/api/v1/jobs \
  -H "X-Api-Key: rmg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "virtual-staging",
    "image_url": "https://example.com/empty-living-room.jpg",
    "options": { "style": "scandinavian", "roomType": "living-room" },
    "webhook_url": "https://yourapp.com/hooks/roomagen"
  }'
 
# → { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }

Preço pré-pago simples

Os créditos são denominados em imagens. São pré-pagos e nunca expiram. Gerações com falha nunca são cobradas.

Sem cartão

Developer

$0

50 imagens com marca d'água, uma vez

só a primeira chave

Obtenha sua chave de API

Pilot

$125

500 imagens

$0.25 / imagem

Comprar no portal

Pré-pago · nunca expira

Mais popular

Growth

$550

2,500 imagens

$0.22 / imagem

Comprar no portal

Pré-pago · nunca expira

Scale

$2,000

10,000 imagens

$0.20 / imagem

Comprar no portal

Pré-pago · nunca expira

Descontos por uso comprometido

Volume

Personalizado

50,000+ imagens

Fale conosco

Fale conosco

Preços por imagem gerada; um render 4K conta como duas. Depois que a conta compra um pacote, os renders não levam a marca da Roomagen. Aviso de 30 dias antes de qualquer mudança de preço.

No ar em minutos

Crie uma chave, envie um POST e receba a imagem pronta. Sem call de vendas, sem fila de onboarding.

roomagen-api — quickstartv1
  1. 1

    Crie sua chave

    Entre no portal do desenvolvedor e gere uma chave. Ela é exibida uma única vez, então guarde em um lugar seguro.

    developers.roomagen.com/portal ↗
  2. 2

    Rode seu primeiro job

    Um POST com o slug da ferramenta e sua imagem. A resposta volta na hora com um id de job — a geração roda em segundo plano.

    $ curl -X POST https://api.roomagen.com/api/v1/jobs \
      -H "X-Api-Key: rmg_live_..." \
      -H "Content-Type: application/json" \
      -d '{ "tool": "virtual-staging",
            "image_url": "https://example.com/photo.jpg",
            "options": { "style": "scandinavian", "roomType": "living-room" } }'
     
    # → 201 { "job_id": "3f1c9d4e-…", "status": "processing", "images_charged": 1, "warnings": [] }
  3. 3

    Receba o resultado

    Defina um webhook_url e chamamos você quando a imagem ficar pronta, ou consulte o endpoint do job. Normalmente 20–60 segundos.

    POST → your webhook_urlGET /api/v1/jobs/{id}
Obtenha sua chave de APILeia a documentação

✓ 50 imagens grátis na sua primeira chave, com marca d'água até você comprar um pacote · sem cartão

FAQ da API

Todas as ferramentas do aplicativo web da Roomagen: home staging virtual, esvaziar e organizar ambientes, reforma de interiores e exteriores, cozinhas e banheiros, edição de fotos, day-to-dusk e as ferramentas de plantas baixas. Você escolhe a ferramenta por job com um único parâmetro. Cada ferramenta está documentada com suas opções e um exemplo em developers.roomagen.com/docs/tools, e GET /v1/tools lista todos os slugs que sua chave pode chamar.

Os jobs normalmente ficam prontos em 20–60 segundos; o home staging virtual e a reforma virtual ficam no limite superior. Você recebe um webhook quando um job termina, ou pode consultar o job a cada 2–5 segundos.

Sim, depois que sua conta compra um pacote: os renders não levam marca nem marca d'água da Roomagen, enquanto os renders feitos antes com as 50 imagens gratuitas levam marca d'água, para construir e testar. A API não adiciona seu logotipo nem um rótulo de divulgação; adicione o rótulo que suas regras de anúncio exigem no seu próprio fluxo.

Um job que falha durante a geração é reembolsado automaticamente, e o campo error informa o motivo. Um job concluído é cobrado uma vez; rodá-lo de novo é um novo job.

Pacotes pré-pagos denominados em imagens: 500 imagens a $0.25, 2.500 a $0.22, 10.000 a $0.20, e preço negociado por uso comprometido acima de 50.000. Um render 4K conta como duas imagens. Os pacotes nunca expiram e se acumulam.

Não. Um job devolve só a imagem editada: sem rótulo de divulgação, sem registro do que mudou e sem cópia da original. Guarde sua foto de origem e identifique as imagens editadas quando o seu MLS ou a lei local exigir; a AB 723 da Califórnia, por exemplo, exige uma declaração de divulgação e um link para a original sem alterações.

Embutir a saída da Roomagen no seu próprio produto ou plataforma é exatamente para isso que a API existe. Fazer proxy da API bruta como sua própria API exige um acordo de revenda — fale conosco.

Sim — criar sua primeira chave de API adiciona 50 imagens gratuitas à conta, uma única vez e sem cartão. Elas são geradas com marca d'água da Roomagen até a conta comprar um pacote e cobrem todo o ciclo de um job, webhooks incluídos, para você construir e testar antes de comprar.

Construindo algo com imagens de imóveis?

Crie uma chave no portal do desenvolvedor e rode seu primeiro job hoje. 50 imagens grátis para construir e testar (com marca d'água até você comprar um pacote), sem cartão.

Obtenha sua chave de API